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

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ı.

Sertifika (CSID; kontroller belgesi buna kriptografik mühür tanımlayıcısı der) bir faturalama cihazını mükellefin KDV numarasına bağlar. Süreç FATOORA portalında başlar; mükellef orada bir OTP üretir (istek başına en fazla 100 adet, her biri bir saat geçerli; OTP'ler için bir API yoktur).

Cihaz bir anahtar çifti ve bir PKCS#10 isteği üretir. İstek; birimin ortak adını (common name), “1-manufacturer|2-model|3-serial” biçiminde bir seri numarasını, KDV numarasını, şube adını, mükellef adını, ülkeyi, dört haneli bir fatura türü eşlemini (1100 = standart ve basitleştirilmiş), konumu ve sektörü taşır. İstek OTP ile gönderildiğinde bir uygunluk sertifikası döner.

Cihaz, uygunluk sertifikasıyla kontrol için örnek belgeler gönderir; teknik kılavuz her tür için (fatura, borç dekontu, alacak dekontu) üç örnek sayar. Örnekler geçince uygunluk isteği kimliğiyle üretim sertifikasını ister ve o andan itibaren mühürleme ve bildirim için onu kullanır. Sertifika en fazla 60 ay geçerlidir; yenileme yeni bir OTP ve yeni bir anahtar gerektirir.

Kontroller belgesi, imzalama anahtarının dışa aktarılamaz olarak işaretlenmesini ya da anahtarı yazılım saklıyorsa diskin şifrelenmesini ister; anahtarı başka bir cihaza taşımak yasaklı bir işlevdir.

JooDax’ta

Kısmen hazır

Kayıt süreci oluşturulmuştur: programlar anahtarı ve CSR'yi kendileri üretir, uygunluk sertifikasını ister, bir örnek belgeyi (basitleştirilmiş fatura) kontrol ettirir, ardından üretim sertifikasını ister; bu, geliştirici sandbox ortamında başarılı oldu. Ancak standart faturalar oluşturulmadığı halde 1100 fatura türünü (standart ve basitleştirilmiş) isterler ve her tür için üç örnek yerine tek bir örnek kontrol ettirirler. Bu, simülasyon veya üretim ortamında denenmedi; orada platform, kontroller tamamlanana kadar üretim sertifikasını reddedebilir. CSR alanları, Güvenlik standardının tablosunu (organizationIdentifier) değil, ZATCA'nın örnek yapılandırmasını (alternatif addaki SN, UID, title) izler. Yenileme oluşturulmamıştır. Anahtar şifreli veri dosyasının içinde saklanır.

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

Adımlar

  1. FATOORA portalında bir OTP üretin.
  2. Cihazda, hedef ortamın şablonuyla bir özel anahtar ve bir CSR üretin.
  3. Bir uygunluk sertifikası ve gizli anahtar (secret) almak için CSR'yi ve OTP'yi /compliance adresine gönderin.
  4. İmzalı örnek belgeleri, geçene kadar /compliance/invoices adresine gönderin.
  5. Üretim sertifikasını almak için uygunluk isteği kimliğini /production/csids adresine gönderin.

Sorular ve yanıtlar

Geliştirici portalından alınan sertifika üretim ortamında çalışır mı?

Hayır. Geliştirici portalı sertifikaları yalnızca test içindir ve canlı ortamda çalışmaz.

Mükellef bir KDV grubuna katıldığında sertifikalarına ne olur?

Sertifikalar otomatik olarak iptal edilir ve cihazların grup numarasıyla yeniden kaydedilmesi gerekir.

İlgili sayfalar

İlgili kavramlar

Suudi Arabistan’da e-fatura (FATOORA)

Kaynaklar

  1. Security Features Implementation Standards to the E-Invoicing resolution dated 2023-05-19 (v1.2) — ZATCA
  2. E-invoicing Detailed Technical Guidelines (vVersion 2) — ZATCA
  3. Developer Portal Manual (vVersion 3) — ZATCA
  4. FATOORA Portal User Manual (vVersion 3) — ZATCA
  5. Integration Sandbox API pages (Swagger): reporting, clearance, compliance, production CSID, renewal (ve-Invoicing Sandbox Release 2.1.0 (page lists 2.1.1 as latest)) — ZATCA
  6. الضوابط والمتطلبات والمواصفات الفنية والقواعد الإجرائية اللازمة لتنفيذ أحكام لائحة الفوترة الإلكترونية (قرار المحافظ رقم 62738 وتاريخ 1443/11/23هـ) (vfile dated 20230519 (decision 62738)) — ZATCA

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