المدونة/الهندسة
الهندسة

التسجيل في منصة فاتورة خطوة بخطوة: طلب الشهادة ورمز OTP وشهادتا الامتثال والإنتاج

D
Dante21 نوفمبر 2026 · قراءة 6 دقائق
التسجيل في منصة فاتورة خطوة بخطوة: طلب الشهادة ورمز OTP وشهادتا الامتثال والإنتاج

خطوة بخطوة · تم التحقق في 21 نوفمبر 2026

تسجيل جهاز في منصة فاتورة يمر بـ 7 خطوات: إنشاء مفتاح، وبناء طلب الشهادة CSR، والحصول على رمز OTP صالح لساعة من بوابة فاتورة، وطلب شهادة الامتثال، واجتياز فحوص الامتثال، وطلب شهادة الإنتاج، ثم التشغيل.

كل جهاز كاشير أو نظام ERP أو تطبيق يصدر فواتير (وحدة إصدار) يُسجَّل وحده. نفّذنا هذا المسار كاملاً على البيئة التجريبية للهيئة من أجل تجربتنا الحية للمرحلة الثانية، وهذا هو الترتيب والحقول المهمة والأخطاء التي تكلّف الفرق أياماً.

رسم من آيفينيكس: الخطوات السبع لتسجيل وحدة إصدار في منصة فاتورة، من زوج المفاتيح إلى شهادة الإنتاج
مسار التسجيل من زوج المفاتيح إلى الفواتير الفعلية. تصميم: آيفينيكس.

يبدو الربط مع فاتورة ثقيلاً، لكن أغلبه إعداد دقيق لكل جهاز يتم مرة واحدة. في آيفينيكس بنينا تجربة عاملة للمرحلة الثانية واجتزنا فحوص البيئة التجريبية للهيئة، لذلك يتبع هذا الدليل ما حدث فعلاً، لا كلام النشرات.

ثلاث بيئات وثلاثة أسماء قوالب

تعطيك الهيئة ثلاث بيئات للتسجيل: ابدأ بالبيئة التجريبية، ثم تدرّب في المحاكاة، ثم انتقل إلى الإنتاج. واسم القالب داخل طلب الشهادة يخبر الهيئة أي بيئة تقصد.

البيئةلمنمصدر رمز OTPقالب الطلب
البيئة التجريبية (بوابة المطورين)للمطورين لاختبار الكودرمز ثابت للاختبار (123345 في اختباراتنا)TSTZATCA-Code-Signing
المحاكاةتجربة بالرقم الضريبي الحقيقيمن بوابة فاتورة للمحاكاةPREZATCA-Code-Signing
الإنتاجالفواتير الفعليةمن بوابة فاتورة، صالح لساعة واحدةZATCA-Code-Signing

خطوات التسجيل السبع

من جهاز جديد إلى فواتير فعلية

1
أنشئ زوج مفاتيح على الوحدة. كل وحدة إصدار (جهاز كاشير، نسخة ERP، خدمة سحابية) لها مفتاح خاص من نوع secp256k1. المفتاح لا يغادر الوحدة ولا تراه الهيئة.
2
ابنِ طلب الشهادة (CSR). يحمل الطلب هوية الوحدة: رقماً تسلسلياً بصيغة 1-الحل|2-الطراز|3-الرقم، والرقم الضريبي من 15 رقماً، وأنواع الفواتير التي تصدرها الوحدة (حقل title من 4 أرقام، مثلاً 1100 للضريبية والمبسطة)، والعنوان ونشاط المنشأة، واسم القالب حسب البيئة (الجدول أعلاه).
3
احصل على رمز OTP من بوابة فاتورة. سجّل الدخول بحسابك في الهيئة، واختر تسجيل وحدة أو جهاز جديد، وأدخل عدد الرموز التي تحتاجها، رمزاً لكل وحدة. كل رمز صالح لساعة واحدة (دليل مستخدم بوابة فاتورة)، فأنشئه حين تكون الوحدة جاهزة.
4
اطلب شهادة الامتثال (Compliance CSID). ترسل الوحدة الطلب مع رمز OTP إلى واجهة الامتثال في الهيئة، فتعيد الهيئة شهادة امتثال (binarySecurityToken) وكلمة سر ورقم طلب.
5
اجتز فحوص الامتثال. بشهادة الامتثال توقّع الوحدة وترسل نماذج لكل نوع ستصدره: فاتورة وإشعار دائن وإشعار مدين، ضريبية و/أو مبسطة. وترد الهيئة على كل نموذج بـ PASS أو WARNING أو ERROR. ويعرض مقال اختبارنا على البيئة التجريبية شكل كل نتيجة.
6
اطلب شهادة الإنتاج (Production CSID). برقم طلب الامتثال تطلب الوحدة شهادة الإنتاج، ومن بعدها توقَّع كل فاتورة بها.
7
ابدأ التشغيل. تُبلَّغ الفواتير المبسطة (للأفراد) إلى الهيئة خلال 24 ساعة من إصدارها. أما الفواتير الضريبية (بين المنشآت) فتُرسل للاعتماد ولا تُسلَّم للمشتري إلا بعد اعتماد الهيئة (الدليل الفني التفصيلي).

كيف يبدو طلب الشهادة؟

هذه الإعدادات التي صدرت بها شهادة تجربتنا في البيئة التجريبية. في الإنتاج تغيّر اسم القالب والرقم الضريبي والرقم التسلسلي، ويبقى الشكل نفسه.

# csr.cnf (sandbox example, the one our demo uses)
[req_ext]
1.3.6.1.4.1.311.20.2 = ASN1:PRINTABLESTRING:TSTZATCA-Code-Signing
subjectAltName = dirName:dir_sect
[dir_sect]
SN = 1-iFynx|2-WebDemo|3-ed22f1d8-...   # solution | model | unit serial
UID = 399999999900003                    # VAT registration number
title = 0100                             # invoice types this unit issues
registeredAddress = Gaza
businessCategory = Software

openssl ecparam -name secp256k1 -genkey -noout -out key.pem
openssl req -new -sha256 -key key.pem -config csr.cnf -out unit.csr

بعد حصول الوحدة على شهادة الإنتاج تُوقَّع كل فاتورة وتُحسب بصمتها وتُربط بالفاتورة التي قبلها، ويضاف إلى رمز QR أربعة حقول. فككنا رمزاً حقيقياً في شرح الحقول التسعة لرمز QR.

أخطاء تؤخر التسجيل

افحص هذه قبل إنشاء رموز OTP

1
انتهاء صلاحية OTP. الرمز يعيش ساعة واحدة. أنشئه بعد تركيب الوحدة وجاهزيتها، لا في اليوم السابق.
2
اسم قالب خاطئ. طلب البيئة التجريبية (TSTZATCA) لا يُسجَّل في الإنتاج. اجعل لكل بيئة إعداداً منفصلاً.
3
أنواع فواتير لا تتطابق. إذا قال الطلب إن الوحدة تصدر فواتير مبسطة فقط فلا ترسل نماذج ضريبية، والعكس صحيح.
4
المحاكاة ليست الإنتاج. الوحدات المسجلة في بوابة المحاكاة لا تنتقل تلقائياً، فسجّلها من جديد في الإنتاج (دليل المستخدم).
5
ضياع المفتاح الخاص. إذا ضاع مفتاح الوحدة أو تغيّر الجهاز فلا استرجاع. ألغِ الوحدة القديمة من البوابة (الإلغاء لا رجعة فيه) وسجّل الجديدة.
6
شهادة واحدة لعدة كاشيرات. كل وحدة تحتاج رمز OTP وشهادة خاصة بها. احسب عدد وحداتك قبل إنشاء الرموز.

إدارة الوحدات بعد التشغيل

تعرض بوابة فاتورة قائمة الحلول والأجهزة المسجلة، وتتيح تجديد شهادة الوحدة برمز OTP جديد أو إلغاء وحدة لم تعد تستخدمها (دليل مستخدم بوابة فاتورة). احتفظ بقائمة بالوحدات وأرقامها التسلسلية ومكان مفاتيحها، ليصبح تغيير جهاز كاشير مهمة عادية لا حالة طوارئ.

كيف تساعد آيفينيكس

تربط آيفينيكس أنظمة الكاشير وERP والمتاجر الإلكترونية والتطبيقات الخاصة بمنصة فاتورة، وتتولى تسجيل كل وحدة.

  • إنشاء المفاتيح وطلبات الشهادات وسكربتات التسجيل لكل بيئة.
  • فحوص الامتثال بنماذج فواتيرك الحقيقية قبل الموعد النهائي.
  • المراقبة والتجديد والإلغاء مع تغيّر فروعك وأجهزتك.

جرّب التجربة الحية · تواصل مع آيفينيكس · احسب تكلفة مشروعك

أسئلة شائعة

ما هي شهادة CSID في فاتورة؟

CSID اختصار لمعرّف الختم التشفيري، وهي الشهادة التي تصدرها الهيئة لوحدة إصدار واحدة لتوقّع بها الفواتير. هناك شهادة امتثال للاختبار وشهادة إنتاج للفواتير الفعلية.

كم مدة صلاحية رمز OTP في بوابة فاتورة؟

ساعة واحدة من إنشائه، بحسب دليل مستخدم بوابة فاتورة الصادر عن الهيئة.

هل أحتاج شهادة منفصلة لكل جهاز كاشير؟

نعم. تُسجَّل كل وحدة إصدار وحدها، بمفتاح ورمز OTP وشهادة خاصة بها.

هل أستطيع تجربة التسجيل دون رقم ضريبي حقيقي؟

نعم، في البيئة التجريبية لبوابة المطورين بالرقم التجريبي 399999999900003، وبهذه الطريقة صدرت شهادة تجربتنا الحية. أما المحاكاة فتستخدم رقمك الحقيقي.

ماذا يحدث إذا ألغيت وحدة؟

تتوقف شهادتها ولا تعود الوحدة قادرة على إصدار فواتير صحيحة. الإلغاء لا رجعة فيه، ولا يمكن إعادة الجهاز إلا بتسجيله كوحدة جديدة.

من يجب عليه ذلك، ومتى؟

كل مكلف تشمله موجة من موجات المرحلة الثانية. الموجة 25 تشمل من تجاوزت إيراداته الخاضعة للضريبة 187,500 ريال في أي سنة من 2022 إلى 2025، وموعد الربط 1 فبراير 2027 (الهيئة).

اقرأ أيضاً

تم التحقق في 21 نوفمبر 2026. المصادر: دليل مستخدم بوابة فاتورة؛ الدليل الفني التفصيلي للفوترة الإلكترونية؛ إعلان الموجة 25؛ وتجربة التسجيل الخاصة بنا.

🛡️ نشرة آيفينيكس الأمنية · كل أحدثغرات الأسبوع التي تهمّ شركات الخليج ومصر، في رسالة واحدة

كل يوم أحد: أخطر الثغرات والاختراقات المؤكدة، ومن المتأثر في السعودية والإمارات ومصر، وما الذي يجب تحديثه أولاً. مجانية، بالعربية والإنجليزية، ويمكنك إلغاء الاشتراك بنقرة.

تصفّح الأعداد السابقة →