Skip to content

Error

FX-SCH-A-000389: The document language code must be on the allowed list

In short

Error: fails the selected checks.

FX-SCH-A-000389 means the document language in ram:LanguageID has a non-empty value outside the Extended profile's allowed language list. Replace it with an allowed code for the document's language, then export and recheck the file.

On this page

What it means

In the Extended profiles of Factur-X and ZUGFeRD, this rule checks ram:LanguageID directly under rsm:ExchangedDocument. A non-empty value must match the profile's language code list. An empty value passes this particular check.

Why it matters

An agreed language code lets software identify the document's declared language consistently.

How to fix it

Check the document language in your invoice data or XML export. Use the appropriate code from the Extended profile's language list rather than a written-out language name. The XML element is ram:LanguageID under rsm:ExchangedDocument, not ram:ExchangedDocument. If your software writes an unsupported value, ask its supplier to correct the mapping. 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

Value of 'ram:LanguageID' is not allowed.

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

Updated 6 November 2026