Skip to content
Change language: English

Error

FX-SCH-A-000297: Use an allowed classification scheme code

In short

Error: fails the selected checks.

FX-SCH-A-000297 means a non-empty classification scheme identifier (BT-158-1) in the listID attribute of ram:ClassCode is not in the EN 16931 profile's permitted list. Replace it with the allowed identifier for the scheme your item classification code (BT-158) actually uses, then export and recheck the file.

On this page

What it means

For the EN 16931 profile of Factur-X and ZUGFeRD, this test accepts an empty scheme identifier or a value found in code list 6 of FACTUR-X_EN16931_codedb.xml. FX-SCH-A-000296 separately checks whether the listID attribute exists. An empty attribute therefore does not fail either of these two tests by itself.

Why it matters

The scheme identifier tells the reader which classification system gives the item code its meaning. A non-empty identifier must match an entry in the profile's permitted list.

How to fix it

Identify the classification system your item code comes from, then use its exact permitted identifier in ram:ClassCode/@listID. Do not choose an unrelated scheme merely to clear the error. If the classification was included by mistake, remove that classification entry. Export and recheck the file.

Once the file is corrected, check it again for free: Validate a ZUGFeRD invoice

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

The rule as published

Value of '@listID' is not allowed.

Where this rule applies

Rule set Version
Factur-X 1.09 EN 16931 1.0.9-2
ZUGFeRD 2.5 EN 16931 2.5.2
Rule text from phive-rules 4.6.4.

Check your file

Drop your e-invoice to see whether FX-SCH-A-000297 still fails, and which other rules do.

Updated 6 November 2026