BR-CL-03: Amount currencyID must be an ISO 4217 alpha-3 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: —

Checks the @currencyID attribute on amount elements (cbc:Amount, cbc:BaseAmount, cbc:PriceAmount, cbc:TaxAmount, cbc:TaxableAmount, cbc:LineExtensionAmount, cbc:TaxExclusiveAmount, cbc:TaxInclusiveAmount, cbc:AllowanceTotalAmount, cbc:ChargeTotalAmount, cbc:PrepaidAmount, cbc:PayableRoundingAmount, cbc:PayableAmount) against the ISO 4217 alpha-3 list in the rule (which includes SAR). As executed, the check is skipped when @currencyID is empty or absent, which the displayed test does not show.

How to fix it

Set a valid three-letter ISO 4217 code on every amount, e.g. <cbc:PayableAmount currencyID="SAR">115.00</cbc:PayableAmount>.

ZATCA's official text

[BR-CL-03]-currencyID MUST be coded using ISO code list 4217 alpha-3
Source: ZATCA SDK 3.4.8 · EN 16931 (CEN) rules

Fails when (the condition ZATCA's SDK runs)

string-length(@currencyID) > 0 and not(((not(contains(normalize-space(@currencyID), ' ')) 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(@currencyID), ' ')))))

Related rules

• BR-54 · Each item attribute needs a name (BT-160) and a value (BT-161)
• BR-55 · A billing reference must give the preceding invoice number (BT-25)
• BR-CL-01 · Invoice type code must be a valid UNTDID 1001 code
• BR-CL-04 · Invoice currency code must be an ISO 4217 alpha-3 code
• BR-CL-05 · Tax currency code must be an ISO 4217 alpha-3 code
• BR-CL-14 · Country codes must be ISO 3166-1 alpha-2 codes