بيئات زاتكا الثلاث (المطورين، المحاكاة، الإنتاج)
زاتكا عندها ثلاث بيئات: بوابة المطورين للتجربة، والمحاكاة ببيانات المنشأة بدون أثر نظامي، والإنتاج للفواتير النظامية. ولكل بيئة شهاداتها.
الهيئة تشغّل ثلاث بوابات API، وكل وحدة تصدر شهاداتها، فشهادة من بيئة ما تشتغل في الثانية:
بوابة المطورين (developer-portal): للتجربة، تقبل OTP تجريبي منشور، فتقدر تمشي التسجيل كامل بدون حساب منشأة. المحاكاة (simulation): ببيانات المنشأة الحقيقية وOTP من حسابها، بدون أثر نظامي، وقالب الشهادة فيها PREZATCA-Code-Signing. الإنتاج (core): الفواتير النظامية، بقالب ZATCA-Code-Signing.
وش يغلط؟ أشهر غلط: شهادة من بيئة على بوابة بيئة ثانية، أو CSR بقالب ما يناسب البيئة. والعيّنات ذات التواريخ القديمة تطلع تحذير BR-KSA-98، لأن القاعدة تقارن تاريخ الإصدار بالوقت الحالي.
في ماثل تختار البيئة بالحقل environment: sandbox (بوابة المطورين) أو simulation أو production، والـ CSID لازم يكون من نفس البيئة. على sandbox بدون seller وcsid، ماثل يرسل الفاتورة باسم منشأة تجريبية ويرجع رد الهيئة الحقيقي. بوابة المطورين والمحاكاة مجانية في ماثل، والإنتاج يحتاج باقة.
مثال
"sandbox" => "https://gw-fatoora.zatca.gov.sa/e-invoicing/developer-portal"
"simulation" => "https://gw-fatoora.zatca.gov.sa/e-invoicing/simulation"
"production" => "https://gw-fatoora.zatca.gov.sa/e-invoicing/core"
أسئلة شائعة
هل أقدر أستخدم شهادة المحاكاة في الإنتاج؟
لا. كل بيئة تصدر شهاداتها، وتحتاج تسجّل الجهاز من جديد في الإنتاج بـ OTP جديد.
وش الفرق بين بوابة المطورين والمحاكاة؟
بوابة المطورين للتجربة بقيمة OTP منشورة، والمحاكاة ببيانات منشأتك الحقيقية وOTP من حسابها، والاثنين بدون أثر نظامي.
قواعد الهيئة المرتبطة
مصطلحات قريبة
- منصة فاتورة (Fatoora)
- OTP (رمز التسجيل من منصة فاتورة)
- CSR (طلب توقيع الشهادة)
- CSID (معرّف الختم التشفيري)
- شهادة الإنتاج (Production CSID)
خلّ ماثل يتعامل مع هذا عنك
ماثل يوقّع الفاتورة ويرسلها للهيئة ويمسك العدّاد والهاش بطلب واحد، ويرجّع الـ PDF مع رمز QR.
جرّب ماثل بدون تسجيل توثيق ماثل API