Attestwire › Rule reference › BR-DE-8

BR-DE-8 XRechnung requires the buyer city

noun · XRechnung · fatal · BT-52

Your invoice was refused because your customer’s address has no city. An XRechnung needs a city and a post code for both seller and buyer, while core EN 16931 is satisfied by the country code alone. Add the city to the customer record. In the standard the field is BT-52, and BR-DE-8 is the rule that requires it.

Diese Regel auf Deutsch: BR-DE-8 — auf Deutsch erklärt.

Business term

BT-52 — Buyer city

Severity

fatal

Applies to

xrechnung-ubl, xrechnung-cii

The fix

Set buyer.address.city to your customer’s city, for example "Berlin".

What the rule requires

Set the buyer city (BT-52). It is the same requirement as the seller’s in BR-DE-3, on the other side of the invoice.

A practical note: the buyer address comes from your customer master data, and for a public-sector customer that record often holds only the authority’s name. Add city and post code to the master record once, rather than patching every invoice.

In this library the field is buyer.address.city.

Das Element "Buyer city" (BT-52) muss übermittelt werden.

A passing value

"city": "Berlin"

Why it exists

The address of the recipient of the supply is a mandatory item on an invoice under §14 UStG, and it has to be complete. For a public authority the address is also what assigns the invoice to the right office when anything else is in doubt.

What the library returns

The full error returned by @attestwire/en16931. It includes the rule ID, affected field and suggested correction. Developers can use this object in their application:

{
  "rule": "BR-DE-8",
  "field": "BT-52",
  "severity": "fatal",
  "message": "XRechnung requires the element \"Buyer city\" (BT-52). Core EN 16931 only requires the country code, but the German CIUS additionally makes city and post code mandatory on both parties so that the address is deliverable, not merely jurisdictional.",
  "fix": "Set buyer.address.city.",
  "example": "\"city\": \"Berlin\"",
  "xpath": "/ubl:Invoice/cac:AccountingCustomerParty/cac:Party/cac:PostalAddress/cbc:CityName",
  "docsUrl": "https://attestwire.com/rules/BR-DE-8"
}

xpath is always a UBL path. On a CII invoice, look for the matching CII field instead.

How our check differs

See also: BR-DE-9 — the buyer post code; BR-DE-3 — the same requirement for the seller.