BR-32: an error that rejects the invoice

Official text (the SDK's own message)

Each Document level allowance (BG-20) shall have a Document level allowance VAT category code (BT-95).

Error · Source: ZATCA E-Invoicing SDK 238-R3.3.8 · Electronic Invoice XML Implementation Standard v1.2, 19 May 2023, §13.2.1, p. 37 · Checked: 26 October 2026

What it means

BR-32 is one of the validation rules for the e-invoice. An error: the invoice is rejected, so fix the cause and send it again. The severity comes from ZATCA's own SDK.

Fields the rule names

The rule text names 2 fields. BT is a single invoice element, BG is a group of elements and KSA is a Saudi-specific element.

• BG-20
• BT-95

How to fix it

The steps follow the wording of the rule only; we add nothing ZATCA did not say.

1. Open the invoice XML and find the fields the rule names: BG-20, BT-95.
2. Make sure BT-95 (Document level allowance VAT category code) is present in the invoice, because the rule requires it.
3. Correct the value or element in the XML, or in the POS setting that writes it, then generate the invoice again.
4. Check the corrected file with ZATCA's SDK 238-R3.3.8 before you send it.
5. Send the invoice again: the platform rejects an invoice that raises this code.

Rule family

BR-32 belongs to the BR family. In the XML Implementation Standard this family is section 13.2.1, titled Business rules - integrity constraints (BR): integrity constraints: elements an invoice has to contain. Our data holds 32 rules of this family, all of them raised by ZATCA's SDK.

Source and verification

• ZATCA SDK 238-R3.3.8: yes
• XML Implementation Standard: yes, section 13.2.1, p. 37

Verified on 26 October 2026. Source: ZATCA E-Invoicing SDK 238-R3.3.8 · Electronic Invoice XML Implementation Standard v1.2, 19 May 2023, §13.2.1, p. 37

This page is built from the reference’s open data: /codes.json. We add nothing of our own to it beyond the layout and the wording of the steps.

Related codes

From the same section of the standard (13.2.1 Business rules - integrity constraints (BR)) or the same family:

• BR-26 Each Invoice line (BG-25) shall contain the Item net price (BT-146).
• BR-31 Each Document level allowance (BG-20) shall have a Document level allowance amount (BT-92).
• BR-36 Each Document level charge (BG-21) shall have a Document level charge amount (BT-99).
• BR-37 Each Document level charge (BG-21) shall have a Document level charge VAT category code…
• BR-41 Each Invoice line allowance (BG-27) shall have an Invoice line allowance amount (BT-136).

Terms on this page

Keep going

Go back to the e-invoicing reference, see all rejection codes, or check your invoice file in the XML checker before you send it.

Frequently asked questions

What does BR-32 mean?

BR-32 is a rule in ZATCA's e-invoice validation. Its official text is: "Each Document level allowance (BG-20) shall have a Document level allowance VAT category code (BT-95)."

Is the invoice rejected when BR-32 appears?

An error: the invoice is rejected, so fix the cause and send it again. This is its severity in ZATCA's SDK 238-R3.3.8.

Where is BR-32 in ZATCA's documents?

ZATCA SDK 238-R3.3.8: yes. XML Implementation Standard: yes, section 13.2.1 p. 37. We checked on 26 October 2026.

Last updated: 27 October 2026 · What we don't do · Methodology · Correct us · Changelog

First published 2026-10-27