Skip to content

Error

FX-SCH-A-000511: Use VAT as the tax type code

In short

Error: fails the selected checks.

FX-SCH-A-000511 means the tax type code in the VAT breakdown (BG-23) is not VAT, the value required here by the Basic profiles of Factur-X and ZUGFeRD. Set this field to VAT in capitals.

On this page

What it means

This rule checks a non-empty ram:TypeCode within ram:ApplicableHeaderTradeSettlement/ram:ApplicableTradeTax against the profile's tax type list. This field identifies the tax type, not its category or rate. This test does not check whether the element is present.

Why it matters

The type code identifies the tax represented by the breakdown row.

How to fix it

Set ram:TypeCode within ram:ApplicableHeaderTradeSettlement/ram:ApplicableTradeTax to VAT. Do not put a local tax name, a VAT rate or a category such as S or AE in this field. If you cannot control the exported value, give this XML field and rule id to your software supplier. Recheck the corrected 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:TypeCode' 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-000511 still fails, and which other rules do.

Updated 6 November 2026