BR-CL-KSA-14: an error that rejects the invoice

Official text (the SDK's own message)

[KSA-14]Field character limit for QR Code field has been exceeded. The maximum character limit for this field is 1000 characters.

Error · Source: ZATCA E-Invoicing SDK 238-R3.3.8 · Checked: 26 October 2026

What it means

BR-CL-KSA-14 is one of the validation rules for the e-invoice. An error: the invoice is rejected, so fix the cause and send it again. The severity comes from ZATCA's own SDK.

Fields the rule names

The rule text names 1 field. BT is a single invoice element, BG is a group of elements and KSA is a Saudi-specific element.

• KSA-14

How to fix it

The steps follow the wording of the rule only; we add nothing ZATCA did not say.

1. Open the invoice XML and find the fields the rule names: KSA-14.
2. Correct the value or element in the XML, or in the POS setting that writes it, then generate the invoice again.
3. Check the corrected file with ZATCA's SDK 238-R3.3.8 before you send it.
4. Send the invoice again: the platform rejects an invoice that raises this code.

Rule family

BR-CL-KSA-14 belongs to the BR-CL-KSA family. This family appears in ZATCA's SDK only and the XML Implementation Standard has no section under its name, so we describe it no further than the rule text. Our data holds 1 rule of it.

Source and verification

• ZATCA SDK 238-R3.3.8: yes
• XML Implementation Standard: no

Verified on 26 October 2026. Source: ZATCA E-Invoicing SDK 238-R3.3.8

This page is built from the reference’s open data: /codes.json. We add nothing of our own to it beyond the layout and the wording of the steps.

Related codes

From the same family:

• BR-CL-16 Payment means in an invoice MUST be coded using UNCL4461 code list
• BR-CL-18 Invoice tax categories MUST be coded using UNCL5305 code list.
• BR-CO-04 Each Invoice line (BG-25) shall be categorized with an Invoiced item VAT category code…
• BR-CO-10 Sum of Invoice line net amount (BT-106) = Σ Invoice line net amount (BT-131).
• BR-CO-11 Sum of allowances on document level (BT-107) = Σ Document level allowance amount (BT-92).

Terms on this page

Keep going

Go back to the e-invoicing reference, see all rejection codes, or check your invoice file in the XML checker before you send it.

Frequently asked questions

What does BR-CL-KSA-14 mean?

BR-CL-KSA-14 is a rule in ZATCA's e-invoice validation. Its official text is: "[KSA-14]Field character limit for QR Code field has been exceeded. The maximum character limit for this field is 1000 characters."

Is the invoice rejected when BR-CL-KSA-14 appears?

An error: the invoice is rejected, so fix the cause and send it again. This is its severity in ZATCA's SDK 238-R3.3.8.

Where is BR-CL-KSA-14 in ZATCA's documents?

ZATCA SDK 238-R3.3.8: yes. XML Implementation Standard: no. We checked on 26 October 2026.

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

First published 2026-10-27