VRBL: Dispatch Advice References

You can reference a dispatch advice in your Document.

When an invoice references items that have been delivered with separate dispatches, the references should be provided on the line level using the DespatchDocumentReference element.

When the invoiced quantity of an item has been delivered in more than one dispatch, the invoice must have separate lines for each dispatch. When dispatches are referenced on line level, you cannot have a document level reference.

This can be specified on the Document or Line levels.

Elements

Document level

Use the DespatchDocumentReference element to model this information at the Document level:

Name (Path)CardinalityDescription
Dispatch Document Reference (/Invoice/DespatchDocumentReference)0..1A group of elements providing information about the dispatch advice reference at the Document level.
Dispatch Document Reference ID (/Invoice/DespatchDocumentReference/ID)1..1An identifier for the dispatch document.
Dispatch Document Reference Issue Date (/Invoice/DespatchDocumentReference/IssueDate)0..1The date of issue.

Line level

Use the DespatchLineReference element to model this information at the Line level:

Name (Path)CardinalityDescription
Dispatch Document Reference (/Invoice/InvoiceLine/DespatchLineReference)0..1A group of elements providing information about the dispatch advice line reference for the invoice line.
Dispatch Document Reference Line ID (/Invoice/InvoiceLine/DespatchLineReference/LineID)1..1An identifier for a referenced line within a dispatch advice.
Dispatch Document Reference Dispatch Advice (/Invoice/InvoiceLine/DespatchLineReference/DocumentReference)0..1A group of elements providing information about the referenced dispatch advice.
Dispatch Document Reference Dispatch Advice (/Invoice/InvoiceLine/DespatchLineReference/DocumentReference/ID)1..1An identifier for a referenced dispatch advice.

Restrictions

  • If the Document references charges to items that were delivered in separate dispatches. these references should be provided on the line level.
  • If an item is delivered in multiple dispatches, the Document must specify individual lines
  • If you do specify the dispatch information at the Line level, you cannot specify it at the Document level.

Examples

Document level

<Invoice>
    <!-- code omitted for clarity -->
    <cac:DespatchDocumentReference>
        <cbc:ID>DN-11223344</cbc:ID>
        <cbc:IssueDate>2024-08-30</cbc:IssueDate>
    </cac:DespatchDocumentReference>    
    <!-- code omitted for clarity -->
</Invoice>

Line level

<Invoice>
    <!-- code omitted for clarity -->
    <cac:InvoiceLine>
        <!-- code omitted for clarity -->
        <cac:DespatchLineReference>
            <cbc:LineID>120</cbc:LineID>
            <cac:DocumentReference>
                <cbc:ID>PO12345</cbc:ID>
            </cac:DocumentReference>
        </cac:DespatchLineReference>
        <!-- code omitted for clarity -->
    </cac:InvoiceLine>
</Invoice>