Skip to content

Warning

UBL-CR-659: Additional document type codes must have no listID attribute

In short

Warning: worth checking.

UBL-CR-659 means the type code of an additional document reference has a listID attribute, which EN 16931 does not use. Remove the attribute and keep the code.

On this page

What it means

This rule checks cbc:DocumentTypeCode inside each cac:AdditionalDocumentReference directly under the invoice or credit note and flags any listID attribute. An additional document reference points to something that goes with the invoice, such as a supporting document or an object the invoice is about. Type code 130 marks the reference as an invoiced object identifier (BT-18). This rule checks the attribute, not the code value.

Why it matters

EN 16931 requires these additional document type codes to have no listID attribute. The code value is outside this check.

How to fix it

Remove listID from cbc:DocumentTypeCode inside each top-level cac:AdditionalDocumentReference that has it. Leave the existing code unchanged. If your software adds the attribute, ask its supplier to correct the export, then check the new file again.

Once the file is corrected, check it again for free: Validate an invoice against EN 16931

Or fix the invoice in a form and download the corrected file, for 1 credit: Fix a rejected e-invoice

The rule as published

A UBL invoice shall not include the AdditionalDocumentReference DocumentTypeCode listID

Where this rule applies

Rule set Version
EN 16931 (UBL) 1.3.17
EN 16931 (UBL credit note) 1.3.17
XRechnung 3.0 (UBL) 3.0.2
XRechnung 3.0 (UBL credit note) 3.0.2
Peppol BIS Billing 3.0 (invoice) 2026.5
Peppol BIS Billing 3.0 (credit note) 2026.5
SI-UBL 2.0 / NLCIUS (invoice) 2.0.3.13
SI-UBL 2.0 / NLCIUS (credit note) 2.0.3.13
France CTC (UBL invoice) 1.4.0-04
France CTC (UBL credit note) 1.4.0-04
CIUS-RO UBL Invoice 1.0.9 1.0.9
CIUS-RO UBL Credit Note 1.0.9 1.0.9
Rule text from phive-rules 4.6.4.

Check your file

Drop your e-invoice to see whether UBL-CR-659 still fails, and which other rules do.

Updated 6 November 2026