İçeriğe geç

Platform API’leri ve ortamları

Uç noktalar

AdYöntemBelgedeki yolAmaçJooDax kullanır
Compliance CSIDPOST/complianceCSR'yi FATOORA portalından alınan bir OTP ile gönderir; uygunluk sertifikasını (binarySecurityToken), gizli anahtarını (secret) ve istek kimliğini döndürür.Evet
Compliance invoice checkPOST/compliance/invoicesÜretim sertifikası verilmeden önce, uygunluk sertifikasıyla imzalanmış örnek belgeleri kontrol eder. Teknik kılavuz her tür için üç belge sayar: fatura, borç dekontu, alacak dekontu.Evet
Production CSID (onboarding)POST/production/csidsUygunluk isteği kimliği karşılığında, o andan itibaren mühürleme ve bildirim için kullanılacak üretim sertifikasını (PCSID) verir.Evet
Production CSID (renewal)PATCH/production/csidsÜretim sertifikasını yeni bir CSR ve yeni bir OTP ile yeniler; eski sertifika iptal edilir.Hayır
Reporting (single)POST/invoices/reporting/singleİmzalanmış basitleştirilmiş bir belgeyi (fatura veya dekont) bildirir: 200 kabul, 202 uyarılarla kabul, 400 ret, 409 daha önce bildirilmiş.Evet
Clearance (single)POST/invoices/clearance/singleStandart bir belgeyi ön onaydan geçirir; platform onu mühürlenmiş ve QR kodlu olarak döndürür (clearedInvoice). ZATCA ön onayı kapattığında 303 döndürür; bu durumda belge bildirim yoluyla gönderilir.Hayır

Ortamlar

OrtamAmaç
Developer portal (Integration Sandbox)https://gw-fatoora.zatca.gov.sa/e-invoicing/developer-portalGeliştiriciler için bir test ortamı; oraya gönderilen hiçbir şey ZATCA nezdinde geçerli sayılmaz ve buranın sertifikaları üretim ortamında çalışmaz. API sayfaları örnek OTP'ler gösterir (123345 gibi), ancak herhangi bir OTP'nin kabul edildiğini söylemez.
Simulationhttps://gw-fatoora.zatca.gov.sa/e-invoicing/simulationÜretimden önce uçtan uca test için isteğe bağlı bir ortam; cihazlar üretimden ayrı olarak kaydedilir ve FATOORA simülasyon portalından alınan OTP bir saat geçerlidir.
Production (core)https://gw-fatoora.zatca.gov.sa/e-invoicing/coreBildirim ve ön onay için canlı ortam. OTP'ler FATOORA portalından alınır (istek başına en fazla 100 adet, her biri bir saat geçerli); bunlar için bir API yoktur.

Kaynaklar

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