Receiving an Invoice

To receive a document through the Peppol Network, you need to have a LegalEntity registered and enabled in the Peppol Network. Read more about how to onboard a new company into the Peppol Network.

To receive documents, you can either:

  1. Set up a webhook to get notified when a document is delivered to your LegalEntity. Read here for more information.
  2. Poll the API to check for new incoming documents. The API endpoint to use is GET /be/invoices . Be sure to use the query parameter direction=incoming to filter only incoming documents.

The downloaded flag

Every document has a downloaded flag which is set to false by default.

When you receive a document successfully via webhook (i.e., your endpoint reply with a 2** status), the document is marked automatically as downloaded=true.

In case you poll the API to check for new incoming documents, you can set it to true by using the endpoint POST /be/invoices/downloaded.

You can filter the invoices by the downloaded flag using the query parameter downloaded=true|false when calling GET /be/invoices.