Skip to content

Error

FX-SCH-A-000383: A financial adjustment needs exactly one reason

In short

Error: fails the selected checks.

FX-SCH-A-000383 means a financial adjustment in the invoice's header settlement has either no ram:Reason element or more than one. Give each adjustment exactly one ram:Reason element explaining the adjustment, then export and recheck the file.

On this page

What it means

In the Extended profiles of Factur-X and ZUGFeRD, each ram:SpecifiedFinancialAdjustment under ram:ApplicableHeaderTradeSettlement must contain exactly one ram:Reason element. This rule counts the elements; it does not check their text.

Why it matters

A single reason element keeps the explanation for each financial adjustment in one place.

How to fix it

Check the reason for each financial adjustment. In the XML, add the missing ram:Reason or remove duplicate reason elements so that each ram:SpecifiedFinancialAdjustment contains exactly one. If your invoicing software creates the missing or duplicate elements, ask its supplier to correct the export. Export and 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

Element 'ram:Reason' 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-000383 still fails, and which other rules do.

Updated 6 November 2026