Skip to content
Change language: English

Error

FX-SCH-A-000478: Each whole-invoice charge needs one amount

In short

Error: fails the selected checks.

FX-SCH-A-000478 means a charge on the whole invoice (BG-21) has no ram:ActualAmount element or has more than one. Give the charge one amount excluding VAT (BT-99), then export and recheck your file.

On this page

What it means

Each ram:SpecifiedTradeAllowanceCharge under ram:ApplicableHeaderTradeSettlement whose ram:ChargeIndicator/udt:Indicator is true must contain one ram:ActualAmount. This rule counts the elements; it does not check their values.

Why it matters

The charge amount (BT-99) states how much the charge contributes to the invoice totals before VAT.

How to fix it

Correct the affected charge's amount excluding VAT in your invoicing software. In XML, add ram:ActualAmount if it is missing, or remove duplicate elements after checking which amount is correct. Keep one directly inside the charge's ram:SpecifiedTradeAllowanceCharge, 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:ActualAmount' 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-000478 still fails, and which other rules do.

Updated 6 November 2026