/ubl:Invoice/cac:AdditionalDocumentReference

Additional Document Reference Group

Portugal | VRBL-Invoice-PT-2p1
Context ID INV0213
Usage O*

Description

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

The additional supporting documents can be used for both referencing a document number which is expected to be known by the receiver, an external document (referenced by a URL) or as an embedded document, Base64 encoded (such as a time report or the PDF version of the invoice).

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

An identifier for the referenced document.

 1..1
O cbc:DocumentDescription Additional Document Reference Document Description

Text describing the referenced document.

 0..n
O cac:Attachment Attachment Group

The referenced document as an attachment to the document from which it is referenced.

 0..1
Details

vrbl-invoice-en16931-ubl-model

In the context of EN16931 it can be used to cover following business terms:

  • Invoiced object identifier (BT-18)
  • Additional Supporting Documents (BG-24)

Example: PT_invoice_380_ATM_payment.xml

<ubl:Invoice>
  <!-- ... omitted for readability -->
  <cac:AdditionalDocumentReference>
    <cbc:ID schemeID="ANG">12345678-241231231231</cbc:ID>
    <cbc:DocumentDescription>QR_CODE</cbc:DocumentDescription>
    <cac:Attachment>
      <cbc:EmbeddedDocumentBinaryObject mimeCode="text/plain" filename="file_name.txt">QTpQVDEyMzQ1Njc4OSpCOlBUOTg3NjU0MzIxKkM6UFQqRDpGVCpFOk4qRjoyMDI0MDcxMipHOkZUIEFCMjAyNi8yNipIOkFUQ1VEOjk0M0toR0JkODEtMjYqSTE6UFQqSTc6NDAwLjAwKkk4OjEwMC4wMCpOOjEwMC4wMCpPOjUwMC4wMCpSOjk5OTk=</cbc:EmbeddedDocumentBinaryObject>
    </cac:Attachment>
  </cac:AdditionalDocumentReference>
  <!-- ... omitted for readability -->
</ubl:Invoice>
Rules
Rule ID Error Message
VRBL-INV-PT-2p1-267 For the Additional Document Reference Scheme ID = ANG the Additional Document Reference Document Description must be "QR_CODE" and Attachment Mime Code must be "text/plain".
VRBL-INV-EN16931-M-6 The Additional Document Reference ID must be provided in the Additional Document Reference Group.
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.