Receiving an Invoice

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

Once claimed, the LegalEntity can receive EHF Billing 3.0 invoices and credit notes.

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 endpoints to use are GET /invoices and GET /credit-notes. Be sure to use the query parameter direction=incoming to filter only incoming documents.

The original document received can be downloaded with GET /invoices/{uuid}/source (or GET /credit-notes/{uuid}/source).

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 /invoices/downloaded (or POST /credit-notes/downloaded):

{
  "downloaded": true,
  "uuids": [
    "9a163ebe-fb45-4b10-aac3-d5bad66acf40"
  ]
}

You can filter the documents by the downloaded flag using the query parameter downloaded=true|false when calling GET /invoices or GET /credit-notes.