Skip to content

BR-DE-8: Buyer city (BT-52) is missing

Official message

[BR-DE-8] Das Element "Buyer city" (BT-52) muss übermittelt werden.

XRechnung (CII) · Error · Message language: German · Version: xrechnung-3.0.2-validator-configuration-2026-08-31

[BR-DE-8] Das Element "Buyer city" (BT-52) muss übermittelt werden.

XRechnung (UBL) · Error · Message language: German · Version: xrechnung-3.0.2-validator-configuration-2026-08-31
Severity
Error The invoice is invalid and may be rejected by the recipient.
Applies to
XRechnung (CII), XRechnung (UBL)
Affected fields
BT-52

What does this mean?

The buyer's postal address must contain the city (Buyer city, BT-52). The element is missing or contains only spaces.

Typical causes

The buyer's city field was left empty.
Post code and city were entered together in another field, e.g. the street or an additional address line.

How to fix the error

Enter the city in the buyer's postal address (CII: ram:BuyerTradeParty/ram:PostalTradeAddress/ram:CityName, UBL: cac:AccountingCustomerParty/cac:Party/cac:PostalAddress/cbc:CityName).
Put post code and city into their own elements.
Generate and validate the invoice again.

In E-Rechnungsfreund

In the invoice form, section "Käufer (BG-7)" (buyer), fill in the field "Stadt (BT-37/52)".

Example

Wrong

<ram:BuyerTradeParty>
  <ram:Name>Stadt Musterhausen</ram:Name>
  <ram:PostalTradeAddress>
    <ram:PostcodeCode>12345</ram:PostcodeCode>
    <ram:CountryID>DE</ram:CountryID>
  </ram:PostalTradeAddress>
</ram:BuyerTradeParty>

Correct

<ram:BuyerTradeParty>
  <ram:Name>Stadt Musterhausen</ram:Name>
  <ram:PostalTradeAddress>
    <ram:PostcodeCode>12345</ram:PostcodeCode>
    <ram:CityName>Musterhausen</ram:CityName>
    <ram:CountryID>DE</ram:CountryID>
  </ram:PostalTradeAddress>
</ram:BuyerTradeParty>
For developers: test expression per syntax

XRechnung (CII) (CII)

Context: /rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:ApplicableHeaderTradeAgreement/ram:BuyerTradeParty/ram:PostalTradeAddress

ram:CityName[boolean(normalize-space(.))]

XRechnung (UBL) (UBL)

Context: /ubl:Invoice/cac:AccountingCustomerParty/cac:Party/cac:PostalAddress | /cn:CreditNote/cac:AccountingCustomerParty/cac:Party/cac:PostalAddress

cbc:CityName[boolean(normalize-space(.))]

Related validation rules

  • BR-DE-1: Payment instructions (BG-16) are missing
  • BR-DE-10: Deliver to city (BT-77) is missing
  • BR-DE-11: Deliver to post code (BT-78) is missing
  • BR-DE-14: VAT category rate (BT-119) is missing in the VAT breakdown
  • BR-DE-15: Buyer reference (BT-10) is missing
  • BR-DE-16: Seller VAT ID, tax number or tax representative is missing

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