Skip to content

Error

FX-SCH-A-000587: Use a listed VAT breakdown category

In short

Error: fails the selected checks.

FX-SCH-A-000587 means a VAT breakdown row (BG-23) in your Factur-X or ZUGFeRD invoice contains an unlisted VAT category code (BT-118). Correct the code to match that row's VAT treatment, using S, Z, E, AE, K, G, O, L or M, then recheck your invoice.

On this page

What it means

This rule checks a non-empty ram:CategoryCode under ram:ApplicableHeaderTradeSettlement/ram:ApplicableTradeTax against the EN 16931 profile's VAT category list. The allowed codes are S, Z, E, AE, K, G, O, L and M. An empty value does not fail this test; required fields, rates and calculations are checked separately.

Why it matters

The category identifies the VAT treatment represented by a breakdown row. A permitted code still needs to match the supplies and amounts included in that row.

How to fix it

Correct the VAT category of the affected header VAT breakdown row, not just a line's displayed VAT rate. If your software builds the breakdown from lines, discounts or charges, correct the relevant source data and regenerate it. In CII XML, the affected field is ram:ApplicableHeaderTradeSettlement/ram:ApplicableTradeTax/ram:CategoryCode. Export and recheck your invoice.

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 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-000587 still fails, and which other rules do.

Updated 6 November 2026