Skip to content

Error

FX-SCH-A-000954: Each advance payment tax entry needs one category element

In short

Error: fails the selected checks.

FX-SCH-A-000954 means an advance payment tax entry contains no ram:CategoryCode element or more than one. Add the missing element or remove duplicates so that the entry contains exactly one category element.

On this page

What it means

For each ram:SpecifiedAdvancePayment/ram:IncludedTradeTax, this rule counts ram:CategoryCode child elements. It requires exactly one element, but does not check its value. FX-SCH-A-000955 separately checks non-empty category codes against the permitted list.

Why it matters

The category records the tax treatment described by each entry.

How to fix it

Check ram:CategoryCode in each advance payment tax entry. Add one element if it is missing, or remove duplicates while keeping the appropriate category. For VAT, S covers positive-rate VAT, including reduced rates, while Z identifies zero-rated VAT. 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 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-000954 still fails, and which other rules do.

Updated 6 November 2026