Step 5: Getting Received Invoices

Choose Your Method

Methods available:

• Full API:
  • Extract data via API and process the Billit tags in Json body
  • Files:
    • Extract PDF for displaying in your software
    • XML file coming from Peppol : no obligation to extract, as it remains on Billit platform. But if desired can be stored on your environement to have an additional trace.
• API + UBL:
  • Files :
    • Extract PDF for displaying in your software
    • Estract XML file coming from Peppol and parse the content of the XML/UBL file.

Retrieving Invoice Information: The GET Endpoint

To access comprehensive details about invoices, you can use our GET endpoint. The retrieved information is structured in a similar order object as used during invoice creation.

GET Received invoices Endpoint Details

If you only want to get a list of purchase invoices (and not all invoices), you can apply odata filtering. Below an example where only supplier invoices are displayed.

• HTTP Method: GET
• Endpoint: /v1/einvoices/registrations/{registrationID}/orders?$filter=OrderType+eq+'Invoice/CreditNote'+and+OrderDirection+eq+'Cost'&$orderby=Created+asc

Accessing 1 Invoice in JSON Format

For enhanced convenience, when you activate specific integrations or networks, you have the option to receive invoices via our accesspoint. These invoices are typically in UBL (XML) or other formats. However, Billit processes and offers them through our API in a JSON format. This eliminates the need for additional mapping of each document.

GET Endpoint Details

• HTTP Method: GET
• Endpoint: /v1/einvoices/registrations/{registrationID}/orders/

The registration ID is used to select the correct invoice.