Skip to content

Warning

UBL-CR-589: Catalogue document references are not used on invoice lines

In short

Warning: worth checking.

UBL-CR-589 means an invoice or credit note line refers to a catalogue document (cac:CatalogueDocumentReference), which EN 16931 does not use. It is a warning. Remove the reference, or mention it in the line note (BT-127) if the buyer needs it.

On this page

What it means

The rule looks at the item on every invoice line (or credit note line) in a UBL file. It warns when the item contains a cac:CatalogueDocumentReference block, a pointer to the catalogue the item comes from. EN 16931 has no catalogue reference on a line. It does have a contract reference (BT-12) and a purchase order number (BT-13) for the whole invoice, and a purchase order line reference (BT-132) on a line.

Why it matters

EN 16931 does not use catalogue document reference blocks within a line's item.

How to fix it

Check whether your invoicing software exports a catalogue reference for each product, and adjust the export mapping to omit it. If the buyer asked for the catalogue reference, put it in the line note (BT-127), not the purchase order number field. If you build the XML yourself, delete cac:CatalogueDocumentReference from cac:InvoiceLine/cac:Item (cac:CreditNoteLine in a credit note).

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 should not include the InvoiceLine Item CatalogueDocumentReference

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-589 still fails, and which other rules do.

Updated 6 November 2026