Skip to content
KSA-16

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.

IdentifierKSA-16
Path in the document/Invoice/cac:AdditionalDocumentReference[cbc:ID='ICV']/cbc:UUID
Cardinality0..1
Data typeIdentifier
Applies toStandard tax invoice and Simplified tax invoice

In JooDax

Built

Each 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 invoiceDebit noteCredit noteSimplifiedSimplified debitSimplified credit
MandatoryMandatoryMandatoryMandatoryMandatoryMandatory

Rules that check it

  • BR-KSA-33 · Every document must carry an invoice counter value.
  • BR-KSA-34 · The counter value contains digits only.

Related fields

Fields — E-invoicing in Saudi Arabia (FATOORA)

Sources

  1. Electronic Invoice XML Implementation Standard to the E-Invoicing resolution dated 2023-05-19 (v1.2) — ZATCA
  2. Electronic Invoice Data Dictionary to the E-Invoicing resolution dated 2023-05-19 (v1.2) — ZATCA
  3. الضوابط والمتطلبات والمواصفات الفنية والقواعد الإجرائية اللازمة لتنفيذ أحكام لائحة الفوترة الإلكترونية (قرار المحافظ رقم 62738 وتاريخ 1443/11/23هـ) (vfile dated 20230519 (decision 62738)) — ZATCA
  4. الدليل الإرشادي التفصيلي للفوترة الإلكترونية (vالنسخة الثانية) — ZATCA
  5. E-invoicing Detailed Technical Guidelines (vVersion 2) — ZATCA

Checked on: 4 November 2026. What concerns JooDax is taken from the programs’ own code.