BR-KSA-DEC-01: an error that rejects the invoice

Official text (the SDK's own message)

The allowance percentage values (BT-94, BT-138) must be from 0.00 to 100.00, with maximum two decimal places. Only numerals are accepted, the percentage symbol (%) is not allowed.

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

What it means

BR-KSA-DEC-01 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.

• BT-94
• BT-138

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: BT-94, BT-138.
2. Round the values the rule names to at most 2 decimal places before you write them into the XML.
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-KSA-DEC-01 belongs to the BR-KSA-DEC family. In the XML Implementation Standard this family is section 13.3.2, titled KSA – decimals rules (BR-KSA-DEC): the decimal rules specific to Saudi Arabia. Our data holds 5 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.3.2, p. 62

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.3.2, p. 62

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.3.2 KSA – decimals rules (BR-KSA-DEC)) or the same family:

• BR-KSA-DEC-02 The VAT rates (BT-96, BT-103, BT-119, BT-152, KSA-34) must be from 0.00 to 100.00, with…
• BR-KSA-DEC-03 VAT amount at line level (KSA-11) must have a maximum two decimals.
• BR-KSA-DEC-04 Amount with VAT at line level (KSA-12) must have a maximum two decimals.
• BR-KSA-DEC-06 Prepayment VAT category Taxable Amount (KSA-31) and Prepayment VAT Category Tax Amount…

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-KSA-DEC-01 mean?

BR-KSA-DEC-01 is a rule in ZATCA's e-invoice validation. Its official text is: "The allowance percentage values (BT-94, BT-138) must be from 0.00 to 100.00, with maximum two decimal places. Only numerals are accepted, the percentage symbol (%) is not allowed."

Is the invoice rejected when BR-KSA-DEC-01 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-KSA-DEC-01 in ZATCA's documents?

ZATCA SDK 238-R3.3.8: yes. XML Implementation Standard: yes, section 13.3.2 p. 62. 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