BR-KSA-EN16931-09: a warning the invoice is accepted with

Official text (the SDK's own message)

Only one tax total (BG-22) without tax subtotals (BG-23) must be provided when tax currency code is provided .

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

What it means

BR-KSA-EN16931-09 is one of the validation rules for the e-invoice. A warning: the invoice is accepted with a note; fix the cause in the next invoices. 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-22
• BG-23

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-22, BG-23.
2. Correct the value or element in the XML, or in the POS setting that writes it, then generate the invoice again.
3. Check the corrected file with ZATCA's SDK 238-R3.3.8 before you send it.
4. This is a warning and the platform accepts the invoice with it. Fix the cause so it does not repeat in the next invoices.

Rule family

BR-KSA-EN16931-09 belongs to the BR-KSA-EN16931 family. In the XML Implementation Standard this family is section 13.3.4, titled KSA – EN16931 (BR-KSA-EN16931): the Saudi rules tied to the EN16931 standard. Our data holds 11 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.4, p. 67

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.4, p. 67

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.4 KSA – EN16931 (BR-KSA-EN16931)) or the same family:

• BR-KSA-EN16931-06 Charge on price level (BG-29) is allowed. The value of Indicator should be ' True'.
• BR-KSA-EN16931-07 Item net price (BT-146) must equal (Item Gross price (BT-148) - Allowance amount (BT-147))…
• BR-KSA-EN16931-08 More than one tax total with a breakdown
• BR-KSA-EN16931-11 Line amount does not equal quantity × price
• BR-KSA-EN16931-12 Base quantity (BT-149) must be a positive number above zero.

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-EN16931-09 mean?

BR-KSA-EN16931-09 is a rule in ZATCA's e-invoice validation. Its official text is: "Only one tax total (BG-22) without tax subtotals (BG-23) must be provided when tax currency code is provided ."

Is the invoice rejected when BR-KSA-EN16931-09 appears?

A warning: the invoice is accepted with a note; fix the cause in the next invoices. This is its severity in ZATCA's SDK 238-R3.3.8.

Where is BR-KSA-EN16931-09 in ZATCA's documents?

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