Ö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.
Aynı belge pek çok farklı metin olarak yazılabilir: öznitelik sırası, tırnak türü, ad alanı (namespace) bildirimleri, boş öğeler. Kanonikleştirme (Canonical XML 1.1) bunların hepsini tek bir metne indirger ve özet bu metin üzerinden alınır.
ZATCA bunu imza bloğunda sabitler: UBLExtensions, cac:Signature ve QR referansını çıkaran üç XPath dönüşümü, ardından http://www.w3.org/2006/12/xml-c14n11 dönüşümü. Önceki fatura özeti de aynı yöntemle hesaplanır.
Arapça faturalar için pratik sonuçları: metin UTF-8'dir; metin içindeki tırnaklar kaçışlı yazılmaz ama &, < ve > kaçışlı yazılır; çıkarılan blokların çevresindeki satır boşlukları metinde kalır.
JooDax’ta
HazırProgramlarda bir kanonikleştirici bulunmaz. Bunun yerine belgeyi baştan kanonik biçimde yazarlar (D-01 kararı: 1.0 sürümünden farklı olarak yalnızca &, < ve > kaçışlı yazılır, tırnaklara dokunulmaz); böylece yazılan metin kanonik metnin kendisidir ve özet doğrudan ondan alınır. Bu, belgeyi yazan koddaki her karakterin sabit kalmasına dayanır; 400 altın test vakası onu 1.0 sürümüne sabit tutar.
crates/jdx-einvoice-sa/src/xml.rs
İlgili sayfalar
- KSA-13 Önceki fatura özeti (PIH)
- KSA-15 Kriptografik mühür
- BR-KSA-26 · Önceki fatura özeti, standardın yöntemiyle hesaplanmış base64 bir SHA-256 olmalıdır.
İlgili kavramlar
- 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.
- 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
- Security Features Implementation Standards to the E-Invoicing resolution dated 2023-05-19 (v1.2) — ZATCA
- Electronic Invoice XML Implementation Standard 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.