AttestwireRule referenceBR-DE-3

BR-DE-3 XRechnung requires the seller city

noun · XRechnung · fatal · BT-37

For a sample invoice, the library reports: XRechnung requires the element "Seller city" (BT-37). 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.

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

Business term
BT-37
Severity
fatal

The fix

Set seller.address.city.

A passing value

the shape this field expects
"city": "Berlin"

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:

TeachingError
{
  "rule": "BR-DE-3",
  "field": "BT-37",
  "severity": "fatal",
  "message": "XRechnung requires the element \"Seller city\" (BT-37). 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 seller.address.city.",
  "example": "\"city\": \"Berlin\"",
  "xpath": "/ubl:Invoice/cac:AccountingSupplierParty/cac:Party/cac:PostalAddress/cbc:CityName",
  "docsUrl": "https://attestwire.com/rules/BR-DE-3"
}

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