How can I add a PO number to an invoice (or multiple PO's) numbers)
Purchase Order Number on the header of an invoice or detail line
A customer may ask a PO number to put as reference on your invoice. The PO number should be added on Order header level in the property Reference.
PO on header
{
"OrderType": "Invoice",
"OrderDirection": "Income",
"OrderNumber": "QS-004",
"OrderDate": "2025-05-05",
"ExpiryDate": "2025-05-30",
"Reference": "45123456789", //PO Reference of the buyer on header level
}Remarks:
- Put only one PO number in this tag.
- Only put the PO reference, not additional text.
PO on line
Although **not **the preferred scenario with networks such as Peppol, it might be useful/needed to reference PO numbers on line level (one PO per line):
- In that case only one PO is mentioned on header level,
- and multiple on line level (one PO per line).
First option is to include PO as text in a LineNote as free text. Benefit is that it is easy to understand for a receiver:
{
"Quantity": 3,
"UnitPriceExcl": 5.00,
"Description": "Cookies",
"DescriptionExtended": "Box of cookies 20 pieces, 200 g", //Optional longer description
"Reference": "917865", //Supplier Article Number
"VATPercentage": 0,
"CustomFields" :
{
"InvoiceLine.Note": "Purchase Order Number 45123456789"
},
} Second option is to include PO in commodity classification:
- The listID PO is an offical value in the code list.
- Not all receivers may be able to process this information. So you can combine with free text in InvoiceLine.Note.
- Below example of the combination.
{
"Quantity": 3,
"UnitPriceExcl": 5.00,
"Description": "Cookies",
"DescriptionExtended": "Box of cookies 20 pieces, 200 g", //Optional longer description
"Reference": "917865", //Supplier Article Number
"VATPercentage": 0,
"CustomFields" :
{
"CommodityClassificationPO": "45123456789",
"CommodityClassificationSRV": "5410355405132" ,
"InvoiceLine.Note": "Purchase Order Number 45123456789"
},
} Updated 10 days ago