Invoice counter value (ICV)
A whole number that goes up by one with every document a device issues, and is never reset or reused.
The counter sits in the AdditionalDocumentReference whose ID is ICV, with its value in the UUID element even though it is not a UUID. BR-KSA-33 and BR-KSA-34 require it and allow digits only.
The controls call it tamper-resistant: it cannot be reset or reassigned and it increases with every invoice or note; resetting it is a prohibited function. There is one counter per issuing unit, covering standard and simplified documents alike.
When the platform rejects a document, its counter value is spent; the corrected document takes a new value. Together with the previous invoice hash, the counter makes any deletion or insertion in the chain visible.
| Identifier | KSA-16 |
|---|---|
| Path in the document | /Invoice/cac:AdditionalDocumentReference[cbc:ID='ICV']/cbc:UUID |
| Cardinality | 0..1 |
| Data type | Identifier |
| Applies to | Standard tax invoice and Simplified tax invoice |
In JooDax
BuiltEach issuing unit keeps a counter that starts at 1 and advances inside the same transaction that writes the sale; the data file refuses a repeated value within a unit. Onboarding a new unit starts a new chain at 1.
crates/jdx-einvoice-sa/src/unit.rs
Applies to
| Tax invoice | Debit note | Credit note | Simplified | Simplified debit | Simplified credit |
|---|---|---|---|---|---|
| Mandatory | Mandatory | Mandatory | Mandatory | Mandatory | Mandatory |
Rules that check it
Related fields
Fields — E-invoicing in Saudi Arabia (FATOORA)
Sources
- Electronic Invoice XML Implementation Standard to the E-Invoicing resolution dated 2023-05-19 (v1.2) — ZATCA
- Electronic Invoice Data Dictionary to the E-Invoicing resolution dated 2023-05-19 (v1.2) — ZATCA
- الضوابط والمتطلبات والمواصفات الفنية والقواعد الإجرائية اللازمة لتنفيذ أحكام لائحة الفوترة الإلكترونية (قرار المحافظ رقم 62738 وتاريخ 1443/11/23هـ) (vfile dated 20230519 (decision 62738)) — ZATCA
- الدليل الإرشادي التفصيلي للفوترة الإلكترونية (vالنسخة الثانية) — ZATCA
- E-invoicing Detailed Technical Guidelines (vVersion 2) — ZATCA
Checked on: 4 November 2026. What concerns JooDax is taken from the programs’ own code.