BR-33 — E-Invoice Validation Rule & Fix

Fixture ID: allowanceEmpty · XPath: /ubl:Invoice/cac:AllowanceCharge[1]/cbc:AllowanceChargeReason

1. Why This Rule Triggers (Diagnostic Message)

The document level allowance at allowances[0] states neither a reason (BT-97) nor a reason code (BT-98); both are empty. Every BG-20 group must carry at least one of them, because an unexplained deduction from an invoice total is the single most disputed thing on a commercial document — the buyer's accounts-payable clerk has to decide whether to approve it, and "−missing" on its own gives them nothing to decide on.

2. How to Fix BR-33

Set allowances[0].reason to a short description in the invoice language, or allowances[0].reasonCode to a UNCL 5189 code, or both. Under XRechnung, prefer the free text: the mandated visualisation renders the code verbatim, so a buyer looking at the rendered invoice sees the bare code and not what it means.

3. Valid Code / Payload Example

"allowances": [{ "amount": 25.00, "vatCategory": "S", "vatRate": 19, "reason": "Discount", "reasonCode": "95" }]