GET Info back via API
What information can be gathered for France
Get Feedback via API - main status elements
See general API documentation : https://docs.billit.be/docs/retrieve-invoice-information
When asking for information via API GET, the main fields to look at are:
| API Feedback Content | Reporting OK | Reporting Error |
|---|---|---|
| CurrentDocumentDeliveryDetails/IsDocumentDelivered | true | false |
| CurrentDocumentDeliveryDetails/IsDocumentDocumentDeliveryStatus | Delivered | Pending |
| TaxReportingStatusTC | Done | Failed |
Sample files (main content) :
{
"OrderID": 2673872,
"CompanyID": 1079374,
"OrderPDF": {
"FileID": "acc52824-e479-4385-8804-bf98a7499999",
"FileName": "Invoice_227010068_Simple3a_FRdemoreceive.pdf"
},
"Attachments": [
{
"FileID": "268489ae-ef59-490a-ac25-6f71499999",
"FileName": "227010068_Simple3a__2_06_2026 11_27_03.json"
}
],
"OrderNumber": "227010068_Simple3a",
"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-06-02T11:39:47.36",
"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": "127362999_DEMO",
"SchemeID": "0225",
"Preferred": false,
"IdentifierAddress": "0225:127362116_DEMO"
},
{
"IdentifierType": "SIREN",
"Identifier": "127362999",
"SchemeID": "0002",
"Preferred": false,
"IdentifierAddress": "0002:127362999"
}
],
"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": "+32475366999",
"Email": "[email protected]",
"Contact": "",
"VATNumber": "FR99227010999",
"LastModified": "2026-06-02T10:13:56.087",
"Created": "2026-04-24T15:35:56.34",
"PartyType": "Supplier",
"VATLiable": true,
"Language": "EN",
"VentilationCode": "4",
"CustomFields": [],
"BankAccounts": [
{
"IBAN": "BE43957767949999",
"BIC": "CTBKBEBX",
"Currency": "EUR",
"Verified": false,
"Saldo": 0.00
},
{
"IBAN": "Custom",
"Currency": "EUR",
"Verified": false,
"Name": "Custom",
"Saldo": 0.00
}
],
"Users": [],
"DefaultPaid": false,
"DisplayName": "FR demo send",
"FinancialReductionDaysDefault": 8,
"DefaultExpiryOffset": 30,
"GLDefaultExpiryOffset": 30,
"VATDeductable": true,
"DefaultReductionPercentage": 0.00,
"Identifiers": [
{
"IdentifierType": "SIREN",
"Identifier": "227010068",
"SchemeID": "0002",
"Preferred": false,
"IdentifierAddress": "0002:227010999"
},
{
"IdentifierType": "CTC",
"Identifier": "227010068_DEMO",
"SchemeID": "0225",
"Preferred": false,
"IdentifierAddress": "0225:22701999_DEMO"
}
],
"SmallEnterprise": false,
"DefaultCurrencyTC": "EUR",
"SendUBL": true,
"SendPDF": true
},
"OrderDate": "2026-06-02T00:00:00",
"ExpiryDate": "2026-06-24T00:00:00",
"OrderType": "Invoice",
"LastModified": "2026-06-05T13:53:52.063",
"Created": "2026-06-02T11:27:03.01",
"OrderDirection": "Income",
"OrderLines": [
{
"OrderLineID": 20628182,
"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,
"UnitPriceIncl": 480.00000,
"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": [
{
"ExternalProvider": "FrenchTaxAuthority",
"Category": "ack",
"Value": "227010068_227010068_Simple3a",
"EntityID": 0
}
],
"Comments": "additional info",
"Currency": "EUR",
"IsSent": true,
"Invoiced": false,
"CustomFields": {},
"RemindersSent": 0,
"ToPay": 100.00,
"OrderStatus": "ToPay",
"Overdue": false,
"DaysOverdue": -16,
"FXRateToForeign": 1.00000,
"DeliveryDate": "2026-04-27T00:00:00",
"AccountantVerificationNeeded": false,
"CurrentDocumentDeliveryDetails": {
"DocumentDeliveryDate": "2026-06-02T13:00:39.05",
"DocumentDeliveryInfo": "Received",
"IsDocumentDelivered": true,
"DocumentDeliveryStatus": "Delivered"
},
"Messages": [
{
"FileID": "894dcd55-9f02-4900-a12c-fcfe4acd9603", // XML file with the invoice that has been created in Billit
"CreationDate": "2026-06-02T11:29:02.493", // time is after FrenchTaxAuthority communication
"TransportType": "Peppol",
"Success": true,
"Trials": 4,
"Destination": "0225:127362116_DEMO",
"MessageDirection": "Outgoing",
"Subject": "b95c8f2a-43cc-4f72-9389-d0f5a019c195"
},
{
"Description": "Submitted", // Reporting has been initiated
"FileID": "88557f3a-4672-444e-8abd-4693211ad4cf", //file delivered by the French Tax Authority
"CreationDate": "2026-06-02T11:30:22.713",
"TransportType": "FrenchTaxAuthority", // FrenchTaxAuthority is added as information to indicate that it is coming from this source. It does not have to be used when you are sending files.
"Success": true,
"Trials": 0,
"Destination": "French tax authority",
"MessageDirection": "Outgoing",
"Subject": "Submitted"
},
{
"Description": "Submitted: Recevable", // First acknowledgement (not final)
"FileID": "ac4ea70a-5526-4778-bfbe-d2f7d441a87a",
"CreationDate": "2026-06-02T11:31:11.01",
"TransportType": "FrenchTaxAuthority",
"Success": true,
"Trials": 0,
"MessageDirection": "Incoming",
"Subject": "Submitted: Recevable"
},
{
"Description": "Document data",
"FileID": "bf155eb7-0e64-4ff9-966c-557c4f0a0c72",
"CreationDate": "2026-06-02T11:31:28.23",
"TransportType": "FrenchTaxAuthority",
"Success": true,
"Trials": 0,
"Destination": "French tax authority",
"MessageDirection": "Outgoing"
},
{
"Description": "Flux1: Recevable", // First analysis of data : accepted (not final)
"FileID": "d4e3f330-9d01-4465-a19e-be2862aa60bc",
"CreationDate": "2026-06-02T11:32:08.823",
"TransportType": "FrenchTaxAuthority",
"Success": true,
"Trials": 0,
"MessageDirection": "Incoming",
"Subject": "Flux1: Recevable"
},
{
"Description": "Accepted", // Final acceptance by French Tax Authority (ready to send to file)
"FileID": "97cb427e-47ca-4ddd-87b6-ae1a2656cbd9",
"CreationDate": "2026-06-02T12:33:45.8",
"TransportType": "FrenchTaxAuthority",
"Success": true,
"Trials": 0,
"MessageDirection": "Incoming",
"Subject": "Accepted"
},
{
"Description": "AB: The document has been successfully received.", //IMR feedback of Receiver
"FileID": "ebdb82e5-c010-46cc-942b-27222858aaed",
"CreationDate": "2026-06-02T13:11:48.697",
"TransportType": "Peppol",
"Success": true,
"Trials": 0,
"Destination": "0225:127362116_DEMO",
"MessageDirection": "Incoming"
},
{
"Description": "CashCollected", // Info sent to French Tax Authority about Cash Collediton : partial payment 1
"FileID": "83a093dc-c097-4da0-b9c5-0c5f23a0eac2",
"CreationDate": "2026-06-05T13:45:14.687",
"TransportType": "FrenchTaxAuthority",
"Success": true,
"Trials": 0,
"Destination": "French tax authority",
"MessageDirection": "Outgoing",
"Subject": "CashCollected"
},
{
"Description": "CashCollected", // Info sent to French Tax Authority about Cash Collediton : partial payment 2
"FileID": "4f61235c-2a9d-4bd9-9561-e53b711c0046",
"CreationDate": "2026-06-05T13:54:15.19",
"TransportType": "FrenchTaxAuthority",
"Success": true,
"Trials": 0,
"Destination": "French tax authority",
"MessageDirection": "Outgoing",
"Subject": "CashCollected"
},
{
"Description": "CashCollected: Recevable", // Info from French Tax Authority about Cash Collediton : partial payment 1 is accepted
"FileID": "5f540de7-ca04-4e25-a5d0-8aa28bd0253f",
"CreationDate": "2026-06-05T14:04:15.417",
"TransportType": "FrenchTaxAuthority",
"Success": true,
"Trials": 0,
"MessageDirection": "Incoming",
"Subject": "CashCollected: Recevable"
},
{
"Description": "CashCollected: Recevable", // Info from French Tax Authority about Cash Collediton : partial payment 2 is accepted
"FileID": "f8bd914a-7d90-4348-ae52-64f51ffe170f",
"CreationDate": "2026-06-05T14:37:16.48",
"TransportType": "FrenchTaxAuthority",
"Success": true,
"Trials": 0,
"MessageDirection": "Incoming",
"Subject": "CashCollected: Recevable"
}
],
"TaxReportingStatusTC": "Done" // Ereporting (flow 1 has been terminated)
}{
"OrderID": 2637999,
"CompanyID": 865999,
"OrderPDF": {
"FileID": "f8dd5e9d-0aee-4b05-86fe-47a75b550999",
"FileName": "Facture_00004_TestcustomerPPFReject.pdf"
},
"Attachments": [],
"OrderNumber": "00004",
"Customer": {
"PartyID": 1092999,
"Nr": "1",
"Name": "Test customer PPF Reject",
"Addresses": [
{
"AddressType": "InvoiceAddress",
"Name": "Test customer error from PPF",
"StreetNumber": "1",
"Zipcode": "75001",
"City": "Paris",
"CountryCode": "FR"
},
{
"AddressType": "DeliveryAddress",
"Name": "Test customer error from PPF",
"StreetNumber": "1",
"Zipcode": "75001",
"City": "Paris",
"CountryCode": "FR"
}
],
"StreetNumber": "1",
"Zipcode": "75001",
"City": "Paris",
"CountryCode": "FR",
"Contact": "",
"VATNumber": "FR34532578572",
"LastModified": "2026-05-18T13:24:32.047",
"Created": "2026-05-18T12:00:03.12",
"PartyType": "Customer",
"VATLiable": true,
"Language": "FR",
"VentilationCode": "4",
"CustomFields": [],
"BankAccounts": [],
"Users": [],
"DefaultPaid": false,
"DisplayName": "Test customer PPF Reject",
"DefaultExpiryOffset": 30,
"GLDefaultExpiryOffset": 30,
"VATDeductable": true,
"DefaultReductionPercentage": 0.00,
"Identifiers": [
{
"IdentifierType": "CTC",
"Identifier": "227010068_ERROR",
"SchemeID": "0225",
"Preferred": false,
"IdentifierAddress": "0225:227010068_ERROR"
},
{
"IdentifierType": "SIREN",
"Identifier": "34532578572",
"SchemeID": "0002",
"Preferred": false,
"IdentifierAddress": "0002:34532578572"
}
],
"SmallEnterprise": false,
"DefaultCurrencyTC": "EUR",
"SendUBL": true,
"SendPDF": true
},
"Supplier": {
"PartyID": 865999,
"Name": "Test supplier",
"Addresses": [
{
"AddressType": "InvoiceAddress",
"Street": "Rue test",
"StreetNumber": "29",
"Zipcode": "59760",
"City": "Grande-Synthe",
"CountryCode": "FR",
"Phone": "+33235723999"
},
{
"AddressType": "DeliveryAddress",
"Street": "Rue test",
"StreetNumber": "27",
"Zipcode": "59760",
"City": "Grande-Synthe",
"CountryCode": "FR",
"Phone": "+33235723999"
}
],
"Street": "Rue test",
"StreetNumber": "29",
"Zipcode": "59760",
"City": "Grande-Synthe",
"CountryCode": "FR",
"IBAN": "FR7616706050925401337319999",
"BIC": "AGRIFRPP867",
"Phone": "+33235723415",
"Email": "[email protected]",
"Contact": "",
"VATNumber": "FR27570501999",
"LastModified": "2026-05-18T11:29:33.803",
"Created": "2025-11-28T17:18:39.683",
"PartyType": "Supplier",
"VATLiable": true,
"Language": "FR",
"VentilationCode": "4",
"CustomFields": [],
"BankAccounts": [
{
"IBAN": "FR7616706050925401337319999",
"BIC": "AGRIFRPP867",
"Currency": "EUR",
"Verified": false,
"Saldo": 0.00
}
],
"Users": [],
"DefaultPaid": false,
"DisplayName": "Test Company",
"FinancialReductionDaysDefault": 8,
"DefaultExpiryOffset": 30,
"GLDefaultExpiryOffset": 30,
"VATDeductable": true,
"DefaultReductionPercentage": 0.00,
"Identifiers": [
{
"IdentifierType": "SIREN",
"Identifier": "570501999",
"SchemeID": "0002",
"Preferred": false,
"IdentifierAddress": "0002:570501916"
},
{
"IdentifierType": "VAT",
"Identifier": "FR27570501999",
"SchemeID": "9957",
"Preferred": false,
"IdentifierAddress": "9957:FR27570501999"
},
{
"IdentifierType": "CTC",
"Identifier": "570501916_TEST",
"SchemeID": "0225",
"Preferred": false,
"IdentifierAddress": "0225:570501999"
}
],
"SmallEnterprise": false,
"DefaultCurrencyTC": "EUR",
"SendUBL": true,
"SendPDF": true
},
"OrderDate": "2026-05-18T00:00:00",
"ExpiryDate": "2026-06-17T00:00:00",
"OrderType": "Invoice",
"LastModified": "2026-05-18T13:29:32.977",
"Created": "2026-05-18T13:28:17.143",
"OrderDirection": "Income",
"OrderLines": [
{
"OrderLineID": 20490135,
"Quantity": 1.00000,
"UnitPriceExcl": 1.01000,
"Description": "test",
"TotalExcl": 1.01,
"TotalVAT": 0.20,
"VATPercentage": 20.00,
"VentilationCode": "4",
"CustomFields": {},
"InclLeading": false,
"TotalIncl": 1.21
}
],
"PaymentDiscountPercentage": 0.00,
"PaymentDiscountAmount": 0.00,
"VatGroups": [
{
"VentilationCode": "4",
"VATPercentage": 20.00,
"TotalExcl": 1.01,
"TotalVAT": 0.20,
"TotalIncl": 1.21,
"Mtvh": 1.01,
"FinancialReductionAmount": 0.00
}
],
"VentilationCode": "4",
"TotalExcl": 1.01,
"TotalIncl": 1.21,
"TotalVAT": 0.20,
"Tags": [],
"PaymentReference": "+++000/0455/57999+++",
"Paid": false,
"ExternalProviderReferences": [],
"Currency": "EUR",
"IsSent": true,
"Invoiced": false,
"CustomFields": {},
"RemindersSent": 0,
"ToPay": 1.21,
"OrderStatus": "ToPay",
"Overdue": false,
"DaysOverdue": -29,
"FXRateToForeign": 1.00000,
"DeliveryDate": "2026-05-18T00:00:00",
"AccountantVerificationNeeded": false,
"CurrentDocumentDeliveryDetails": {
"IsDocumentDelivered": false, // Rejected by French Authority, not delivered to customer
"DocumentDeliveryStatus": "Pending"
},
"Messages": [
{
"Description": "Reporting failed",
"CreationDate": "2026-05-18T13:28:20.72",
"TransportType": "Peppol",
"Success": false,
"Trials": 1,
"Destination": "0225:227010068_ERROR",
"MessageDirection": "Outgoing"
},
{
"Description": "FFE0614A",
"FileID": "2f8f4ab9-fe77-4a30-89b8-1e1634bb0a2f",
"CreationDate": "2026-05-18T13:29:33.07",
"TransportType": "FrenchTaxAuthority",
"Success": true,
"Trials": 0,
"Destination": "FrenchTaxAuthority",
"MessageDirection": "Outgoing"
},
{
"Description": "CFE0614A",
"FileID": "522876ae-2626-4ee1-9494-1d1b76b37221",
"CreationDate": "2026-05-18T13:29:34.07",
"TransportType": "FrenchTaxAuthority",
"Success": true,
"Trials": 0,
"Destination": "FrenchTaxAuthority",
"MessageDirection": "Incoming"
},
{
"Description": "FFE0111A",
"FileID": "7a3d84ab-fcf0-48a8-9bab-0e89c18df452",
"CreationDate": "2026-05-18T13:29:35.07",
"TransportType": "FrenchTaxAuthority",
"Success": true,
"Trials": 0,
"Destination": "FrenchTaxAuthority",
"MessageDirection": "Outgoing"
},
{
"Description": "CFE0111A",
"FileID": "c0ba7b51-85af-41c5-8eda-ad579a847a82",
"CreationDate": "2026-05-18T13:29:36.07",
"TransportType": "FrenchTaxAuthority",
"Success": true,
"Trials": 0,
"Destination": "FrenchTaxAuthority",
"MessageDirection": "Incoming"
},
{
"Description": "ack",
"FileID": "660a861e-e240-4cab-b87c-962ece5d859d",
"CreationDate": "2026-05-18T13:29:37.07",
"TransportType": "FrenchTaxAuthority",
"Success": true,
"Trials": 0,
"Destination": "FrenchTaxAuthority",
"MessageDirection": "Incoming"
}
],
"TaxReportingStatusTC": "Failed"
}Details of the final Feedback file of the French Tax Authority
In the final Feedback file of the French Tax Authority the a SpecifiedDocumentStatus is available.
| Status | Final XML File |
|---|---|
| Invoice Approved by French Tax Authority | no SpecifiedDocumentStatus in XML |
| Invoice Rejected by French Tax Authority | SpecifiedDocumentStatus in XML contains the error |
Below example : part of a returned file of in case of a French Tax Authority reject:
<ram:SpecifiedDocumentStatus>
<ram:ReasonCode>REJ_UNI</ram:ReasonCode>
<ram:SequenceNumeric>1</ram:SequenceNumeric>// First Remark
<ram:IncludedNote>
<ram:ContentCode>G1.45</ram:ContentCode>
<ram:Content>Échec du contrôle de l'unicité du F1.</ram:Content> // Text description about error 1
<ram:SubjectCode>BT-1, BT-2, BT-30</ram:SubjectCode> // Error related to Business Terms
</ram:IncludedNote>
</ram:SpecifiedDocumentStatus>
<ram:SpecifiedDocumentStatus>
<ram:ReasonCode>REJ_SEMAN</ram:ReasonCode>
<ram:SequenceNumeric>2</ram:SequenceNumeric>// Second Remark
<ram:IncludedNote>
<ram:ContentCode>G1.05</ram:ContentCode>
<ram:Content>L'identifiant de la facture BT-1 ne respecte pas le format attendu.</ram:Content>
<ram:SubjectCode>BT-1</ram:SubjectCode> // Error related to Business Terms
</ram:IncludedNote>
</ram:SpecifiedDocumentStatus>