Skip to content

BR-11: Buyer country code (BT-55) is missing

Official message

[BR-11] The Buyer postal address shall contain a Buyer country code (BT-55).

EN 16931 (CII) · Error · Message language: English · Version: xrechnung-3.0.2-validator-configuration-2026-08-31

[BR-11] The Buyer postal address shall contain a Buyer country code (BT-55).

EN 16931 (UBL) · Error · Message language: English · Version: xrechnung-3.0.2-validator-configuration-2026-08-31

[BR-11] The Buyer postal address shall contain a Buyer country code (BT-55).

Factur-X / ZUGFeRD EN 16931 · Error · Message language: English · Version: Factur-X 1.08 / ZUGFeRD 2.4
Severity
Error The invoice is invalid and may be rejected by the recipient.
Applies to
EN 16931 (CII), EN 16931 (UBL), Factur-X / ZUGFeRD EN 16931
Affected fields
BT-55

What does this mean?

The buyer postal address (BG-8) must contain a country code (Buyer country code, BT-55). The element is missing or empty.

Typical causes

The buyer's country was not selected.
The country appears as a name in the city or an address line instead of as a code.

How to fix the error

Enter the two-letter ISO 3166-1 alpha-2 country code, e.g. DE for Germany or FR for France.
CII: ram:BuyerTradeParty/ram:PostalTradeAddress/ram:CountryID, UBL: cac:AccountingCustomerParty/cac:Party/cac:PostalAddress/cac:Country/cbc:IdentificationCode.
Generate and validate the invoice again.

In E-Rechnungsfreund

In the invoice form, section "Käufer (BG-7)" (buyer), select the country in the field "Land (BT-40/55)".

Example

Wrong

<ram:PostalTradeAddress>
  <ram:PostcodeCode>80331</ram:PostcodeCode>
  <ram:LineOne>Beispielweg 5</ram:LineOne>
  <ram:CityName>München</ram:CityName>
</ram:PostalTradeAddress>

Correct

<ram:PostalTradeAddress>
  <ram:PostcodeCode>80331</ram:PostcodeCode>
  <ram:LineOne>Beispielweg 5</ram:LineOne>
  <ram:CityName>München</ram:CityName>
  <ram:CountryID>DE</ram:CountryID>
</ram:PostalTradeAddress>
For developers: test expression per syntax

EN 16931 (CII) (CII)

Context: /rsm:CrossIndustryInvoice

normalize-space(rsm:SupplyChainTradeTransaction/ram:ApplicableHeaderTradeAgreement/ram:BuyerTradeParty/ram:PostalTradeAddress/ram:CountryID) != ''

EN 16931 (UBL) (UBL)

Context: cac:AccountingCustomerParty/cac:Party/cac:PostalAddress

normalize-space(cac:Country/cbc:IdentificationCode) != ''

Factur-X / ZUGFeRD EN 16931 (CII)

Technical ID in the source: FX-SCH-A-000157

Context: /rsm:CrossIndustryInvoice

//ram:BuyerTradeParty/ram:PostalTradeAddress/ram:CountryID!=''

Related validation rules

  • BR-01: Specification identifier (BT-24) is missing
  • BR-02: Invoice number (BT-1) is missing
  • BR-03: Invoice issue date (BT-2) is missing
  • BR-04: Invoice type code (BT-3) is missing
  • BR-05: Invoice currency code (BT-5) is missing
  • BR-06: Seller name (BT-27) is missing

Last updated:
Explanation of the validation rule, not legal or tax advice.