Skip to content

Error

FX-SCH-A-001128: Tax category code on a line must be allowed

In short

Error: fails the selected checks.

FX-SCH-A-001128 means a non-empty tax category code in an invoice line's ram:ApplicableTradeTax is not allowed. For VAT, correct the line's VAT category code (BT-151) using the permitted code for the transaction.

On this page

What it means

Each non-empty ram:CategoryCode under the line's ram:SpecifiedLineTradeSettlement/ram:ApplicableTradeTax must match code list 24. An empty value passes. The XPath does not restrict this check to a particular tax type, and the test does not establish whether the chosen category fits the transaction.

Why it matters

A recognised category code lets software interpret the tax treatment stated for the line.

How to fix it

Correct ram:CategoryCode in the affected line's ram:ApplicableTradeTax. For VAT, examples include S for standard rate, Z for zero rate, E for exempt from VAT and AE for reverse charge. Choose the permitted category that reflects the transaction rather than changing it merely to clear the error. Export again and recheck.

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 'ram:CategoryCode' is not allowed.

Where this rule applies

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

Check your file

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

Updated 6 November 2026