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

BR-11 in your own invoice? Upload the file and find every error in seconds.

Check invoice Get an API key

What does BR-11 mean?

The Buyer postal address must name the country under ISO 3166-1. The country drives tax and reporting duties.

Common causes of BR-11

The element 'ram:CountryID' is missing entirely from the Buyer postal address.
The country was given as plain text (for example 'Germany') instead of an ISO code.
The address came from a legacy system without a structured country.

How to fix BR-11

Find the faulty spot in the XML. Open the XML of the invoice and go to field BT-55 along this XPath://ram:ApplicableHeaderTradeAgreement/ram:BuyerTradeParty/ram:PostalTradeAddress/ram:CountryID
Apply the fix. Add the Buyer country code (BT-55) in the element 'ram:CountryID' of the Buyer postal address. Use a two-letter code under ISO 3166-1 alpha-2, for example 'DE' for Germany.
Validate again. Save the file and validate it again to check that BR-11 is no longer reported.

Concrete fix

Add the Buyer country code (BT-55) in the element 'ram:CountryID' of the Buyer postal address. Use a two-letter code under ISO 3166-1 alpha-2, for example 'DE' for Germany.

XPath//ram:ApplicableHeaderTradeAgreement/ram:BuyerTradeParty/ram:PostalTradeAddress/ram:CountryID

Before / after: the XML example

This is the spot in question before and after the fix (Cross Industry Invoice, ZUGFeRD/Factur-X).

Wrong

<ram:BuyerTradeParty>
  <ram:PostalTradeAddress>
    <ram:CityName>Berlin</ram:CityName>
  </ram:PostalTradeAddress>
</ram:BuyerTradeParty>

Correct

<ram:BuyerTradeParty>
  <ram:PostalTradeAddress>
    <ram:CityName>Berlin</ram:CityName>
    <ram:CountryID>DE</ram:CountryID>
  </ram:PostalTradeAddress>
</ram:BuyerTradeParty>

Frequent questions about BR-11

What format does the country code need?

A two-letter code under ISO 3166-1 alpha-2, so 'DE', 'AT', 'FR' and so on. Plain text such as 'Germany' is not allowed.

Must the Buyer always have an address with a country?

Yes. Every invoice under EN 16931 needs a Buyer postal address, and the country is a mandatory field within it.

Related error codes

Check BR-11 automatically

Instead of digging through the XML by hand you can validate your ZUGFeRD or XRechnung file online – upload the PDF or the XML and you get every error with rule ID, affected field, fix and XPath, as a readable report or as JSON through the API.

Validate online now Back to the lexicon