einvoice / EN 16931 / XRechnung rule reference

BR-CO-21

Each Document level allowance (BG-20) shall contain a Document level allowance reason (BT-97) or a Document level allowance reason code (BT-98), or both.

Jeder NACHLASS AUF DOKUMENTENEBENE (BG-20) muss einen Grund für den Nachlass auf Dokumentenebene (BT-97) oder einen Code für den Grund des Nachlasses auf Dokumentenebene (BT-98) oder beides enthalten.

Deutsche Fassung: Übersetzung der gleichen BT/BG-Semantik (translation — not the official assert).

Requires: Each Document level allowance (BG-20) shall contain a Document level allowance reason (BT-97) or a Document level allowance reason code (BT-98), or both.
Business terms: BG-20 BT-97 BT-98
Syntax: Binds the UBL-2.1 Invoice / CreditNote syntax and the UN/CEFACT-CII syntax
Location (UBL-2.1 path): /ubl:Invoice/cac:AllowanceCharge[cbc:ChargeIndicator = false()]
Fix: Add the required element at `/ubl:Invoice/cac:AllowanceCharge[cbc:ChargeIndicator = false()]`: Each Document level allowance (BG-20) shall contain a Document level allowance reason (BT-97) or a Document level allowance reason code (BT-98), or both.
Fix (Deutsch): Ergänzen Sie das erforderliche Element bei `/ubl:Invoice/cac:AllowanceCharge[cbc:ChargeIndicator = false()]`: Jeder NACHLASS AUF DOKUMENTENEBENE (BG-20) muss einen Grund für den Nachlass auf Dokumentenebene (BT-97) oder einen Code für den Grund des Nachlasses auf Dokumentenebene (BT-98) oder beides enthalten.
Severity: fatal
Provenance source: en16931-ubl
Provenance assert: Each Document level allowance (BG-20) shall contain a Document level allowance reason (BT-97) or a Document level allowance reason code (BT-98), or both.

The Location above is a UBL-2.1 path, and no UN/CEFACT-CII path for this rule is published here; Fix and Fix (Deutsch), verbatim from remediation_catalog.json and not reworded here; the UN/CEFACT-CII binding of this rule is differentially proven against the official CEN EN 16931 1.3.16 Schematron.

Everything here is free and open source — pick up whatever helps, at your own pace:

Licensing — Apache-2.0 for everyone, including closed-source embedding; an optional $29 / $290 commercial license adds support and rule-corpus update notices.
German remediation (--lang de) — the German fix for this rule is in the section above; the CLI surfaces it in place of the English message with --lang de.
Quickstart / free on-ramp — the README, a copy-paste CI-gate recipe, and a 5-minute worked walkthrough.

Rendered verbatim from remediation_catalog.json (single source of truth); regenerate with gen_site.py. This page is self-contained and opens offline with no network requests.