BR-Z-10 — E-Invoice Validation Rule & Fix

Fixture ID: reasonOnZero · XPath: /ubl:Invoice/cac:TaxTotal/cac:TaxSubtotal/cac:TaxCategory/cbc:TaxExemptionReason

1. Why This Rule Triggers (Diagnostic Message)

A VAT breakdown with the VAT category code (BT-118) Z (Zero rated) must not have a VAT exemption reason code (BT-121) or reason text (BT-120), but you supplied vatExemptionReasons.Z = "no VAT". Zero rating is a rate, not an exemption — the supply is inside the VAT system and taxed at 0%, so no reason is due. BR-Z-10 is fatal at document level; this finding is a warning because the library drops the value rather than emitting it, so the generated XML still passes — but your intent was silently discarded, which you should know about.

2. How to Fix BR-Z-10

Remove the "Z" entry from vatExemptionReasons. If you need to say something to the buyer about this line, use the invoice note (BT-22) or the line note (BT-127), which carry free text without making a VAT claim.

3. Valid Code / Payload Example

"vatExemptionReasons": { }, "lines": [{ "id": "1", "description": "Beratung", "quantity": 1, "unitCode": "C62", "unitPrice": 100, "vatCategory": "Z", "vatRate": 0 }]