زاتكا API هو خدمة سحابية تتيح للمنشآت السعودية ربط أنظمتها مع هيئة الزكاة والضريبة والدخل لإصدار الفواتير الإلكترونية، دون الحاجة لكتابة أكواد معقّدة أو إدارة الشهادات يدوياً. نحن نتولى التوقيع الرقمي، توليد الـ Hash، رمز QR، والإرسال — ونعيد لك النتيجة.

الحد الأدنى. أي مطوّر يستطيع إرسال طلب POST بسيط إلى الـ API. لدينا أمثلة جاهزة بلغات: PHP, JavaScript, Python, cURL — ويمكنك أيضاً استخدام لوحة التحكم لإصدار فواتير يدوياً للاختبار.

نعم. الخدمة تستخدم بروتوكولات ZATCA الرسمية (UBL 2.1, XAdES, TLV QR) وتدعم كل المراحل: Sandbox للتجربة، Simulation للاختبار، وProduction للإنتاج. كل الشهادات تُصدر مباشرة من الهيئة.

بعد التسجيل، تدخل إلى لوحة تحكمك، تُكمل بيانات منشأتك (الرقم الضريبي، العنوان، الخ)، ثم تُدخل رمز OTP من بوابة الهيئة. نحن نولّد CSR، نطلب شهادة الامتثال، وبعد اختبارها نُصدر شهادة الإنتاج — كل ذلك تلقائياً.

الفاتورة العادية (B2B) تتطلب Clearance من الهيئة قبل تسليمها للعميل. أما المبسّطة (B2C) فيتم Reporting لها خلال 24 ساعة من إصدارها. الـ API يكتشف النوع تلقائياً ويختار الإجراء المناسب.

نعم. الـ API يدعم: فاتورة ضريبية (388)، إشعار دائن (381)، وإشعار مدين (383)، لكل من النوعين العادي والمبسّط.

متوسط زمن الاستجابة أقل من 500 مللي ثانية للفواتير المبسّطة، و1.5 ثانية للفواتير العادية (تشمل وقت الاستجابة من سيرفرات الهيئة).

الرد الكامل من الهيئة (مع رسائل الخطأ) يُحفظ في قاعدة البيانات ويظهر في لوحة التحكم. يمكنك تعديل الفاتورة وإعادة إرسالها بسهولة.

كل طلب API يُوقَّع بـ HMAC-SHA256 مع نافذة زمنية لمنع إعادة الإرسال. الشهادات والأسرار تُشفَّر في قاعدة البيانات. كل عميل لديه مجلد منفصل لشهاداته. ودعم قوائم IP مسموح بها.

بالتأكيد. الباقة المجانية تتيح لك إصدار 50 فاتورة شهرياً في بيئة Sandbox/Simulation — مناسبة لاختبار التكامل الكامل قبل الإنتاج.

نعم، يمكنك الترقية، التخفيض، أو إلغاء الاشتراك من لوحة التحكم في أي وقت. لا توجد عقود طويلة المدى.

باقة الأعمال تشمل دعماً فنياً عبر البريد الإلكتروني خلال يوم عمل. الباقة المؤسسية تشمل دعماً 24/7 ومدير حساب مخصص.