İçeriğe geç
Suudi Arabistan’da e-fatura (FATOORA)

Fatura özeti: nasıl hesaplanır

Mü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.

Gerçekte imzalanan şey özettir: kriptografik mühür dosyanın değil, özetin üzerine atılan bir imzadır. Bir sonraki belgenin önceki fatura özeti olarak taşıdığı, her istekle FATOORA'ya gönderilen ve QR koddaki 6 numaralı etikette yer alan da odur.

Özet alınmadan önce, henüz hazır olmadıkları veya özetin kendisini içerdikleri için üç blok çıkarılır: UBLExtensions (mühür), QR referansı ve cac:Signature. XML bildirimi atılır, metin C14N 1.1 ile kanonikleştirilir, SHA-256 hesaplanır ve 32 bayt base64 ile kodlanır.

Özet belge metni üzerinden alındığı için bir boşluk, öznitelik sırası veya karakter kodlamasındaki bir fark farklı bir özet verir. Metnin önce kanonikleştirilmesinin ve ZATCA mührünün ön onaylı bir faturanın özetini değiştirmemesinin nedeni budur: mühür, hesaplama dışında tutulan bloklarda yer alır.

JooDax’ta

Hazır

Programlar bir C14N motoru kullanmaz: belgeyi baştan kanonik biçimde yazarlar (D-01 kararı: yalnızca &, < ve > kaçışlı yazılır, tırnaklara dokunulmaz), ardından üç bloğu metinden keser, bildirimi atar ve SHA-256'yı hesaplarlar. Özet, hesaplama dışı bloklarında yer tutucular bulunan nihai belge taslağından alınır; ZATCA'nın doğrulayıcısı sonucu kabul etti ve 400 altın test vakası onu 1.0 sürümüne sabit tutar.

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

Adımlar

  1. ext:UBLExtensions bloğunu çıkarın.
  2. ID değeri QR olan AdditionalDocumentReference öğesini çıkarın.
  3. cac:Signature öğesini çıkarın.
  4. XML bildirimini atın ve C14N 1.1 ile kanonikleştirin.
  5. SHA-256'yı hesaplayın ve 32 baytı base64 ile kodlayın.

Sorular ve yanıtlar

Bir sonraki faturanın özetini almak için ön onayı beklemem gerekir mi?

Hayır. Teknik kılavuza göre ZATCA'nın mührü özeti değiştirmez; bu yüzden belgeler beklemeden düzenlenebilir.

İlgili sayfalar

İlgili kavramlar

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

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