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 |
| Kardinalite | 0..1 |
| Veri türü | Binary (base64) |
| Uygulandığı belgeler | Vergi faturası (standart) ve Basitleştirilmiş vergi faturası |
JooDax’ta
HazırProgramlar 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ç dekontu | Alacak dekontu | Basitleştirilmiş | Basit borç | Basit alacak |
|---|---|---|---|---|---|
| Zorunlu | Zorunlu | Zorunlu | Zorunlu | Zorunlu | Zorunlu |
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
- Electronic Invoice XML Implementation Standard to the E-Invoicing resolution dated 2023-05-19 (v1.2) — ZATCA
- Security Features Implementation Standards to the E-Invoicing resolution dated 2023-05-19 (v1.2) — ZATCA
- E-invoicing Detailed Technical Guidelines (vVersion 2) — ZATCA
- الضوابط والمتطلبات والمواصفات الفنية والقواعد الإجرائية اللازمة لتنفيذ أحكام لائحة الفوترة الإلكترونية (قرار المحافظ رقم 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.