Peppol BIS Billing 3.0 · rule
UBL-CR-054
What does UBL-CR-054 mean? A UBL invoice should not include the DespatchDocumentReference VersionID
Why did my invoice fail UBL-CR-054?
The UBL 2.1 schema allows a VersionID child inside cac:DespatchDocumentReference, but this element is not part of the EN 16931 core invoice model, so a compliant invoice should not include it. UBL-CR rules exist because EN 16931 uses only a subset of full UBL: any element outside that subset carries data the receiver is not required to process. In the core model, cac:DespatchDocumentReference conveys the despatch advice reference (BT-16) and should be limited to cbc:ID (the despatch advice reference, BT-16).
Official rule text
A UBL invoice should not include the DespatchDocumentReference VersionID
Common causes
- Your ERP or invoicing software exports the full UBL 2.1 DespatchDocumentReference structure, including VersionID, instead of the EN 16931 subset
- A generic UBL template or mapping copies every available source field into the XML rather than only the core-model elements
- Data intended for another business term was mapped into cac:DespatchDocumentReference/VersionID because no obvious core element existed for it
How do I fix it?
<cac:DespatchDocumentReference> <cbc:ID>DESP-2024-042</cbc:ID> </cac:DespatchDocumentReference>
Related rules
UBL-CR-001 · UBL-CR-002 · UBL-CR-003 · UBL-CR-004 · UBL-CR-005 · UBL-CR-006 · UBL-CR-007 · UBL-CR-008
Paste it into the live demo, or call POST /v1/validate. See the quickstart.