VRBL: Sales and Order References

You may want to add a reference to an additional document, such as a sales or order refence.

The purchase order reference is a conditional element. If the Buyer has issued a purchase order it should be referenced by providing its identifier in the resulting invoice, otherwise you should use the BuyerReference element.

If the purchase order is referenced at the invoice header level, the document reference element on line level can be used to state the relevant line numbers in the order.

A sales order is issued by the Supplier, confirming the sale of specified products and may be provided in the invoice. In the invoice, both a purchase order and a sales order reference can be given, but be aware that an invoice instance cannot reference a sales order without providing the corresponding purchase order reference.

You can specify it at the Document or Line level.

Elements

Document level

Use the OrderReference element to specify this on the Document level:

ElementCardinalityDescription
Order Reference (Invoice/OrderReference)0..1A group containing elements that reference to a Sales or Purchase Order with which this Invoice is associated.
Purchase Order Reference (Invoice/OrderReference/ID)1..1The ID for the purchase order, usually issued by the Buyer.
Sales Order Reference (Invoice/OrderReference/SalesOrderID)0..1The sales order ID, usually issued by the Supplier.
Purchase Order Date (OrderReference/IssueDate)0..1The issue date of the referenced order.

Line level

Use the OrderLineReference element to specify this information on the Line level:

Element (Path)CardinalityDescription
Order Line Reference - Line ID (InvoiceLine/OrderLineReference/LineID)1..1An identifier for a referenced line within a purchase order, issued by the Buyer.
Order Line Reference - Order Reference (InvoiceLine/OrderLineReference/OrderReference)0..1A group of elements providing information about the referenced purchase order.
Order Line Reference - Order Reference ID (InvoiceLine/OrderLineReference/OrderReference/ID)1..1An identifier for a referenced purchase order, issued by the Buyer.

Country-Specific configurations

Example

<Invoice>
    <!-- code omitted for clarity -->
    <cac:OrderReference>
        <cbc:ID>PO-11223344</cbc:ID>
        <cbc:SalesOrderID>SO-123456</cbc:SalesOrderID>
        <cbc:IssueDate>2024-08-30</cbc:IssueDate>
    </cac:OrderReference>    
    <!-- code omitted for clarity -->
</Invoice>