Peppol BIS Billing 3.0 · rule
UBL-CR-117
What does UBL-CR-117 mean? A UBL invoice should not include the AdditionalDocumentReference LocaleCode
Why did my invoice fail UBL-CR-117?
EN 16931 states that a UBL invoice should not include the cbc:LocaleCode child of cac:AdditionalDocumentReference. In the core invoice model this element carries additional supporting documents (BG-24), which only support the identifier, document type code, description and attachment defined by the core model, so cbc:LocaleCode lies outside the standard's subset of UBL and validators flag its presence. It is a warning-level cardinality rule: the extra data is ignored by receivers that implement only the core model.
Official rule text
A UBL invoice should not include the AdditionalDocumentReference LocaleCode
Common causes
- A locale code is exported as cbc:LocaleCode, although the core model has no business term for it.
- A generic UBL library serialises every optional field of the DocumentReference aggregate by default.
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.