BR-CL-04: an error that rejects the invoice

Official text (the SDK's own message)

Invoice currency code MUST be coded using ISO code list 4217 alpha-3

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

What it means

BR-CL-04 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.

How to fix it

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

1. Read the rule text above and find the element or value it talks about in the invoice XML.
2. Use a value from the code list the rule names: ISO code list 4217 alpha-3.
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-CL-04 belongs to the BR-CL family. In the XML Implementation Standard this family is section 13.2.7, titled Business rules – Code lists (BR-CL): code lists: values that must come from a defined list. Our data holds 7 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.7, p. 45

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.7, p. 45

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.7 Business rules – Code lists (BR-CL)) or the same family:

• BR-CL-01 The document type code MUST be coded by the invoice and credit note related code lists of…
• BR-CL-03 currencyID MUST be coded using ISO code list 4217 alpha-3
• BR-CL-05 Tax currency code MUST be coded using ISO code list 4217 alpha-3
• BR-CL-14 Country codes in an invoice MUST be coded using ISO code list 3166-1
• BR-CL-16 Payment means in an invoice MUST be coded using UNCL4461 code list

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-CL-04 mean?

BR-CL-04 is a rule in ZATCA's e-invoice validation. Its official text is: "Invoice currency code MUST be coded using ISO code list 4217 alpha-3"

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

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