تخطَّ إلى المحتوى
الفوترة الإلكترونية في السعودية (فاتورة)

ربط جهاز الإصدار وشهادة CSID

الخطوات التي يحصل بها جهاز الإصدار على شهادة ختم من الهيئة: مفتاح وطلب شهادة ورمز OTP وفحص امتثال ثم شهادة الإنتاج.

الشهادة (CSID، وتسميها الضوابط «الرمز التعريفي المحدد لأختام التشفير») تربط جهاز الإصدار بالرقم الضريبي للمكلف. تبدأ العملية في بوابة فاتورة حيث يولّد المكلف رمز OTP (حتى 100 رمز في الطلب، كل رمز صالح ساعة، ولا واجهة برمجية لطلبه).

يولّد الجهاز زوج مفاتيح وطلب شهادة PKCS#10 فيه: الاسم الشائع للوحدة، والرقم التسلسلي بالصيغة «1-المصنّع|2-الطراز|3-الرقم»، والرقم الضريبي، واسم الفرع، واسم المكلف، والدولة، ونوع الفواتير بخريطة أربع خانات (1100 = ضريبية ومبسطة)، والموقع، والقطاع. يُرسل الطلب مع الرمز فيعود بشهادة امتثال.

بشهادة الامتثال يرسل الجهاز مستندات نموذجية للفحص؛ تذكر الإرشادات الفنية ثلاثة لكل نوع (فاتورة وإشعار مدين وإشعار دائن). إذا نجحت يطلب شهادة الإنتاج برقم طلب الامتثال، فيختم بها ويبلّغ بعد ذلك. الشهادة صالحة حتى 60 شهراً، وتجديدها يحتاج رمز OTP جديداً ومفتاحاً جديداً.

تشترط الضوابط أن يُعلَّم مفتاح التوقيع غير قابل للاستخراج، أو أن يُشفَّر القرص إن خُزّن المفتاح ببرنامج؛ ونقل المفتاح إلى جهاز آخر من الوظائف المحظورة.

في جوداكس

مبني جزئيًا

الربط مبني: يولّد البرنامج المفتاح وطلب الشهادة بنفسه، ويطلب شهادة الامتثال، ويفحص مستنداً نموذجياً واحداً (فاتورة مبسطة)، ثم يطلب شهادة الإنتاج، وقد نجح ذلك في بيئة المطورين. لكنه يطلب نوع الفواتير 1100 (ضريبية ومبسطة) مع أن الضريبية غير مبنية، ويفحص نموذجاً واحداً بدل ثلاثة لكل نوع؛ لم يُجرَّب ذلك في بيئة المحاكاة أو الإنتاج حيث قد ترفض المنصة إصدار شهادة الإنتاج قبل اكتمال الفحوص. حقول طلب الشهادة تتبع ملف الإعداد النموذجي للهيئة (SN وUID وtitle داخل الاسم البديل) لا جدول معيار الأمان (organizationIdentifier). التجديد غير مبني. المفتاح يُخزن داخل ملف البيانات المشفر.

crates/jdx-einvoice-sa/src/unit.rs

الخطوات

  1. ولّد رمز OTP من بوابة فاتورة.
  2. ولّد على الجهاز مفتاحاً خاصاً وطلب شهادة بقالب البيئة المطلوبة.
  3. أرسل الطلب والرمز إلى /compliance لتحصل على شهادة امتثال وسرّها.
  4. أرسل المستندات النموذجية الموقّعة إلى /compliance/invoices حتى تنجح.
  5. أرسل رقم طلب الامتثال إلى /production/csids لتحصل على شهادة الإنتاج.

أسئلة وأجوبة

هل تعمل شهادة بيئة المطورين في الإنتاج؟

لا. شهادات بيئة المطورين للاختبار فقط ولا تعمل في البيئة الفعلية.

ماذا يحدث لشهادات المكلف إذا انضم إلى مجموعة ضريبية؟

تُلغى تلقائياً، ويجب ربط الأجهزة من جديد تحت رقم المجموعة.

صفحات ذات صلة

مفاهيم ذات صلة

الفوترة الإلكترونية في السعودية (فاتورة)

المصادر

  1. Security Features Implementation Standards to the E-Invoicing resolution dated 2023-05-19 (v1.2) — ZATCA
  2. E-invoicing Detailed Technical Guidelines (vVersion 2) — ZATCA
  3. Developer Portal Manual (vVersion 3) — ZATCA
  4. FATOORA Portal User Manual (vVersion 3) — ZATCA
  5. Integration Sandbox API pages (Swagger): reporting, clearance, compliance, production CSID, renewal (ve-Invoicing Sandbox Release 2.1.0 (page lists 2.1.1 as latest)) — ZATCA
  6. الضوابط والمتطلبات والمواصفات الفنية والقواعد الإجرائية اللازمة لتنفيذ أحكام لائحة الفوترة الإلكترونية (قرار المحافظ رقم 62738 وتاريخ 1443/11/23هـ) (vfile dated 20230519 (decision 62738)) — ZATCA

تاريخ المراجعة: 4 نوفمبر 2026. ما يخص جوداكس مأخوذ من شيفرة البرامج نفسها.