İçeriğe geç
KSA-14

QR kod

Faturanın temel verilerini ve mührünü taşıyan TLV etiketlerinden oluşan base64 dizesi; alıcının kontrol edebileceği bir QR görüntüsü olarak basılır.

Kod her belgede zorunludur (BR-KSA-27) ve basılı nüshada görünür olmalıdır. 2. aşamada dokuz etiket içerir: satıcı adı, KDV numarası, zaman damgası, KDV dahil toplam ve KDV toplamı, ardından belge özeti, imzası ve açık anahtar; yalnızca basitleştirilmiş belgelerde bulunan 9 numaralı etiket ise ZATCA'nın cihaz sertifikası üzerindeki imzasıdır.

Her etiket, numara için bir bayt, uzunluk için bir bayt ve ardından UTF-8 değerden oluşur; dizinin tamamı base64 ile kodlanır ve Güvenlik standardı sonucu 700 karakterle sınırlar. Tipik hatalar, uzunluğu bayt yerine metin olarak yazmak veya Arapça bir adı UTF-8 dışında bir kodlamayla yazmaktır.

QR bloğu, özetin kendisini içerdiği için özet ve imza hesaplamasının dışında tutulur. Standart faturada QR'ı ön onay sırasında ZATCA ekler veya günceller; basitleştirilmiş faturada kodun tamamını cihaz yazar.

TanımlayıcıKSA-14
Belgedeki yol/Invoice/cac:AdditionalDocumentReference[cbc:ID='QR']/cac:Attachment/cbc:EmbeddedDocumentBinaryObject
Kardinalite0..1
Veri türüBinary (base64)
Uygulandığı belgelerVergi faturası (standart) ve Basitleştirilmiş vergi faturası

JooDax’ta

Hazır

Programlar dokuz etiketin tamamını oluşturur ve 255 baytı aşan etiketi reddeder, ancak 700 karakterlik toplam sınırı denetlemez. 6 ve 7 numaralı etiketler, teknik kılavuzdaki çözümlü örnekte olduğu gibi base64 metin olarak yazılır; oysa Güvenlik standardı 6 numaralı etiketi 32 bayt olarak tanımlar. 3 numaralı etiket Z içermeyen yerel saattir.

crates/jdx-einvoice-sa/src/xml.rs

Uygulandığı belgeler

Vergi faturasıBorç dekontuAlacak dekontuBasitleştirilmişBasit borçBasit alacak
ZorunluZorunluZorunluZorunluZorunluZorunlu

Onu denetleyen kurallar

  • BR-KSA-27 · Belge, base64Binary olarak kodlanmış bir QR kod içermelidir.

İlgili alanlar

Alanlar — Suudi Arabistan’da e-fatura (FATOORA)

Kaynaklar

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

Kontrol tarihi: 4 Kasım 2026. JooDax’la ilgili her şey programların kendi kodundan alınmıştır.