Receive 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 and Peppol BIS Billing 3.0 invoices and credit notes.
To receive an invoice, you can either:
- Set up a webhook to get notified when a document is delivered to your LegalEntity. Read here for more information.
- Poll the API to check for new incoming documents. The API endpoint to use is
GET /invoices. Be sure to use the query parameterdirection=incomingto filter only incoming documents.
The original document received can be downloaded with GET /invoices/{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:
{
"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.