BR-KSA-34: Invoice counter (ICV) holds more than digits

Official text

The invoice counter value (KSA-16) contains only digits.

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

What it means

The invoice counter is digits only. Any letter, dash or prefix such as INV fails the check.

When it happens

• The system put the prefixed invoice number in the counter field.
• The counter is written with separators or spaces.

How to fix it

1. Keep the invoice number (which may hold letters) apart from the counter (digits only).
2. Write the counter as a plain integer without separators.

Example

<cac:AdditionalDocumentReference>
  <cbc:ID>ICV</cbc:ID>
  <cbc:UUID>INV-10</cbc:UUID>
</cac:AdditionalDocumentReference>

<cac:AdditionalDocumentReference>
  <cbc:ID>ICV</cbc:ID>
  <cbc:UUID>10</cbc:UUID>
</cac:AdditionalDocumentReference>

We ran the wrong example through ZATCA's SDK 238-R3.3.8 on 26 October 2026 and it raised BR-KSA-34. The example is an excerpt of ZATCA's sample Simplified/Invoice/Simplified_Invoice.xml with one change; the sample without it does not raise the code.

Related codes

• BR-KSA-33 Invoice counter (ICV) is missing
• BR-KSA-31 For simplified tax invoices and associated credit notes and debit notes (KSA-2, position 1 and 2 = 02),only the following transaction types can be "true": - third party (KSA-2, position 3 = 1), - nominal supply (KSA-2, position 4 = 1) and - summary transactions (KSA-2,position 6 = 1). Other transaction types (self-billing and export) are not allowed to be "true" for simplified tax invoices and associated credit notes and debit notes.
• BR-KSA-35 If the invoice contains a supply end date (KSA-24), then the invoice must contain a supply date (KSA-5).

Terms on this page

Last updated: 26 October 2026 · What we don't do · Methodology · Correct us · Changelog

First published 2026-10-26 · Archived copy