UBL-CR-659:A UBL invoice shall not include the AdditionalDocumentReference...
Fix: Invoice Navigator automatically removes the disallowed `@listID` element from your Invoice (UBL-CR-659). Upload your invoice to fix this automatically.
UBL 2.1 Invoice schema does not include `cac:AdditionalDocumentReference/cbc:DocumentTypeCode/@listID`. This element must be removed for EN 16931 compliance.
Engine Classification
Remove disallowed UBL attribute per EN16931 specification
Confidence: 95% · Applied automatically in pipeline
What is UBL-CR-659?
UBL-CR-659 is a fatal validation rule defined in the UBL 2.1 specification. It validates the @listID element under AdditionalDocumentReference > DocumentTypeCode in the UBL invoice XML.
When this rule fires, the invoice is rejected by Peppol access points and never reaches the buyer.
Target path: /Invoice/cac:AdditionalDocumentReference/cbc:DocumentTypeCode/@listID
Why This Error Matters
Invoice will be rejected by EN16931 validators. These conformance rules prohibit UBL attributes and element combinations not in the EN16931 e-invoicing profile. Remove the disallowed attribute or restructure the element.
UBL-CR-659 is a hard failure — the invoice must be corrected and re-sent before it can reach the recipient.
Invoice Navigator can automatically correct this error in your pipeline. The fix is applied with full audit evidence, so your compliance trail remains intact.
Validator Behavior
- ·Causes invoice rejection
- ·Fails UBL schema validation
- ·Error returned: UBL-CR-659
- ·Specification: UBL 2.1
How to Fix It
Find the disallowed attribute
Check @listID at /Invoice/cac:AdditionalDocumentReference/cbc:DocumentTypeCode/@listID. This attribute is not permitted in the target profile.
Remove the attribute
Invoice Navigator automatically removes the disallowed `@listID` element from your Invoice (UBL-CR-659).
Re-validate your invoice
Upload the corrected invoice to confirm UBL-CR-659 is resolved.
Before / After
<cbc:DocumentTypeCode> <@listID>value</@listID> </cbc:DocumentTypeCode>
<cbc:DocumentTypeCode> <!-- @listID removed for EN 16931 compliance --> </cbc:DocumentTypeCode>
Technical Reference
/Invoice/cac:AdditionalDocumentReference/cbc:DocumentTypeCode/@listIDCommon Causes
- ·AdditionalDocumentReference DocumentTypeCode has listID
- ·cbc:DocumentTypeCode/@listID not in EN16931 profile
- ·List identifier on document type not permitted
- ·Code list reference attribute not needed
- ·ERP exports list ID on attachment type code
Seeing this in production? The API handles UBL-CR-659 automatically. See the fix response →
Frequently Asked Questions
UBL 2.1 Invoice schema does not include `cac:AdditionalDocumentReference/cbc:DocumentTypeCode/@listID`. This element must be removed for EN 16931 compliance.
Invoice Navigator automatically removes the disallowed `@listID` element from your Invoice (UBL-CR-659). You can also use Invoice Navigator's compliance engine to correct this automatically in your pipeline.
Yes, UBL-CR-659 is a critical error that will cause invoice rejection. It must be fixed before submission.
Many instances of UBL-CR-659 can be automatically corrected using Invoice Navigator's compliance engine. The fix is applied in your pipeline with full audit evidence.
Last updated: 14 April 2026
Validate your invoice
Drop your XML here to check for UBL-CR-659
Auto-fix UBL-CR-659 in seconds
Upload your invoice and we fix this error automatically. Financial fields are never touched.