Skip to content

Error

FX-SCH-A-000167: The buyer's address can have at most one region field

In short

Error: fails the selected checks.

FX-SCH-A-000167 means your buyer's postal address contains more than one country subdivision element (BT-54, ram:CountrySubDivisionName). Put the intended state, province, region or county in one element, or omit it if unnecessary, then export and recheck the file.

On this page

What it means

Within the buyer's postal address (BG-8, ram:BuyerTradeParty/ram:PostalTradeAddress), this test allows at most one ram:CountrySubDivisionName (BT-54). It does not require the field or check its text. It applies to the Basic WL, Basic, EN 16931 and Extended profiles of Factur-X 1.09 and ZUGFeRD 2.5.

Why it matters

A single country subdivision field keeps this part of your buyer's address together rather than spreading it across repeated XML elements.

How to fix it

Check how your buyer's country subdivision is exported. Keep the correct address information in one ram:CountrySubDivisionName inside the buyer's ram:PostalTradeAddress. If separate address fields produce repeated elements, correct the export mapping rather than deleting necessary address details. If the subdivision is unnecessary, omit the element. Export again 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:CountrySubDivisionName' may occur at maximum 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-000167 still fails, and which other rules do.

Updated 6 November 2026