Skip to content

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).

EN 16931 (CII) · Error · Message language: English · Version: xrechnung-3.0.2-validator-configuration-2026-08-31

[BR-52] Each Additional supporting document (BG-24) shall contain a Supporting document reference (BT-122).

EN 16931 (UBL) · Error · Message language: English · Version: xrechnung-3.0.2-validator-configuration-2026-08-31

[BR-52] Each Additional supporting document (BG-24) shall contain a Supporting document reference (BT-122).

Factur-X / ZUGFeRD EN 16931 · Error · Message language: English · Version: Factur-X 1.08 / ZUGFeRD 2.4
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

  • BR-01: Specification identifier (BT-24) is missing
  • BR-02: Invoice number (BT-1) is missing
  • BR-03: Invoice issue date (BT-2) is missing
  • BR-04: Invoice type code (BT-3) is missing
  • BR-05: Invoice currency code (BT-5) is missing
  • BR-06: Seller name (BT-27) is missing

Last updated:
Explanation of the validation rule, not legal or tax advice.