Skip to content

Error

FX-SCH-A-000917: The payee's address needs a valid country code

In short

Error: fails the selected checks.

FX-SCH-A-000917 means a non-empty country code in the payee's postal address is not on the profile's allowed list. Correct ram:CountryID to the code for that address's country.

On this page

What it means

The check applies to ram:PayeeTradeParty/ram:PostalTradeAddress/ram:CountryID. A non-empty value must match the profile's allowed country code list. An empty value does not fail this rule; it does not check how many country elements are present.

Why it matters

The shared country code list lets software interpret the payee's country consistently without relying on country names in different languages.

How to fix it

Correct ram:CountryID in the payee's postal address. Use the appropriate two-letter country code in capitals from the allowed list, such as DE, FR, NL or BE. Do not use a country name or a three-letter code such as DEU. Regenerate and recheck your 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:CountryID' 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-000917 still fails, and which other rules do.

Updated 6 November 2026