Skip to content

Error

FX-SCH-A-000481: Each whole-invoice charge needs one VAT category

In short

Error: fails the selected checks.

FX-SCH-A-000481 means a tax details block for a charge on the whole invoice (BG-21) has no VAT category code element (BT-102) or has more than one. Keep one ram:CategoryCode for that block, then export and recheck.

On this page

What it means

Each ram:CategoryTradeTax within a header ram:SpecifiedTradeAllowanceCharge whose ram:ChargeIndicator/udt:Indicator is true must contain one ram:CategoryCode. The rule counts elements; it does not check whether the code is filled in or allowed.

Why it matters

The VAT category identifies the charge's VAT treatment and connects it to the relevant part of the VAT breakdown.

How to fix it

Set the affected charge's correct VAT category in your invoicing software. In XML, keep one ram:CategoryCode inside the charge's ram:CategoryTradeTax, adding it if missing or removing duplicates. Use the category that applies to the charge, then export 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

Element 'ram:CategoryCode' must occur exactly 1 times.

Where this rule applies

Rule set Version
Factur-X 1.09 BASIC WL 1.0.9-2
Factur-X 1.09 BASIC 1.0.9-2
Factur-X 1.09 EN 16931 1.0.9-2
Factur-X 1.09 EXTENDED 1.0.9-2
ZUGFeRD 2.5 BASIC WL 2.5.2
ZUGFeRD 2.5 BASIC 2.5.2
ZUGFeRD 2.5 EN 16931 2.5.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-000481 still fails, and which other rules do.

Updated 6 November 2026