Skip to content

Error

FX-SCH-A-001117: The final recipient's address needs one country element

In short

Error: fails the selected checks.

FX-SCH-A-001117 means the final recipient's postal address on your invoice line contains no ram:CountryID element or contains more than one. Add the missing country element or remove extra country elements within that address.

On this page

What it means

For each ram:PostalTradeAddress under the line's ram:SpecifiedLineTradeDelivery/ram:UltimateShipToTradeParty, the check requires one ram:CountryID child. It checks the element count, not the country code's value or the number of address blocks.

Why it matters

The Extended profile requires one country element within each of these postal addresses. Missing or repeated country elements do not meet that structure.

How to fix it

Check ram:CountryID inside the affected final recipient's ram:PostalTradeAddress. Keep exactly one country element containing the correct country code, such as DE or FR. Remove extra ram:CountryID elements within that address, rather than deleting an address merely because it is repeated. 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:CountryID' 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-001117 still fails, and which other rules do.

Updated 6 November 2026