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ırProgramlar 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
- ext:UBLExtensions bloğunu çıkarın.
- ID değeri QR olan AdditionalDocumentReference öğesini çıkarın.
- cac:Signature öğesini çıkarın.
- XML bildirimini atın ve C14N 1.1 ile kanonikleştirin.
- 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
- KSA-13 Önceki fatura özeti (PIH)
- KSA-15 Kriptografik mühür
- KSA-14 QR kod
- BR-KSA-26 · Önceki fatura özeti, standardın yöntemiyle hesaplanmış base64 bir SHA-256 olmalıdır.
- BR-KSA-61 · Her belge önceki fatura özetini içermelidir.
İlgili kavramlar
- Özet almadan önce XML kanonikleştirme (C14N 1.1)XML metnini özet almadan önce tek bir standart biçime dönüştürmek; böylece aynı belge her sistemde aynı parmak izini verir.
- Önceki fatura özeti (PIH) ve belge zinciriHer belge, aynı cihazdan çıkan bir öncekinin özetini taşır; böylece belgeler, her silmenin veya değişikliğin görüldüğü bir zincir oluşturur.
- 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ı.
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
Kontrol tarihi: 4 Kasım 2026. JooDax’la ilgili her şey programların kendi kodundan alınmıştır.