Fix BR-57: Deliver to address without country code

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

What does BR-57 mean?

The rule checks the Deliver to address of the goods recipient (BG-15). In CII it sits in ram:ShipToTradeParty/ram:PostalTradeAddress. If you give a Deliver to address, the Deliver to country code (BT-80, ram:CountryID) must be present. The code follows the two-letter ISO 3166-1 alpha-2 standard, for example "DE". Without a country code you cannot assign the place of delivery to one country.

Common causes of BR-57

ram:CountryID is missing from ram:PostalTradeAddress of the Deliver to address.
Only street, city and post code are given, the country is missing.
The country name appears as free text instead of a two-letter ISO code.
ram:PostalTradeAddress was created without a country although a goods recipient is named.

How to fix BR-57

Find the faulty spot in the XML. Open the XML of the invoice and go to field BT-80 along this XPath://rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:ApplicableHeaderTradeDelivery/ram:ShipToTradeParty/ram:PostalTradeAddress/ram:CountryID
Apply the fix. Add the element ram:CountryID with the two-letter ISO 3166-1 code (e.g. "DE") to ram:ShipToTradeParty/ram:PostalTradeAddress.
Validate again. Save the file and validate it again to check that BR-57 is no longer reported.

Concrete fix

Add the element ram:CountryID with the two-letter ISO 3166-1 code (e.g. "DE") to ram:ShipToTradeParty/ram:PostalTradeAddress.

XPath

//rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:ApplicableHeaderTradeDelivery/ram:ShipToTradeParty/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:ShipToTradeParty>
  <ram:Name>Beispiel AG - Lager Nord</ram:Name>
  <ram:PostalTradeAddress>
    <ram:PostcodeCode>20095</ram:PostcodeCode>
    <ram:LineOne>Hafenstraße 5</ram:LineOne>
    <ram:CityName>Hamburg</ram:CityName>
  </ram:PostalTradeAddress>
</ram:ShipToTradeParty>

Correct

<ram:ShipToTradeParty>
  <ram:Name>Beispiel AG - Lager Nord</ram:Name>
  <ram:PostalTradeAddress>
    <ram:PostcodeCode>20095</ram:PostcodeCode>
    <ram:LineOne>Hafenstraße 5</ram:LineOne>
    <ram:CityName>Hamburg</ram:CityName>
    <ram:CountryID>DE</ram:CountryID>
  </ram:PostalTradeAddress>
</ram:ShipToTradeParty>

Frequent questions about BR-57

What format does the country code use?

Two capital letters per ISO 3166-1 alpha-2, for example "DE" for Germany or "AT" for Austria. No plain country name.

When is the Deliver to address mandatory?

The Deliver to address itself is optional. But as soon as you give one, the country code BT-80 must be present.

Is CountryID enough or do I also need street and city?

Only the country code counts for this rule. Further address parts such as street and city make sense, but they do not trigger this error.

Related error codes

Check BR-57 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