BR-KSA-22: a warning the invoice is accepted with

Official text (the SDK's own message)

Each Invoice line charge (BG-28) shall have a Reason for invoice line charge (BT-144).

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

What it means

BR-KSA-22 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-28
• BT-144

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-28, BT-144.
2. Make sure BT-144 (Reason for invoice line charge) 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. 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-22 belongs to the BR-KSA family. In the XML Implementation Standard this family is section 13.3.1, titled KSA - business rules (BR-KSA): the business rules specific to Saudi Arabia. Our data holds 78 rules of this family, 77 of them raised by ZATCA's SDK.

Source and verification

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

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.1, p. 53

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.1 KSA - business rules (BR-KSA)) or the same family:

• BR-KSA-20 Each Invoice line charge (BG-28) shall have a code for the reason for invoice line charge…
• BR-KSA-21 Each Document level charge (BG-21) shall have a Reason for document level charge (BT-104).
• BR-KSA-23 A VAT breakdown (BG-23) with VAT Category code (BT-118) 'Exempt from VAT' shall have a VAT…
• BR-KSA-24 A VAT breakdown (BG-23) with VAT Category code (BT-118) 'Not subject to VAT' shall have a VAT…
• BR-KSA-25 If it is a simplified tax invoice or an associated credit note or a debit note (KSA-2…

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-22 mean?

BR-KSA-22 is a rule in ZATCA's e-invoice validation. Its official text is: "Each Invoice line charge (BG-28) shall have a Reason for invoice line charge (BT-144)."

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

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