Info Receiving PA
When is Receiving active
When your company is created and registered correctly, you will be able to receive. See separate documention page for more information.
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:
| 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 (possibly XML with PDF) |
Receiving via API
This method is described on the follow 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 (Supplier or 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 about 17 hours ago