BR-52: Supporting document reference (BT-122) is missing
Official message
[BR-52] Each Additional supporting document (BG-24) shall contain a Supporting document reference (BT-122).
[BR-52] Each Additional supporting document (BG-24) shall contain a Supporting document reference (BT-122).
[BR-52] Each Additional supporting document (BG-24) shall contain a Supporting document reference (BT-122).
- Severity
- Error The invoice is invalid and may be rejected by the recipient.
- Applies to
- EN 16931 (CII), EN 16931 (UBL), Factur-X / ZUGFeRD EN 16931
- Affected fields
- BG-24, BT-122
What does this mean?
Every additional supporting document (BG-24) must contain a supporting document reference (BT-122), e.g. the number of a timesheet. It is missing or empty for at least one document.
In CII (BT-17/BT-18) and UBL (BT-18) the rule also checks tender or object identifiers stored in the same element: in CII every ram:AdditionalReferencedDocument, in UBL every cac:AdditionalDocumentReference, including the object identifier with DocumentTypeCode 130.
Typical causes
An attachment was given with file name or description only, but without a reference.
A tender or object identifier was output without a value.
How to fix the error
State a reference for every document, e.g. the document number or a unique name.
CII: ram:ApplicableHeaderTradeAgreement/ram:AdditionalReferencedDocument/ram:IssuerAssignedID, UBL: cac:AdditionalDocumentReference/cbc:ID.
Generate and validate the invoice again.
In E-Rechnungsfreund
In the invoice form ("Experte" view), section "Zusätzliche Dokumente (BG-24)" (additional documents), fill in the field "Referenz (BT-122)" (reference) for every document. In section "Objekt-Identifikatoren Header (BT-17/BT-18)" (object identifiers) check the field "Identifier (BT-17/BT-18)" of every entry.
Example
Wrong
<ram:AdditionalReferencedDocument>
<ram:IssuerAssignedID></ram:IssuerAssignedID>
<ram:TypeCode>916</ram:TypeCode>
<ram:Name>Timesheet March</ram:Name>
</ram:AdditionalReferencedDocument>
Correct
<ram:AdditionalReferencedDocument>
<ram:IssuerAssignedID>TS-2026-03</ram:IssuerAssignedID>
<ram:TypeCode>916</ram:TypeCode>
<ram:Name>Timesheet March</ram:Name>
</ram:AdditionalReferencedDocument>
For developers: test expression per syntax
EN 16931 (CII) (CII)
Context: //ram:AdditionalReferencedDocument
normalize-space(ram:IssuerAssignedID) != ''
EN 16931 (UBL) (UBL)
Context: cac:AdditionalDocumentReference
normalize-space(cbc:ID) != ''
Factur-X / ZUGFeRD EN 16931 (CII)
Technical ID in the source: FX-SCH-A-000280
Context: //ram:AdditionalReferencedDocument
(ram:IssuerAssignedID!='')
Related validation rules
Last updated:
Explanation of the validation rule, not legal or tax advice.