شهادة الامتثال (Compliance CSID)
شهادة الامتثال هي أول شهادة يطلبها الجهاز من زاتكا مقابل CSR وOTP، ويستخدمها لفحوصات الامتثال قبل ما ياخذ شهادة الإنتاج.
شهادة الامتثال (Compliance CSID) أول خطوة في تسجيل الجهاز. الجهاز يرسل طلب CSR مع رمز OTP من حساب المنشأة، والهيئة ترد بشهادة امتثال.
الطلب نفسه: POST على /compliance، والـ OTP في ترويسة اسمها otp مع accept-version: V2، والجسم فيه csr بترميز base64. ما فيه مصادقة Basic لأن الجهاز ما عنده شهادة للحين. الرد فيه binarySecurityToken وsecret وrequestID.
بهالشهادة يرسل الجهاز عيّنات فحوصات الامتثال على /compliance/invoices، ولما تنجح يطلب شهادة الإنتاج بالـ requestID. وش يغلط؟ OTP منتهي (صلاحيته ساعة)، أو CSR مرفوض برسالة Invalid-CSR، أو إرسال requestID بصيغة غلط: البوابة ترجعه رقم JSON بينما طلب شهادة الإنتاج ياخذه نص.
في ماثل هذي خطوة compliance_csid داخل POST /api/v1/onboarding، وتصير تلقائي بدون ما تكتب CSR ولا تتعامل مع الترويسات. لو فشلت يرجع 422 onboarding_failed ومعه step: "compliance_csid".
مثال
POST /compliance
otp: 123345
accept-version: V2
{"csr": "<base64 CSR>"}
أسئلة شائعة
هل أقدر أرسل فواتير حقيقية بشهادة الامتثال؟
وظيفتها فحوصات الامتثال. الفواتير النظامية تتوقّع وتُرسل بشهادة الإنتاج اللي تطلع بعد نجاح الفحوصات.
ليش رجع Invalid-CSR؟
غالباً الـ CSR فيه امتدادات زيادة مثل keyUsage، أو قيم غير ASCII داخل subjectAltName، أو قالب شهادة لا يناسب البيئة.
مصطلحات قريبة
- CSID (معرّف الختم التشفيري)
- شهادة الإنتاج (Production CSID)
- OTP (رمز التسجيل من منصة فاتورة)
- CSR (طلب توقيع الشهادة)
- فحوصات الامتثال
خلّ ماثل يتعامل مع هذا عنك
ماثل يوقّع الفاتورة ويرسلها للهيئة ويمسك العدّاد والهاش بطلب واحد، ويرجّع الـ PDF مع رمز QR.
جرّب ماثل بدون تسجيل توثيق ماثل API