CSID (معرّف الختم التشفيري)
CSID هو شهادة تصدرها زاتكا لكل جهاز فوترة (EGS) باسم المنشأة، يوقّع بها الجهاز فواتيره ويتصل بها مع بوابة فاتورة.
CSID اختصار Cryptographic Stamp Identifier. تعريف الهيئة: معرّف فريد يربط وحدة حل الفوترة بجهة موثوقة تقدر تأكد هوية المكلّف وتميّز وحدته. عملياً هو شهادة X.509 تصدرها الهيئة لجهاز واحد مقابل طلب CSR، ومعها secret.
وين يستخدم؟ في الـ XML: الشهادة نفسها داخل ds:X509Certificate في التوقيع، والمُصدر والرقم التسلسلي في xades:IssuerSerial، والمفتاح العام في الوسم 8 من الـ QR. وفي الـ API: الحقل binarySecurityToken مع الـ secret هم اسم المستخدم وكلمة المرور (HTTP Basic) في كل طلب.
فيه نوعين: شهادة امتثال للاختبار، وشهادة إنتاج للفواتير النظامية. وكل بيئة لها شهاداتها، فشهادة بوابة المطورين ما تشتغل في الإنتاج. وانتبه إن binarySecurityToken مرمّز base64 مرتين: فكّه مرة وحدة قبل ما تحطه في ds:X509Certificate.
ماثل يوقّع كل فاتورة بشهادة الجهاز. مع device_token الشهادة والمفتاح داخل التوكن المشفّر، ولو تبيها بنفسك أرسل include_credentials: true وقت التسجيل وترجع لك private_key وbinary_security_token وsecret. وقبل certificate_expires_at جدّدها من /api/v1/onboarding/renew.
مثال
"csid": {
"private_key": "…",
"binary_security_token": "…",
"secret": "…"
}
أسئلة شائعة
هل أقدر أطلّع CSID عن عميلي؟
لا بدون OTP من حسابه في منصة فاتورة، لأن الشهادة تطلع باسم المنشأة نفسها.
هل CSID واحد يكفي لكل أجهزة المنشأة؟
لا. كل جهاز (EGS) يتسجّل لحاله وياخذ شهادته وسلسلة فواتيره الخاصة.
قواعد الهيئة المرتبطة
مصطلحات قريبة
- شهادة الامتثال (Compliance CSID)
- شهادة الإنتاج (Production CSID)
- EGS (وحدة حل الفوترة الإلكترونية)
- CSR (طلب توقيع الشهادة)
- الختم التشفيري (XAdES / ECDSA)
خلّ ماثل يتعامل مع هذا عنك
ماثل يوقّع الفاتورة ويرسلها للهيئة ويمسك العدّاد والهاش بطلب واحد، ويرجّع الـ PDF مع رمز QR.
جرّب ماثل بدون تسجيل توثيق ماثل API