Peppol BIS Billing 3.0 · rule

UBL-CR-049

Layer en16931·Checked against Peppol BIS Billing 3.0 2026.5

What does UBL-CR-049 mean? A UBL invoice should not include the DespatchDocumentReference DocumentTypeCode

Why did my invoice fail UBL-CR-049?

The UBL 2.1 schema allows a DocumentTypeCode 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 DocumentTypeCode

Common causes

Your ERP or invoicing software exports the full UBL 2.1 DespatchDocumentReference structure, including DocumentTypeCode, 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/DocumentTypeCode because no obvious core element existed for it

How do I fix it?

<cac:DespatchDocumentReference>
  <cbc:ID>DESP-2024-042</cbc:ID>
</cac:DespatchDocumentReference>

Check your invoice against this rule

Paste it into the live demo, or call POST /v1/validate. See the quickstart.