Info Receiving PA
When is Receiving active ?
When your company is created and registered correctly, you will be able to receive.
This will mainly be the case for the production environment.
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, regardless of the file format of the sender + a PDF 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 | PDF file and original XML of the seller (format depends on supplier) | 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
}
],
"Users": [],
"DefaultPaid": false,
"DisplayName": "FR demo receive",
"FinancialReductionDaysDefault": 8,
"DefaultExpiryOffset": 30,
"GLDefaultExpiryOffset": 30,
"VATDeductable": true,
"DefaultReductionPercentage": 0.00,
"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": {
"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",
"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": [
{
"IdentifierType": "SIRENE",
"Identifier": "227010068",
"SchemeID": "0002",
"Preferred": false,
"IdentifierAddress": "0002:227010068"
},
{
"IdentifierType": "CTC",
"Identifier": "227010068_DEMO",
"SchemeID": "0225",
"Preferred": false,
"IdentifierAddress": "0225:227010068_DEMO"
}
],
"SmallEnterprise": false,
"DefaultCurrencyTC": "EUR",
"IsHighRisk": false,
"SendUBL": true,
"SendPDF": true
},
"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": [
{
"OrderLineID": 20221978,
"Quantity": 1.00000,
"UnitPriceExcl": 400.00000,
"Reference": "",
"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": {
"Invoice.PaymentMeans.PaymentMeansCode.Text": "42"
},
"RemindersSent": 0,
"ToPay": 480.00,
"OrderStatus": "ToPay",
"Overdue": false,
"DaysOverdue": -28,
"FXRateToForeign": 1.00000,
"PaymentMethod": "Wired",
"DeliveryDate": "2026-05-06T00:00:00",
"PaymentLinks": [],
"AccountantVerificationNeeded": false,
"CurrentDocumentDeliveryDetails": {
"IsDocumentDelivered": false
},
"Messages": [],
"IBAN": "BE43957767941201",
"BIC": "CTBKBEBX"
}Updated 15 days ago