BR-KSA-CL-01: Invoice currency code must be a valid ISO 4217 code

Explained by Matheel from ZATCA's rule text and the condition SDK 3.4.8 executes · Updated October 24, 2026

Error: the invoice is rejectedAll invoicesFields: BT-5

cbc:DocumentCurrencyCode (BT-5), and the @currencyID of line cac:TaxSubtotal/cbc:TaxAmount, line cac:TaxSubtotal/cbc:TaxableAmount and cbc:PayableRoundingAmount, must be a single ISO 4217 code from the list in the rule (e.g. SAR, USD, EUR).

How to fix it

Use an uppercase three-letter code from the list, e.g. <cbc:DocumentCurrencyCode>SAR</cbc:DocumentCurrencyCode>.

ZATCA's official text

[BR-KSA-CL-01]-Currency code (BT-5) must be according to ISO 4217:2005
Source: ZATCA SDK 3.4.8 · ZATCA KSA rules

Fails when (the condition ZATCA's SDK runs)

not(((not(contains(normalize-space(.), ' ')) and contains(' AED AFN ALL AMD ANG AOA ARS AUD AWG AZN BAM BBD BDT BGN BHD BIF BMD BND BOB BOV BRL BSD BTN BWP BYN BZD CAD CDF CHE CHF CHW CLF CLP CNY COP COU CRC CUC CUP CVE CZK DJF DKK DOP DZD EGP ERN ETB EUR FJD FKP GBP GEL GHS GIP GMD GNF GTQ GYD HKD HNL HRK HTG HUF IDR ILS INR IQD IRR ISK JMD JOD JPY KES KGS KHR KMF KPW KRW KWD KYD KZT LAK LBP LKR LRD LSL LYD MAD MDL MGA MKD MMK MNT MOP MRO MUR MVR MWK MXN MXV MYR MZN NAD NGN NIO NOK NPR NZD OMR PAB PEN PGK PHP PKR PLN PYG QAR RON RSD RUB RWF SAR SBD SCR SDG SEK SGD SHP SLL SOS SRD SSP STD SVC SYP SZL THB TJS TMT TND TOP TRY TTD TWD TZS UAH UGX USD USN UYI UYU UZS VEF VND VUV WST XAF XAG XAU XBA XBB XBC XBD XCD XDR XOF XPD XPF XPT XSU XTS XUA XXX YER ZAR ZMW ZWL ', concat(' ', normalize-space(.), ' ')))))

Related rules

• BR-05 · Every invoice needs a currency code (BT-5)
• BR-KSA-88 · Exchange-rate source currency must equal the invoice currency
• BR-KSA-97 · Non-SAR invoice: SAR VAT total must differ from the VAT total
• BR-KSA-CL-02 · Every amount's currencyID must match the invoice currency