E-faturanın QR kodu
Faturaya basılan, temel verilerini ve mührünü base64 ile kodlanmış TLV olarak taşıyan kare bir kod; alıcı onu telefonuyla kontrol edebilir.
1. aşamadan (4 Aralık 2021) bu yana basitleştirilmiş faturanın beş etiketli bir QR kod taşıması zorunludur: satıcı adı, KDV numarası, zaman damgası, KDV dahil toplam ve KDV toplamı. 2. aşama kodu her belgede zorunlu kıldı ve dört etiket ekledi: belge özeti, imzası, açık anahtar ve basitleştirilmiş belgelerde ZATCA'nın cihaz sertifikası üzerindeki imzası.
Her etiket yan yana üç parçadan oluşur: etiket numarası için bir bayt, değerin uzunluğu için bir bayt, ardından UTF-8 değer. Etiketler tek bir bayt dizisi halinde art arda eklenir, base64 ile kodlanır ve görüntü bu metinden çizilir. Güvenlik standardı metni 700 karakterle sınırlar.
Basitleştirilmiş belgede mühürlemeyi yaptığı için kodun tamamını satıcının cihazı oluşturur. Standart belgede kodu ön onay sırasında FATOORA platformu ekler veya günceller. XML'deki QR bloğu, özeti içerdiği için özet hesaplamasının dışında tutulur.
ZATCA'nın belgeleri bilinmesi gereken bir noktada birbirinden ayrılır: Güvenlik standardı 6 numaralı etiketi 32 bayt (ikili bir özet) olarak tanımlarken teknik kılavuzdaki çözümlü örnek 6 ve 7 numaralı etiketlere base64 metin koyar (özet için 44 karakter). ZATCA'nın örnekleri zaman damgasını Z ile de bitirir, oysa standart Z içermeyen yerel saate izin verir.
JooDax’ta
HazırKasa, her basitleştirilmiş belgeye dokuz etiketli bir kod basar; 6 ve 7 numaralı etiketler, teknik kılavuzdaki örnekte olduğu gibi base64 metindir. Books (muhasebe programı) A4 faturalarına 1. aşamanın beş etiketli kodunu, mühürsüz olarak basar. Programlar 255 baytı aşan etiketi reddeder ama 700 karakter sınırını denetlemez.
crates/jdx-einvoice-sa/src/xml.rs
Adımlar
- Değerleri toplayın: ad, KDV numarası, zaman damgası, toplam, KDV; 2. aşamada ayrıca özet, imza, açık anahtar ve ZATCA'nın imzası.
- Her değer için önce etiket baytını, sonra bir uzunluk baytını (UTF-8 bayt sayısı), ardından değeri yazın.
- Etiketleri ayırıcı kullanmadan art arda ekleyin ve dizinin tamamını base64 ile kodlayın.
- Metni XML'deki QR öğesine koyun ve basılı nüshadaki görüntüyü bu metinden çizin.
QR kod etiketleri
| Etiket | Ad | Aşama | Anlamı |
|---|---|---|---|
| 1 | Satıcının adı | 1 | Satıcı adı alanındaki (BT-27) gibi, satıcının UTF-8 ile yazılmış tescilli adı. |
| 2 | Satıcının KDV kayıt numarası | 1 | Satıcının 15 haneli KDV numarası (BT-31). |
| 3 | Faturanın zaman damgası (tarih ve saat) | 1 | ISO 8601 biçiminde düzenleme tarihi ve saati; Güvenlik standardındaki örnek değer: 2022-02-21T12:13:57Z. 2. aşamada programlar, tarih ve saat alanlarını yansıtarak Z içermeyen yerel saati yazar; 1. aşama kodları ise Z ile UTC kullanır. |
| 4 | Fatura toplamı (KDV dahil) | 1 | Sayısal metin olarak KDV dahil toplam (BT-112). |
| 5 | KDV toplamı | 1 | KDV toplamı; Güvenlik standardının 1.2 sürümü bunun BT-110'un değeri olduğunu açıklığa kavuşturdu. |
| 6 | XML faturanın özeti | 2 | Belge özeti. Güvenlik standardı uzunluğunu 32 bayt olarak verir; teknik kılavuzdaki çözümlü örnek ise, programların yaptığı gibi, 44 karakterlik base64 metni taşır. |
| 7 | XML özetinin ECDSA imzası | 2 | Belge özetinin ECDSA imzası: basitleştirilmiş belgelerde satıcının cihazı, standart belgelerde ZATCA platformu tarafından atılır. Programlar onu, teknik kılavuzdaki örnekte olduğu gibi base64 metin olarak yazar. |
| 8 | ECDSA açık anahtarı | 2 | İmzalama anahtarına karşılık gelen açık anahtar. Programlar, teknik kılavuzdaki örnekte olduğu gibi DER SubjectPublicKeyInfo yapısının tamamını yazar (secp256k1 için 88 bayt). |
| 9 | Kriptografik mührün açık anahtarı üzerinde ZATCA teknik sertifika makamının (CA) ECDSA imzası | 2 | Yalnızca basitleştirilmiş belgeler ve dekontlarında: ZATCA sertifika makamının cihaz sertifikası üzerindeki imzası; sertifikadan kopyalanır. Yerel test modunda bu, ZATCA'nın değil, kendinden bir imzadır. |
Sorular ve yanıtlar
ZATCA'nın uygulaması Arapça adı neden bozuk gösteriyor?
Genellikle ad UTF-8 ile kodlanmadığı veya uzunluk bayt yerine harf olarak sayıldığı için; bir Arapça harf iki bayttır.
2. aşamaya geçtikten sonra 1. aşamanın kodu yeterli mi?
Hayır. Entegrasyondan sonra belge 2. aşama etiketlerini taşımalıdır; 9 numaralı etiket yalnızca basitleştirilmiş belgeler ve dekontları için geçerlidir.
İlgili sayfalar
- KSA-14 QR kod
- BT-27 Satıcı adı
- BT-31 Satıcı KDV kayıt numarası
- BT-112 KDV dahil fatura toplamı
- BT-110 Fatura KDV toplamı
- BR-KSA-27 · Belge, base64Binary olarak kodlanmış bir QR kod içermelidir.
İlgili kavramlar
- Kriptografik mühür (dijital imza)Belge özeti ve imzalama özellikleri üzerinde, kayıtlı bir cihaz anahtarı ve ZATCA'nın verdiği bir sertifikayla atılan XAdES biçiminde bir ECDSA imzası.
- Fatura özeti: nasıl hesaplanırMühür ve QR blokları çıkarılıp kanonikleştirildikten sonra belgenin base64 ile yazılan SHA-256 parmak izi; mühür ve zincir bu özete dayanır.
- 1. aşama (oluşturma) ve 2. aşama (entegrasyon)4 Aralık 2021'den beri yürürlükte olan 1. aşama, faturaların elektronik olarak düzenlenmesini ve saklanmasını ister; 1 Ocak 2023'ten itibaren dalgalar halinde uygulanan 2. aşama ise XML, mühürleme ve FATOORA ile entegrasyonu ekler.
Suudi Arabistan’da e-fatura (FATOORA)
Kaynaklar
- 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
- Electronic Invoice XML Implementation Standard to the E-Invoicing resolution dated 2023-05-19 (v1.2) — ZATCA
Kontrol tarihi: 4 Kasım 2026. JooDax’la ilgili her şey programların kendi kodundan alınmıştır.