Messages and Status
PA : What feedback does receiver give to the sender ?
Concept
Messages can be returned to the sender
- from PPF
- from receiver or PA of the receiver. Some messages are mandatory, many are optional.
MyBillit Message Center
Billit will display all the messages in the messages section. Example:
Extra info about the messages:
- Invoice has been sent. Click on link when to download the XML file sent via the network. Sending will happen +/- 1 hour after the Exchange with French Tax Authority.
- Endpoint of the customer.
- Peppol proof of delivery file.
- Communication with French tax authority.
- Feedback message(s) from the customer.
Get Feedback via API of Push via Webhook
See general API documention : https://docs.billit.be/docs/retrieve-invoice-information
Remark : support for webhooks is planned.
Below an example of Json body:
{
"OrderID": 2619898,
"CompanyID": 1079374,
"OrderPDF": {
"FileID": "f23a5e6a-1319-4faf-8b28-7a9f925832ab",
"FileName": "Invoice_227010068_Simple2_FRdemoreceive.pdf"
},
"Attachments": [
{
"FileID": "13c734eb-20f1-4d96-be0f-76af26e5eb14",
"FileName": "227010068_Simple2__6_05_2026 14_53_17.json"
}
],
"OrderNumber": "227010068_Simple2",
"Customer": {
"PartyID": 1079630,
"Nr": "0001001523",
"Name": "FR demo receive",
"Addresses": [
{
"AddressType": "InvoiceAddress",
"Name": "FR demo receive",
"Street": "place demo receive 987",
"Zipcode": "75001",
"City": "PARIS",
"CountryCode": "FR"
},
{
"AddressType": "DeliveryAddress",
"Name": "FR demo receive",
"Street": "place demo receive 987",
"Zipcode": "75001",
"City": "PARIS",
"CountryCode": "FR"
}
],
"Street": "place demo receive 987",
"Zipcode": "75001",
"City": "PARIS",
"CountryCode": "FR",
"Mobile": "+32475366999",
"Email": "[email protected]",
"Contact": "",
"ContactLastName": "",
"VATNumber": "FR37127369999",
"LastModified": "2026-05-07T13:55:22.017",
"Created": "2026-04-27T09:08:52.673",
"PartyType": "Customer",
"VATLiable": true,
"Language": "EN",
"VentilationCode": "4",
"CustomFields": [],
"BankAccounts": [],
"Users": [],
"DefaultPaid": false,
"DisplayName": "FR demo receive",
"DefaultExpiryOffset": 30,
"GLDefaultExpiryOffset": 30,
"VATDeductable": true,
"DefaultReductionPercentage": 0.00,
"Identifiers": [
{
"IdentifierType": "CTC",
"Identifier": "127362116_DEMO",
"SchemeID": "0225",
"Preferred": false,
"IdentifierAddress": "0225:127362116_DEMO"
},
{
"IdentifierType": "SIRENE",
"Identifier": "127362116",
"SchemeID": "0002",
"Preferred": false,
"IdentifierAddress": "0002:127362116"
}
],
"SmallEnterprise": false,
"DefaultCurrencyTC": "EUR",
"SendUBL": true,
"SendPDF": true
},
"Supplier": {
"PartyID": 1079374,
"Name": "FR demo send",
"Addresses": [
{
"AddressType": "InvoiceAddress",
"Street": "place demo",
"StreetNumber": "123",
"Zipcode": "75001",
"City": "PARIS",
"CountryCode": "FR"
},
{
"AddressType": "DeliveryAddress",
"Street": "place demo",
"StreetNumber": "123",
"Zipcode": "75001",
"City": "PARIS",
"CountryCode": "FR"
}
],
"Street": "place demo",
"StreetNumber": "123",
"Zipcode": "75001",
"City": "PARIS",
"CountryCode": "FR",
"IBAN": "BE43957767941201",
"BIC": "CTBKBEBX",
"Phone": "+32475366519",
"Email": "[email protected]",
"Contact": "",
"VATNumber": "FR99227010068",
"LastModified": "2026-05-05T13:10:14.01",
"Created": "2026-04-24T15:35:56.34",
"PartyType": "Supplier",
"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 send",
"FinancialReductionDaysDefault": 8,
"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",
"SendUBL": true,
"SendPDF": true
},
"OrderDate": "2026-05-06T00:00:00",
"ExpiryDate": "2026-06-04T00:00:00",
"OrderType": "Invoice",
"LastModified": "2026-05-06T17:11:58.147",
"Created": "2026-05-06T14:53:17.537",
"OrderDirection": "Income",
"OrderLines": [
{
"OrderLineID": 20221818,
"Quantity": 1.00000,
"UnitPriceExcl": 400.00000,
"Description": "just a single line",
"TotalExcl": 400.00,
"TotalVAT": 80.00,
"VATPercentage": 20.00,
"VentilationCode": "4",
"Unit": "PCE",
"CustomFields": {},
"InclLeading": false,
"TotalIncl": 480.00,
"DescriptionExtended": "some extended description"
}
],
"OrderTitle": "Simple",
"PaymentDiscountPercentage": 0.00,
"PaymentDiscountAmount": 0.00,
"VatGroups": [
{
"VentilationCode": "4",
"VATPercentage": 20.00,
"TotalExcl": 400.00,
"TotalVAT": 80.00,
"TotalIncl": 480.00,
"Mtvh": 400.00,
"FinancialReductionAmount": 0.00
}
],
"VentilationCode": "4",
"TotalExcl": 400.00,
"TotalIncl": 480.00,
"TotalVAT": 80.00,
"Reference": "PurchaseOrderReference 546458",
"Tags": [],
"PaymentReference": "365878545",
"Paid": false,
"ExternalProvider": "APIFeed",
"ExternalProviderReferences": [ //Contains the feedbacks from the French Tax Authority
{
"ExternalProvider": "FrenchTaxAuthority",
"Category": "ack",
"Value": "227010068_227010068_Simple2",
"EntityID": 0
},
{
"ExternalProvider": "FrenchTaxAuthority",
"Category": "FFE0111A",
"Value": "FFE0111A_PPF176_PPF1760000000000000000243",
"EntityID": 0
},
{
"ExternalProvider": "FrenchTaxAuthority",
"Category": "FFE0614A",
"Value": "FFE0614A_PPF176_PPF1760000000000000000240",
"EntityID": 0
}
],
"Comments": "additional info",
"Currency": "EUR",
"IsSent": true,
"Invoiced": false,
"CustomFields": {},
"RemindersSent": 0,
"ToPay": 480.00,
"OrderStatus": "ToPay",
"Overdue": false,
"DaysOverdue": -28,
"FXRateToForeign": 1.00000,
"DeliveryDate": "2026-04-27T00:00:00",
"AccountantVerificationNeeded": false,
"CurrentDocumentDeliveryDetails": {
"DocumentDeliveryDate": "2026-05-06T17:00:44.203",
"DocumentDeliveryInfo": "Received",
"IsDocumentDelivered": true,
"DocumentDeliveryStatus": "Delivered"
},
"Messages": [ // The content of the messages showed in the Messsage Center.
{
"FileID": "f2ac890d-e220-43d0-9f20-14a5c4ce9999", //Allows you to get the file
"CreationDate": "2026-05-06T16:13:55.88",
"TransportType": "Peppol",
"Success": true,
"Trials": 3,
"Destination": "0225:127362199_DEMO",
"MessageDirection": "Outgoing"
},
{
"Description": "FFE0614A",
"FileID": "6b66d6f3-9b63-419d-9d05-548a3a1f99a9",
"CreationDate": "2026-05-06T16:15:11.237",
"TransportType": "FrenchTaxAuthority",
"Success": true,
"Trials": 0,
"Destination": "FrenchTaxAuthority",
"MessageDirection": "Outgoing"
},
{
"Description": "CFE0614A",
"FileID": "a5a32c1b-b36c-48d4-a9d3-799c9e9dcccb",
"CreationDate": "2026-05-06T16:20:17.083",
"TransportType": "FrenchTaxAuthority",
"Success": true,
"Trials": 0,
"MessageDirection": "Incoming"
},
{
"Description": "FFE0111A",
"FileID": "fa6abba9-65fa-4783-bd53-f922da199999",
"CreationDate": "2026-05-06T16:20:51.223",
"TransportType": "FrenchTaxAuthority",
"Success": true,
"Trials": 0,
"Destination": "FrenchTaxAuthority",
"MessageDirection": "Outgoing"
},
{
"Description": "CFE0111A",
"FileID": "bc348978-c5ca-4470-ab76-8786ca423d99",
"CreationDate": "2026-05-06T16:25:07.617",
"TransportType": "FrenchTaxAuthority",
"Success": true,
"Trials": 0,
"MessageDirection": "Incoming"
},
{
"Description": "ack",
"FileID": "31eafcc2-98b9-4a09-911e-fb5f37c9999f",
"CreationDate": "2026-05-06T16:55:45.533",
"TransportType": "FrenchTaxAuthority",
"Success": true,
"Trials": 0,
"MessageDirection": "Incoming"
},
{
"Description": "AB: The document has been successfully received.",
"FileID": "afc3f4e8-4502-49d3-bbfe-3a56bf99bee0",
"CreationDate": "2026-05-06T17:11:58.147",
"TransportType": "Peppol",
"Success": true,
"Trials": 0,
"Destination": "0225:127362116_DEMO",
"MessageDirection": "Incoming"
}
]
}Communication Messages when there are no Issues with Invoice
Minimum Flow of Status Messages (Mandatory Messages)
- From Invoice Receiver to the Billit Invoice Sender : no mandatory Message (only optional messages, Billit will not send the optional messages).
- From Billit Invoice Sender to Invoice Receiver : 1 message : 212 Payment Received
Maximum Number of Positive Messages (Including Optional) that you can receive when sending sales invoices via Billit
Messages when more Information is Requested
When you are sending sales invoices via Billit, you might receive the following messages from the receiver:
Communications Overview:
| What | Format | PA Message Number |
|---|---|---|
| Request more info | PA Message | 208 |
| Deliver more info | Outside PA (e.g. email) | |
| Confirm : info received, information gathering is complete | PA Message | 209 |
Flow of possible PA Messages for more information :
Communication when there are no Issues with Invoice
When you are sending sales invoices via Billit, you might receive the following optional information from the receiver:
- From Invoice Receiver to Invoice Sender : no mandatory Message
- From Invoice Sender to Invoice Receiver : 1 message : 212 Payment Received (Mandatory)
Communication in case of Issues with Invoice
When you are sending sales invoices via Billit, you might receive the following negative information from the receiver:
About the messages in case of issues:
| PA Message Number | Coming From | What | Type of Status |
|---|---|---|---|
| 500 | PPF | Rejection = blocking error. Typically invalid or missing data, incorrect identfiers. | Final |
| 213 | Service Providers | Rejected in platform (technical or business rejection) | Final |
| 207 | Receiver | In dispute : does not agree with a part or the total. This is an intermediate message, not a final status | Intermediary |
| 210 | Receiver | Refused by Receiver : the receiver rejects the complete invoice. | Final |
Updated 3 days ago