/ubl:Invoice/cac:AdditionalDocumentReference

Additional Document Reference Group

Poland | VRBL-Invoice-PL-B2B-3p0
Context ID INV0213
Usage M

Description

A group of business terms providing information about additional supporting documents or referenced documents substantiating the claims made in the Invoice.

In Polish KSeF FA(3) invoices it is possible to provide multiple order numbers and their corresponding dates on document level, while the UBL format only allows for one element cac:OrderReference. In order to still be able to accommodate all additional related order numbers the repeatable Additional Document Reference element can be used.

Child elements
Usage Element Description Cardinality
M cbc:ID Additional Document Reference ID

An identifier for the referenced document.

 1..1
O cbc:IssueDate Additional Document Reference Issue Date

The date, assigned by the sender of the referenced document, on which the document was issued.

 0..1
Details

vrbl-invoice-pl-b2b-3p0

Use the scheme ID schemeID='ON' with the Referenced Document Identifier to indicate an order number.

Example: Providing three order numbers on document level.

<ubl:Invoice>
    <!-- Code omitted for clarity -->
    <!-- First order number -->
    <cac:OrderReference>
        <cbc:ID>000373824</cbc:ID>
        <cbc:IssueDate>2026-01-08</cbc:IssueDate>
    </cac:OrderReference>
    <!-- All additional order numbers -->
    <cac:AdditionalDocumentReference>
        <cbc:ID schemeID="ON">000373854</cbc:ID>
        <cbc:IssueDate>2026-01-08</cbc:IssueDate>
    </cac:AdditionalDocumentReference>
    <cac:AdditionalDocumentReference>
        <cbc:ID schemeID="ON">000373855</cbc:ID>
        <cbc:IssueDate>2026-01-08</cbc:IssueDate>
    </cac:AdditionalDocumentReference>
    <!-- Code omitted for clarity -->
</ubl:Invoice>

Example: VRBL_FA3_invoice-n-ordernumbers.xml

<ubl:Invoice>
  <!-- ... omitted for readability -->
  <cac:AdditionalDocumentReference>
    <cbc:ID schemeID="ON">000373854</cbc:ID>
    <cbc:IssueDate>2026-01-08</cbc:IssueDate>
  </cac:AdditionalDocumentReference>
  <!-- ... omitted for readability -->
</ubl:Invoice>
Rules
Rule ID Error Message
VRBL-INV-CORE-85 The Additional Document Reference Group expects a maximum of one Additional Document Reference Document Type.
VRBL-INV-CORE-86 The Additional Document Reference Group expects a maximum of one Additional Document Reference Document Description.