Standart faturaların ön onayı (clearance)
Standart bir faturanın veya dekontun, alıcı onu almadan önce FATOORA'ya gönderilmesi; platform belgeyi mühürlenmiş ve QR kodlu olarak geri döndürür.
Kontroller belgesi ön onayı, ZATCA'nın standart faturaları ve dekontlarını müşteriye ulaşmadan önce kontrol etmesi, uygun olanları mühürlemesi ve düzenleyeni bilgilendirmesi olarak tanımlar. 2. aşamada standart fatura ancak ZATCA'nın mührüyle geçerlidir.
Satıcı belgeyi XML olarak (PDF/A-3 değil) özeti ve UUID'siyle birlikte ön onay API'sine gönderir. Belge geçerliyse veya uyarılarla kabul edilirse platform onu mühürlenmiş ve QR kodlu olarak döndürür; reddedilirse hataları döndürür ve düzeltilen belge, yeni bir sayaç değeri ve UUID ile yeni bir belge olarak yeniden gönderilir.
Onaylanmış bir self-billing düzenlemesinde belgeyi alıcı gönderir. ZATCA ön onayı kapattığında API 303 yanıtını verir ve standart belge bildirim API'si üzerinden gider; doğrulanır ama mühürlenmez. Sistem kesintisi sırasında arıza, ZATCA'nın arıza bildirim hizmeti aracılığıyla bildirilir ve belgeler sorun giderildiğinde gönderilir.
JooDax’ta
YapılmadıOluşturulmamıştır. Belge, standart bir faturanın gerektirdiği alıcı KDV numarasını ve adresini taşımaz; programlarda ön onay API'sine yapılan bir çağrı da yoktur.
crates/jdx-einvoice-sa/src/api.rs
Adımlar
- Standart belgeyi düzenleyin; isterseniz mühürleyin.
- Belgeyi özeti ve UUID'siyle birlikte /invoices/clearance/single adresine gönderin.
- 200 veya 202 yanıtında mühürlenmiş belgeyi (clearedInvoice) alın ve alıcıya verin.
- 400 yanıtında belgeyi düzeltin ve yeni bir belge düzenleyin.
Sorular ve yanıtlar
ZATCA faturayı mühürledikten sonra özet değişir mi?
Hayır; mühür ve QR kod, özet hesaplamasının dışında tutulan bloklarda yer alır.
İlgili sayfalar
- KSA-2 Fatura işlem kodu
- KSA-15 Kriptografik mühür
- KSA-14 QR kod
- BR-KSA-06 · Fatura türündeki name özniteliği bulunmalı ve NNPNESB yapısında olmalıdır.
İlgili kavramlar
- Basitleştirilmiş faturaların 24 saat içinde bildirimiÖnceden mühürlenip alıcıya verilmiş basitleştirilmiş bir faturanın veya dekontun, düzenlemeden itibaren 24 saat içinde FATOORA'ya gönderilmesi.
- Standart ve basitleştirilmiş vergi faturalarıStandart faturalar işletmeler içindir ve teslimden önce ön onaydan geçer; basitleştirilmiş faturalar çoğunlukla tüketiciler içindir, yerel olarak mühürlenir ve 24 saat içinde bildirilir.
- 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
- الضوابط والمتطلبات والمواصفات الفنية والقواعد الإجرائية اللازمة لتنفيذ أحكام لائحة الفوترة الإلكترونية (قرار المحافظ رقم 62738 وتاريخ 1443/11/23هـ) (vfile dated 20230519 (decision 62738)) — ZATCA
- Controls, Requirements, Technical Specifications and Procedural Rules for Implementing the Provisions of the E-Invoicing Regulation (Decision No. 62738 dated 23/11/1443H) (vfile dated 20230519 (decision 62738)) — ZATCA
- E-invoicing Detailed Technical Guidelines (vVersion 2) — ZATCA
- Detailed Guidelines for E-Invoicing (vVersion 2) — ZATCA
- 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
Kontrol tarihi: 4 Kasım 2026. JooDax’la ilgili her şey programların kendi kodundan alınmıştır.