Extra Fields : How can I add certain Peppol values that Billit JSON does not support
Custom Fields - Extra Fields - More Fields
Billit provides a JSON structure with a wide range of fields. However, since some networks have different types of fields that we might not support out of the box, we have enabled the use of custom fields in our e-invoice network. Below a list of CustomFields that can be used by everybody, valid for Income (Sales, Outgoing).
You can add these fields for both Invoices and Creditnote. To avoid mistakes, the root element (Invoice, CreditNote, InvoiceLine,CreditNoteLine) must always be declared.
The allowed values for Income can be found in the lists below.
Order (Header Level - Income)
Orderline (Line level - Income)
| Key (Line) | Value (TransferType = Peppol) |
|---|---|
| PeppolUnitCode | https://docs.peppol.eu/poacc/billing/3.0/codelist/UNECERec20/ . Sample value H87 |
| InvoiceLine.InvoicePeriod.StartDate | https://docs.peppol.eu/poacc/billing/3.0/syntax/ubl-invoice/cac-InvoiceLine/cac-InvoicePeriod/cbc-StartDate/ |
| InvoiceLine.InvoicePeriod.EndDate | https://docs.peppol.eu/poacc/billing/3.0/syntax/ubl-invoice/cac-InvoiceLine/cac-InvoicePeriod/cbc-EndDate/ |
| InvoiceLine.Item.CommodityClassification.ItemClassificationCode.Text | https://docs.peppol.eu/poacc/billing/3.0/syntax/ubl-invoice/cac-InvoiceLine/cac-Item/cac-CommodityClassification/cbc-ItemClassificationCode/ |
| InvoiceLine.Item.CommodityClassification.ItemClassificationCode.ListID | https://docs.peppol.eu/poacc/billing/3.0/syntax/ubl-invoice/cac-InvoiceLine/cac-Item/cac-CommodityClassification/cbc-ItemClassificationCode/listID/ |
Will be supported in the future
| Key (Header) | Value (TransferType = Peppol) |
|---|---|
| Invoice.OrderReference.SalesOrderID.ID.Text | https://docs.peppol.eu/poacc/billing/3.0/syntax/ubl-invoice/cac-OrderReference/cbc-SalesOrderID/ |
Example Json with Custom Fields
See below content of Custom Fields on Header Level and Detail Line Level
{
"OrderType": "Invoice",
"OrderDirection": "Income",
"OrderNumber": "QS-002",
"OrderDate": "2025-05-05",
"ExpiryDate": "2025-06-30",
"CustomFields" : {
"Invoice.AccountingCustomerParty.Party.Contact.ElectronicMail":"[email protected]",
"Invoice.AccountingCustomerParty.Party.Contact.Name":"Piet Pieters",
"Invoice.AccountingCustomerParty.Party.Contact.Telephone":"015999999",
"Invoice.AccountingSupplierParty.Party.Contact.Telephone":"0385478749",
"Invoice.AccountingSupplierParty.Party.Contact.ElectronicMail": "[email protected]",
"Invoice.AccountingSupplierParty.Party.Contact.Name": "Jean Dupont",
"Invoice.Delivery.DeliveryLocation.ID.Text": "658798574", //in the Delivery segment, goal is give the delivery address a specific identification
"Invoice.AccountingCost":"AccCost95421", //Reference of a Cost center for use by the Receiver
"Invoice.InvoicePeriod.StartDate": "2025-04-01", //To what period the invoice is referring
"Invoice.InvoicePeriod.EndDate": "2025-04-30",
"Invoice.Note": "header note description: additional text information",
"Invoice.ProjectReference.ID.Text": "project number 456854",
"Invoice.ContractDocumentReference.ID.Text": "contract 456999", //A reference to the contract
"PaymentTerms": "30 days end of the month" // PaymentTerms/Note : Free description
},
"Customer": {
"Name": "Billit",
"VATNumber": "BE0563846944",
"PartyType": "Customer",
"Identifiers": [
{
"IdentifierType": "GLN",
"Identifier": "5430003799999"
}
],
"Addresses": [
{
"AddressType": "InvoiceAddress",
"Name": "Billit",
"Street": "Oktrooiplein",
"StreetNumber": "1",
"City": "Ghent",
"Box": "301",
"CountryCode": "BE"
},
]
},
"OrderLines": [
{
"Quantity": 1,
"UnitPriceExcl": 10.0,
"Description": "Box of cookies",
"CustomFields"
:
{
"InvoiceLine.Item.CommodityClassification.ItemClassificationCode.Text":"45123456789",
"InvoiceLine.Item.CommodityClassification.ItemClassificationCode.ListID":"PO",
"PeppolUnitCode":"H87",
"InvoiceLine.InvoicePeriod.StartDate":"2025-04-01",
"InvoiceLine.InvoicePeriod.EndDate":"2025-04-30",
},
"VATPercentage": 6
},
{
"Quantity": 2,
"UnitPriceExcl": 3.75,
"Description": "Sticks",
"VATPercentage": 21
}
]
}
Updated 2 days ago