API Documentation

Get Supplier Invoices and Responses from Sales Invoices

Via the GET Peppol inbox (endpoint on sandbox https://api.sandbox.billit.be/v1/peppol/inbox ), the incoming files can be retrieved. It is a list of files, Odata filtering on that list is not supported.

Type of files that can occur in the list:

  • Incoming invoices and incoming credit notes (supplier related),
  • Feedback from receivers on the delivered sales invoices, this is income related. The feedback can consist of:
    • (Invoice Responses = IMR
    • Message Level Responses or MLR
TypeValue (example)Sample value
InboxItemIDthe ID to perform a Get as a next step to get the file69791
SenderPeppolIDidentifier and value of the Sender"0208:0759529999"
PeppolDocumentTypeThis indicates that it is an Invoice, a credit note, and IMR and MLR"urn:oasis:names:specification:ubl:schema: xsd:Invoice-2:: Invoice##urn:cen.eu:en16931:2017compliant#urn: fdc:peppol.eu:2017:poacc:billing:3.0::2.1"
ReceiverPeppolIDidentifier type and value of the Receiver"9925:BE0437295999"
ReceiverCompanyIDvalue for the receiver company"BE0437295999"
CreationDateDate and time when it was received at Billit"2025-04-07T13:30:32.1327398"
PeppolFileIDwith this fileID the file can be obtained with a separate call"8758f630-1fbe-478c-b872-77f5652e2999"

Below an Example of a result with 1 incoming supplier invoice, 1 incoming supplier credit note and 1 incoming IMR - Invoice Response (feedback from receiver of sales invoice):

{
    "InboxItems": [
        {
            "InboxItemID": 69791,
            "SenderPeppolID": "0208:0759529202",
            "PeppolDocumentType": "urn:oasis:names:specification:ubl:schema:xsd:Invoice-2::Invoice##urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0::2.1",
            "ReceiverPeppolID": "9925:BE0437295999",
            "ReceiverCompanyID": "BE0437295999",
            "CreationDate": "2025-04-07T13:30:32.1327398",
            "PeppolFileID": "b155ec2e-a74c-4972-928b-f87d6056f999"
        },
        {
            "InboxItemID": 69848,
            "SenderPeppolID": "0208:0759529202",
            "PeppolDocumentType": "urn:oasis:names:specification:ubl:schema:xsd:CreditNote-2::CreditNote##urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0::2.1",
            "ReceiverPeppolID": "9925:BE0437295999",
            "ReceiverCompanyID": "BE0437295999",
            "CreationDate": "2025-04-08T22:30:39.1691603",
            "PeppolFileID": "b67e0285-39d9-4420-b99b-e2170b9dc999"
        },
        {
            "InboxItemID": 69854,
            "SenderPeppolID": "9925:BE0759529999",
            "PeppolDocumentType": "IMR",
            "ReceiverPeppolID": "0208:0437295999",
            "ReceiverCompanyID": "BE0437295999",
            "CreationDate": "2025-04-08T22:31:39.544541",
            "PeppolFileID": "8758f630-1fbe-478c-b872-77f5652e2999"
        },
    ]
}