API Documentation

Preparation

Preparation of E-invoice Receiving via Peppol using the API v1/Order

Check before you start

(identical as for Sales Invoices)

  • A Billit sandbox Account. Any license can be taken, no costs will be charged for Sandbox use.
  • The generated API key (found under your profile in the Billit application)
  • The base URL used for all API calls. For the test environment, this is "https://api.sandbox.billit.be"
  • Installed Postman or a similar tool for making API request

Peppol registration

Make Sure that Registration for Invoice Receiving on Open/Peppol is Active:

  • The Open/Peppol receiving must be active. When using the v1/Order API, the activation is done via the Billit User Interface. Registration is done per Company, and per environment. When you register a company for Peppol receiving on the Sandbox environment, you can only receive invoices via the Open/Peppol test environment, so mixing with production is not possible.
  • Simplest way to check activation status: via My Company, Tab E-Invoicing. Below example where Peppol registration is not yet Active:

  • Click on register. Below example where Peppol registration is Active:


Activate Automatic Receiving

Processing of UBL invoices is set to Automatic

  • When Open/Peppol invoices are received, by default they are stopped manually in Fast Input.
    • This is only needed when manual reviews are preferred at the level of the Billit Platform.
      • In addition, approval workflows on the Billit level are possible (more info : Approval).
    • If not, this manual stop can be disabled.
  • When full automated transfer is desired, In settings the automated processing can be activated. Screenshot:

How can I receive Invoices via test environment on Peppol ?

  • Option 1: Send and Receive : Register 2 companies on the Sandbox (if possible) and Send from Company 1 to Company 2. You can then organise the test scenario's yourself.
  • Option 2: Request your suppliers to send test invoices. Remark: many suppliers are only willing to send in the production environment, so this may be more difficult.