Skip to content

Warning

UBL-CR-588: Additional item identifiers are not used on invoice lines

In short

Warning: worth checking.

UBL-CR-588 means an invoice or credit note line carries an additional item identification (cac:AdditionalItemIdentification), which EN 16931 does not use. It is a warning. Move the value into the seller's, buyer's or standard item identifier if it fits one of them, or remove 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:AdditionalItemIdentification block. EN 16931 has three item identifiers: the seller's (BT-155), the buyer's (BT-156) and the standard one (BT-157). This warning applies whenever cac:AdditionalItemIdentification is present, even if those other identifiers are absent.

Why it matters

EN 16931 does not use additional item identification blocks on invoice or credit note lines.

How to fix it

Decide what the extra number is. Your own article number goes in the seller's item identifier, the buyer's article number goes in the buyer's item identifier, and a GTIN or similar code goes in the standard identifier with its scheme. A code that groups items belongs in the item classification identifier (BT-158). In the XML, move the value first if it belongs in one of those fields, then delete cac:AdditionalItemIdentification 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 AdditionalItemIdentification

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

Updated 6 November 2026