UBL-DT-27: Leave the schemeAgencyID attribute out of the invoice

What it means

The rule searches the whole file for an attribute called schemeAgencyID. In UBL it can be added to an identifier, such as an electronic address (BT-34, BT-49) or a company registration number (BT-30, BT-47, BT-61), to name the organisation that maintains the identification scheme. EN 16931 and Peppol name the scheme with schemeID instead, so schemeAgencyID 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 schemeAgencyID 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 schemeAgencyID and delete only that attribute, then check the file again. Keep schemeID where the identifier needs it. It is worth fixing the next time you change your export, and sooner if a recipient asks for a file without warnings.

The rule as published

Scheme Agency ID attribute should not be present

Where this rule applies