Skip to content
Change language: English

Warning

UBL-DT-28: Leave the listAgencyID attribute out of the invoice

In short

Warning: worth checking.

UBL-DT-28 means the UBL file contains a listAgencyID attribute, which the e-invoice standard does not use. It is only a warning, but you can fix it by removing that attribute from your export.

On this page

What it means

The rule searches the whole file for an attribute called listAgencyID. In UBL it can be added to a code, such as the invoice type code or the payment means code, to name the organisation that maintains the code list, for example UN/ECE. EN 16931 and Peppol already fix which code lists are used, so the attribute should not appear anywhere in the invoice. One occurrence anywhere is enough to trigger the warning.

Why it matters

EN 16931 says you should leave the listAgencyID attribute out of UBL invoices and credit notes.

How to fix it

You normally do not set this attribute yourself. Your invoicing software adds it when it writes the file, so look for an export setting or a newer version, or ask the software supplier to stop writing it. If you build the XML yourself, search the file for listAgencyID and delete only that attribute, then check the file again. Leave other attributes alone, such as listID on an item classification code, which the invoice may need. It is worth fixing the next time you change your export, and sooner if a recipient asks for a file without warnings.

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

List Agency ID attribute should not be present

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

Updated 6 November 2026