Rule reference

BR-DE-9 XRechnung requires the element "Buyer post code" (BT-53)

XRechnung requires the element "Buyer post code" (BT-53). 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.

This rule is implemented and its error payload below is real, but the long-form write-up — normative text, worked example, divergence note — is not written yet. Everything the library knows about this rule is on this page. Ask and we will prioritise it.

Business term
BT-53
Severity
fatal

What the library returns

The exact object in result.errors when this rule fires. Generated by running @attestwire/en16931, not transcribed:

TeachingError
{
  "rule": "BR-DE-9",
  "field": "BT-53",
  "severity": "fatal",
  "message": "XRechnung requires the element \"Buyer post code\" (BT-53). 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.postalCode.",
  "example": "\"postalCode\": \"10115\"",
  "xpath": "/ubl:Invoice/cac:AccountingCustomerParty/cac:Party/cac:PostalAddress/cbc:PostalZone",
  "docsUrl": "https://attestwire.com/rules/BR-DE-9"
}

xpath locates the element in the generated UBL document, which is where a KoSIT or Peppol validator will report the same problem.

A passing value

the shape this field expects
"postalCode": "10115"

The fix

Set buyer.address.postalCode.

Arrived from a stack trace? The docsUrl on every error links straight here. Something wrong on this page — tell us.