شهادة الإنتاج (Production CSID)

من فريق ماثل، مبني على مواصفات الهيئة و SDK 3.4.8 · آخر تحديث

شهادة الإنتاج هي الشهادة اللي يوقّع بها الجهاز فواتيره النظامية ويرسلها لزاتكا، تطلع بعد نجاح فحوصات الامتثال وتُجدّد بـ OTP جديد.

شهادة الإنتاج (Production CSID) هي الشهادة اللي يشتغل فيها الجهاز يومياً: يوقّع بها كل فاتورة، ويتصل بها مع بوابة الهيئة للاعتماد والتبليغ.

تطلع بعد نجاح فحوصات الامتثال: POST على /production/csids والجسم فيه compliance_request_id (الـ requestID اللي رجع مع شهادة الامتثال)، والمصادقة Basic بشهادة الامتثال وsecret حقها. الرد binarySecurityToken وsecret جديدين.

بعدها كل طلب على /invoices/clearance/single أو /invoices/reporting/single يتصادق بشهادة الإنتاج. وللشهادة تاريخ انتهاء، والتجديد PATCH على /production/csids بـ CSR جديد وOTP جديد، والمصادقة بالشهادة الحالية. الأخطاء الشائعة: شهادة من بيئة ثانية (المحاكاة مثلاً) على بوابة الإنتاج، أو ترك الشهادة تنتهي بدون تجديد.

في ماثل تطلع شهادة الإنتاج آخر خطوة في POST /api/v1/onboarding، والرد فيه certificate_expires_at. وقبل هالتاريخ أرسل device_token مع OTP جديد على /api/v1/onboarding/renew، ويرجع لك توكن جديد وسلسلة الفواتير (ICV وPIH) تكمل نفسها.

مثال

POST /production/csids
accept-version: V2
Authorization: Basic <compliance token:secret>

{"compliance_request_id": "1785585220536"}

أسئلة شائعة

إذا جدّدت الشهادة، يبدأ العدّاد من جديد؟

لا. في ماثل التجديد يحافظ على السلسلة: العدّاد والـ PIH ينتقلون للتوكن الجديد.

هل أحتاج OTP للتجديد؟

إيه. التجديد يحتاج CSR جديد وOTP جديد من منصة فاتورة.

مصطلحات قريبة

خلّ ماثل يتعامل مع هذا عنك

ماثل يوقّع الفاتورة ويرسلها للهيئة ويمسك العدّاد والهاش بطلب واحد، ويرجّع الـ PDF مع رمز QR.

جرّب ماثل بدون تسجيل توثيق ماثل API