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
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 Invoice Sender : no mandatory Message
- From Invoice Sender to Invoice Receiver : 1 message : 212 Payment Received
Maximum Number of Positive Messages (Including Optional)
Messages when more Information is requested
Communications Overview:
| What | Format | PA Message Number |
|---|---|---|
| Request more info | PA Message | 208 |
| Deliver more info | Outside PA (e.g. email) | |
| Confirm : info receive, information gathering is complete | PA Message | 209 |
Flow of possible PA Messages (more information) :
Communication when there are no Issues with Invoice
- From Invoice Receiver to Invoice Sender : no mandatory Message
- From Invoice Sender to Invoice Receiver : 1 message : 212 Payment Received
Communication in case of Issues with Invoice
Flow chart of possible messages:
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 about 14 hours ago