BR-52 Supporting document 1 (BG-24) has no supporting document reference (BT-122)
Supporting document 1 (BG-24) has no supporting document reference (BT-122). BT-122 is the identifier the attachment is filed under — a timesheet number, a delivery note number, a contract reference — and it is what lets a reviewer years later connect the file to the thing it evidences. An attachment with a filename and no reference is a document nobody can cite.
This rule is implemented and its error payload below is real, but the long-form write-up — normative text, worked example, divergence note — is not written yet. Everything the library knows about this rule is on this page. Ask and we will prioritise it.
- Business term
BT-122- Severity
fatal
What the library returns
The exact object in result.errors when this rule fires.
Generated by running @attestwire/en16931, not transcribed:
{
"rule": "BR-52",
"field": "BT-122",
"severity": "fatal",
"message": "Supporting document 1 (BG-24) has no supporting document reference (BT-122). BT-122 is the identifier the attachment is filed under — a timesheet number, a delivery note number, a contract reference — and it is what lets a reviewer years later connect the file to the thing it evidences. An attachment with a filename and no reference is a document nobody can cite.",
"fix": "Set supportingDocuments[].reference to the identifier of the document you are attaching or pointing at. Use description (BT-123) for the human-readable label, not for the reference.",
"example": "\"supportingDocuments\": [{ \"reference\": \"TS-2026-07\", \"description\": \"Timesheet July 2026\" }]",
"xpath": "/ubl:Invoice/cac:AdditionalDocumentReference[1]/cbc:ID",
"docsUrl": "https://attestwire.com/rules/BR-52"
}
xpath locates the element in the generated UBL document,
which is where a KoSIT or Peppol validator will report the same problem.
A passing value
"supportingDocuments": [{ "reference": "TS-2026-07", "description": "Timesheet July 2026" }]The fix
Set supportingDocuments[].reference to the identifier of the document you are attaching or pointing at. Use description (BT-123) for the human-readable label, not for the reference.