Skip to content

Error

FX-SCH-A-000508: Use an allowed VAT category code

In short

Error: fails the selected checks.

FX-SCH-A-000508 means a VAT category code (BT-118) in the VAT breakdown (BG-23) is not allowed by the Basic profiles of Factur-X and ZUGFeRD. Replace it with the listed category matching the transaction's VAT treatment, not a VAT percentage or a custom label.

On this page

What it means

This rule checks a non-empty category code against the profile's list. S covers standard-rated VAT, including reduced rates; Z means zero-rated; E means exempt from VAT; AE means reverse charge; K means intra-community supply; G means export outside the EU; and O means outside the scope of VAT. L and M identify the special tax categories for the Canary Islands and for Ceuta and Melilla respectively. This test does not establish whether the chosen tax treatment is correct.

Why it matters

The category identifies the tax treatment represented by each VAT breakdown row.

How to fix it

Correct ram:CategoryCode within ram:ApplicableHeaderTradeSettlement/ram:ApplicableTradeTax. Use the appropriate listed code, preserving its capitalisation. Check any software mapping from your own tax labels to these categories, including L or M where applicable. Review related lines, discounts and charges for consistency, then 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 'ram:CategoryCode' is not allowed.

Where this rule applies

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

Check your file

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

Updated 6 November 2026