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ı.
Mühür iki şeyi kanıtlar: belge, sahibinin ZATCA'ya kaydettiği bir cihazdan gelmiştir ve o zamandan beri değişmemiştir. Özet SHA-256 ile alınır, imza 256 bitlik bir anahtarla ECDSA ile atılır ve imza B-B düzeyinde zarflanmış bir XAdES imzasıdır.
İmza iki referans taşır: dönüşümlerden sonraki belge özeti ve imzalama zamanını, sertifika özetini, sertifikayı veren kuruluşu ve seri numarasını taşıyan SignedProperties bloğunun özeti. Ardından SignedInfo imzalanır; imza ve sertifika belgeye eklenir.
Basitleştirilmiş belge, teslimden önce satıcının cihazı tarafından mühürlenir. Standart belge ise ön onay sırasında ZATCA platformu tarafından mühürlenir; satıcı da mühürlemişse platform ikinci bir mühür ekler. QR kod imzanın dışında tutulur.
ZATCA'nın metinleri tam olarak uyumlu değildir: Güvenlik standardının tablosu SigningCertificateV2'yi, bir imza politikasını ve sertifika zincirinin tamamını listeler; örnek sertifika profili P-256 der. Resmi örnekler ve araçlar ise secp256k1 kullanır (teknik kılavuzdaki OpenSSL komutları).
JooDax’ta
HazırProgramlar secp256k1 anahtarıyla (k256) mühürler ve imzalı özellikler bloğunu ZATCA doğrulayıcısının kabul ettiği biçimde harfi harfine yazar; sertifika ve özellik özetleri onaltılık dizenin base64 karşılığıdır. Güvenlik standardının tablosundan şu noktalarda ayrılırlar: sürüm 1 SigningCertificate, imza politikası ve veri nesnesi özelliklerinin bulunmaması, yalnızca imzalama sertifikasının eklenmesi ve ikinci referansın Type değeri (01903#SignedProperties yerine xmldsig#SignatureProperties). Teknik kılavuzun 5. adımı özellik özetini boşluklar silindikten sonraki baytların base64 karşılığı olarak tarif eder; programlar ise girintisi sabitlenmiş bir bloğun özetini alır ve onaltılık metni kodlar. ZATCA'nın doğrulayıcısı bu biçimi kanıt aşamasında kabul etti.
crates/jdx-einvoice-sa/src/xml.rs
Adımlar
- Belge özetini hesaplayın (fatura özeti sayfasına bakın).
- Özeti, cihazın özel anahtarıyla ECDSA kullanarak imzalayın.
- Sertifika özetini hesaplayın ve imzalı özellikleri doldurun: imzalama zamanı, özet, sertifikayı veren kuruluş ve seri numarası.
- İmzalı özelliklerin özetini alın.
- UBLExtensions bloğunu imza, sertifika ve iki referansla doldurun; cac:Signature öğesini ve QR bloğunu ekleyin.
Sorular ve yanıtlar
Mühür dosyanın tamamını mı imzalar?
QR bloğu ve mühür bloğunun kendisi dışında belgenin tamamını kapsar.
İlgili sayfalar
- KSA-15 Kriptografik mühür
- KSA-13 Önceki fatura özeti (PIH)
- KSA-14 QR kod
- BR-KSA-28 · Mühürdeki imza bilgisi kimliği urn:oasis:names:specification:ubl:signature:1 olmalıdır.
- BR-KSA-29 · Atıf yapılan imza kimliği ve imza kimliği urn:oasis:names:specification:ubl:signature:Invoice olmalıdır.
- BR-KSA-30 · İmza yöntemi urn:oasis:names:specification:ubl:dsig:enveloped:xades olmalıdır.
- BR-KSA-60 · Kriptografik mühür, basitleştirilmiş belgelerde ve dekontlarında zorunludur.
İ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.
- Cihazın kaydı ve CSID sertifikasıBir faturalama cihazının mühürleme sertifikasını ZATCA'dan nasıl aldığı: anahtar, sertifika isteği, OTP, uygunluk kontrolleri ve ardından üretim sertifikası.
- Ö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.
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.