Info Receiving PA
Receiving of Supplier/Expense Invoices
When is Receiving active ?
When your company is created and registered correctly, you will be able to receive. Info : https://docs.billit.be/docs/create-account-and-french-integration .
Elements of importance:
| What | Description |
|---|---|
| Identifiers for receiving | See active identifers in My Company |
| Supported document types | Billit will automatically activate several document types related to Invoice, Credit Note, IMR, MLR. |
When is Receiving active
Senders might send information in different formats. You can process the data in a more uniform way.
How you can get/process this information:
| Method | Description |
|---|---|
| Via API | Uniform data structure from Billit, regardless of the file format of the sender + ability to Get the PDF and XML file |
| Via Email | Activate Billmail for receiving of a PDF per email. |
| Via sFTP | Receive PDF (alternative XML with embedded PDF) |
Receiving Supplier Invoices via API
The method is similar to receiving for other countries and methods. It is described on the following pages:
| Action | Extra Info | |
|---|---|---|
| Get List of Invoices | List | https://docs.billit.be/docs/get-list-of-incoming-invoices |
| Get 1 Invoice | Structured data | https://docs.billit.be/docs/get-information-about-one-invoicecreditnote |
| Get Files |
| https://docs.billit.be/docs/get-files |
| Status of the export | How to know what you did export already | https://docs.billit.be/docs/status-of-export |
Example of API Content of Received Invoice via PA network
Example:
{
"OrderID": 2619946,
"CompanyID": 1079382,
"OrderPDF": { //PDF (Origin : Supplier, if not generated by Billit)
"FileID": "678a90e1-49aa-4cca-a3cd-af48a7133ff1",
"FileName": "152905-110413-9ac9d55e-9f70-4c63-8307-8a817aab3dfe.sbd.xml_1.pdf"
},
"Attachments": [
{
"FileID": "c4194b29-d246-4d11-91b0-17f71da3013e", //XML of the supplier
"FileName": "152905-110413-9ac9d55e-9f70-4c63-8307-8a817aab3dfe.sbd.xml"
}
],
"OrderNumber": "227010068",
"Customer": { //This is the receiver of the invoice
"PartyID": 1079382,
"Name": "FR demo receive",
"Addresses": [
{
"AddressType": "InvoiceAddress",
"Street": "place demo receive",
"StreetNumber": "987",
"Zipcode": "75001",
"City": "PARIS",
"CountryCode": "FR"
},
{
"AddressType": "DeliveryAddress",
"Street": "place demo receive",
"StreetNumber": "987",
"Zipcode": "75001",
"City": "PARIS",
"CountryCode": "FR"
}
],
"Street": "place demo receive",
"StreetNumber": "987",
"Zipcode": "75001",
"City": "PARIS",
"CountryCode": "FR",
"IBAN": "BE43957767941201",
"BIC": "CTBKBEBX",
"Phone": "+32475366999",
"Email": "[email protected]",
"Contact": "",
"VATNumber": "FR37127362999",
"LastModified": "2026-05-06T14:27:50.357",
"Created": "2026-04-24T16:00:26.917",
"PartyType": "Customer",
"VATLiable": true,
"Language": "EN",
"VentilationCode": "4",
"CustomFields": [],
"BankAccounts": [
{
"IBAN": "BE43957767941201",
"BIC": "CTBKBEBX",
"Currency": "EUR",
"Verified": false,
"Saldo": 0.00
}
],
"DefaultPaid": false,
"DisplayName": "FR demo receive",
"VATDeductable": true,
"Identifiers": [
{
"IdentifierType": "SIRENE",
"Identifier": "127362116",
"SchemeID": "0002",
"Preferred": false,
"IdentifierAddress": "0002:127362116"
},
{
"IdentifierType": "CTC",
"Identifier": "127362116_DEMO",
"SchemeID": "0225",
"Preferred": false,
"IdentifierAddress": "0225:127362116_DEMO"
},
{
"IdentifierType": "VAT",
"Identifier": "FR37127362116",
"SchemeID": "9957",
"Preferred": false,
"IdentifierAddress": "9957:FR37127362116"
}
],
"SmallEnterprise": false,
"DefaultCurrencyTC": "EUR",
"SendUBL": true,
"SendPDF": true
},
{
"Supplier": { // This is the sender of the invoice
"PartyID": 1081513,
"Nr": "1",
"Name": "FR demo send",
"Addresses": [
{
"AddressType": "InvoiceAddress",
"CountryCode": "FR"
},
{
"AddressType": "DeliveryAddress",
"CountryCode": "FR"
}
],
"CostCategoryCode": 604000,
"CountryCode": "FR",
"IBAN": "BE43957767941201",
"BIC": "CTBKBEBX",
"Contact": "",
"VATNumber": "FR99227010068", //VAT number
"LastModified": "2026-05-07T11:00:06.553",
"Created": "2026-05-05T15:32:35.53",
"PartyType": "Supplier",
"VATLiable": true,
"Language": "EN",
"VentilationCode": "1",
"CustomFields": [],
"BankAccounts": [],
"Users": [],
"DefaultPaid": false,
"DisplayName": "FR demo send",
"DefaultExpiryOffset": 30,
"GLDefaultExpiryOffset": 30,
"VATDeductable": true,
"DefaultReductionPercentage": 0.00,
"Identifiers": [ //additional identifiers
{
"IdentifierType": "SIRENE", //identifier SIREN
"Identifier": "227010068",
"SchemeID": "0002",
"Preferred": false,
"IdentifierAddress": "0002:227010068"
},
{
"IdentifierType": "CTC", //identifier CTC
"Identifier": "227010068_DEMO",
"SchemeID": "0225",
"Preferred": false,
"IdentifierAddress": "0225:227010068_DEMO"
}
],
"SmallEnterprise": false,
"DefaultCurrencyTC": "EUR",
"IsHighRisk": false,
"SendUBL": true,
"SendPDF": true
},
"CounterParty": { // Not needed, removed from this example },
"OrderDate": "2026-05-06T00:00:00",
"ExpiryDate": "2026-06-04T00:00:00",
"OrderType": "Invoice",
"LastModified": "2026-05-06T15:35:12.49",
"Created": "2026-05-06T15:35:11.49",
"OrderDirection": "Cost",
"OrderLines": [ //start of the lines
{
"OrderLineID": 20221978,
"Quantity": 1.00000,
"UnitPriceExcl": 400.00000,
"Reference": "4563254",
"Description": "just a single line",
"TotalExcl": 400.00,
"TotalVAT": 80.00,
"VATPercentage": 20.00,
"VentilationCode": "1",
"CustomFields": {
"Name": "just a single line",
"PeppolLineID": "1",
"PeppolUnitCode": "NAR"
},
"InclLeading": false,
"TotalIncl": 480.00,
"DescriptionExtended": "some extended description"
}
],
"OrderTitle": "Simple",
"PaymentDiscountPercentage": 0.00,
"PaymentDiscountAmount": 0.00,
"VatGroups": [
{
"VentilationCode": "1",
"VATPercentage": 20.00,
"TotalExcl": 400.00,
"TotalVAT": 80.00,
"TotalIncl": 480.00,
"Mtvh": 400.00,
"FinancialReductionAmount": 0.00
}
],
"VentilationCode": "1",
"TotalExcl": 400.00,
"TotalIncl": 480.00,
"TotalVAT": 80.00,
"Reference": "PurchaseOrderReference 546458",
"Tags": [],
"PaymentReference": "365878545",
"Paid": false,
"ExternalProvider": "Peppol",
"ExternalProviderReferences": [],
"Comments": "additional info",
"Currency": "EUR",
"IsSent": false,
"Invoiced": false,
"CustomFields": { //additional fields on header level
"Invoice.PaymentMeans.PaymentMeansCode.Text": "42"
},
"RemindersSent": 0,
"ToPay": 480.00,
"PaymentMethod": "Wired",
"DeliveryDate": "2026-05-06T00:00:00",
"CurrentDocumentDeliveryDetails": {
"IsDocumentDelivered": false
},
"Messages": [],
"IBAN": "BE43957767941201",
"BIC": "CTBKBEBX"
}When Receiving is Based on Factur-X
Example:
The API content contains a reference to 2 files:
- The OrderPDF : This is the Factur-X PDF where the attached CII XML file has been removed
- The Attachment : the CII XML file.
If the supplier did send additional attachment files, these attachments will be in the CII file as attachment.
Updated 14 days ago
Did this page help you?