ربط المرحلة الثانية للفوترة الإلكترونية

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

يتطلب هذا وحدة ترخيص المرحلة الثانية. ويقوم معالج الربط في الإعدادات بالعمل التقني؛ ومهمتك أنت تقديم بيانات دقيقة وكلمة المرور المؤقتة.

قبل أن تبدأ

جهّز ما يلي:

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

نفّذ هذا مرة لكل جهاز. فلكل جهاز مفاتيحه وشهادته الخاصة.

تمرّن في بيئة المحاكاة أولاً

يعرض المعالج ثلاث بيئات: التجربة والمحاكاة والإنتاج.

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

الخطوات الست

١. بيانات البائع

اسم الشركة والرقم الضريبي والسجل التجاري والعنوان. انسخها من تسجيلك لدى الهيئة لا من ذاكرتك — فمن هنا تبدأ معظم حالات الفشل.

٢. البيئة والفرع

اختر البيئة، ثم أدخل بيانات الفرع والنشاط لهذا الجهاز. وإن كان لديك أكثر من جهاز، فامنح كلاً منها بيانات تميّزه، حتى يمكن تتبع الفاتورة المرفوضة إلى جهاز بعينه.

٣. إنشاء طلب الشهادة

راجع أولاً مربع إعدادات CSR (نفس حقول csr.common.name وcsr.serial.number وcsr.organization.* في أدوات زاتكا) ثم أنشئ الطلب.

ينشئ البرنامج مفتاحاً خاصاً وطلب توقيع شهادة على الجهاز نفسه.

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

٤. شهادة الامتثال

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

كلمة المرور المؤقتة قصيرة العمر. ولّدها وأنت عند هذه الخطوة لا قبلها، وإلا انتهت صلاحيتها قبل أن تستخدمها.

٥. فواتير الامتثال النموذجية

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

لا شيء عليك هنا سوى المتابعة. وإن رُفضت فاتورة نموذجية، فالخطأ يشير في الغالب إلى بيان من بيانات البائع في الخطوة الأولى لا يطابق سجل الهيئة.

٦. شهادة الإنتاج

في المحاكاة هذه ما زالت شهادة جهاز للمحاكاة وليست إيداعاً حياً. بعد نجاح العينات لن تقبل فاتورة مزيداً من الفواتير المبسطة على واجهة الامتثال — يجب طلب هذه الشهادة قبل إرسال فواتير نقطة البيع.

وفي بيئة الإنتاج هي شهادة الجهاز الحية.

ولا سبيل لتجاوز هذه الخطوة. فشهادة الامتثال من الخطوة الرابعة تُرفض برمز 401 على واجهتي الإبلاغ والإجازة، في المحاكاة كما في الإنتاج تماماً، فتبقى الفواتير دون إرسال حتى تستقر هذه الشهادة على الجهاز.

تغيير البيئة

اختر البيئة في الخطوة الثانية وأنشئ CSR جديداً في الخطوة الثالثة. هذا هو التبديل كله — ولا يوجد زر منفصل له.

اختيار بيئة مختلفة وإنشاء CSR جديد يُنهي الربط السابق: تُمحى الشهادات ويُسقط كل ما ينتظر الإرسال إلى البوابة القديمة. وتحتفظ كل فاتورة بالبيئة التي وُقّعت لها، فلا يمكن أبداً أن تُودع فاتورة اختبار من المحاكاة كفاتورة ضريبية حية لاحقاً. وتبقى تلك الفواتير في قائمة المستندات موسومة بالبيئة القديمة.

ويتذكر المعالج أين توقفت، فإن قوطعت تستطيع المتابعة بدل البدء من جديد.

ما يحدث في كل عملية بيع بعد ذلك

متى وُجدت شهادة الإنتاج على الجهاز، تمر كل عملية بيع مكتملة بهذه السلسلة:

1. يُبنى مستند XML بمعيار UBL 2.1 للفاتورة.
2. يُوقَّع بخوارزمية ECDSA بمفتاح الجهاز، ويُضمَّن التوقيع والشهادة فيه.
3. يُوسَّع رمز QR بـالأوسمة من ٦ إلى ٩ — بصمة المستند والتوقيع والمفتاح العام وختم الشهادة — فوق أوسمة المرحلة الأولى الخمسة.
4. تُرسل الفاتورة الضريبية للتصديق تزامنياً. ولا يمكن طباعتها حتى تصدّقها الهيئة.
5. تُوقَّع الفاتورة المبسطة وتوضع في طابور الإبلاغ غير المتزامن.

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

ويُحفظ ملفا XML الموقّع وغير الموقّع مع المستند، وتستطيع تنزيل الموقّع من شاشة المستندات متى طُلب.

الحالات وماذا تفعل حيالها

الحالة	المعنى	الإجراء
بلا	المرحلة الثانية غير مفعّلة لهذا المستند	لا شيء
قيد الانتظار	موقّعة وتنتظر الإرسال أو الرد	انتظر؛ وأعد المحاولة إن طال بقاؤها
مصدّقة	فاتورة ضريبية صدّقتها الهيئة	لا شيء. الطباعة آمنة
مُبلَّغ عنها	فاتورة مبسطة تم الإبلاغ عنها بنجاح	لا شيء
مقبولة بتنبيه	مقبولة لكن مع ملاحظات تحقق	اقرأ التنبيه؛ وعالج سببه
فاشلة	مرفوضة أو تعذّر الوصول	افحص ثم أعد المحاولة

صفِّ شاشة المستندات بحسب حالة الإرسال لترى كل ما في حالة واحدة دفعة واحدة.

حين يتعذّر الوصول إلى منصة فاتورة

يُبلَّغ عن الفواتير المبسطة بعد إصدارها، فانقطاع الاتصال لا يوقف بيعك. والإرسال الفاشل يدخل صندوق الصادر وتُعاد محاولته، وتستطيع فرض الإعادة من المستند.

أما الفواتير الضريبية فهي الاستثناء، لأن التصديق يجب أن يسبق الإصدار. فإن كانت المنصة متوقفة انتظرت تلك الفواتير. وهذا حكم النظام لا قصور في البرنامج، وهو سبب إضافي لألا تضع رقماً ضريبياً على عميل لا يحتاج فواتير ضريبية فعلاً.

اجعلها عادة

مرة أسبوعياً، صفِّ المستندات بحالة إرسال فاشلة وأفرغ القائمة. فحفنة من الإخفاقات القديمة مشكلة صغيرة؛ أما سنة منها فلا.

أين تحدث الأخطاء عادةً

• بيانات بائع لا تطابق سجل الهيئة بدقة. وهذا السبب الأشيع بفارق كبير.
• Invalid-CSR في المحاكاة (الخطوة 4). يرسل البرنامج الطلب مرتين، مرة لكل قالب شهادة، فهذا الخطأ يعني أن قيمة أحد الحقول غير صحيحة لا أن التنسيق خاطئ: يجب أن يكون الرقم الضريبي هو نفسه الذي صدر له الرمز المؤقت، وأن يطابق اسم المكلف سجل فاتورة، وأن يكون السجل التجاري في اسم الوحدة تابعاً لذلك الرقم.
• Invalid-CSR عند شهادة الإنتاج (الخطوة 6). هذا الطلب يرسل {"compliance_request_id":"<id>"} كنص وليس CSR، فالخطأ يعني أن فاتورة ترفض ترقية الشهادة التي أصدرتها هي نفسها في الخطوة الرابعة. وإعادة المحاولة بالمعرّف ذاته لن تغيّر الجواب. خذ OTP جديداً ونفّذ الخطوات 4 و5 و6 في جلسة واحدة. وإن تكرر، أرسل معرّف الطلب والرقم الضريبي إلى sp_support@zatca.gov.sa؛ فقد تكرر هذا على بوابة المحاكاة لمنشآت تربط في الإنتاج دون مشكلة.
• NOT_COMPLIANT مع STATUS_INVALID_SIGNATURE في الخطوة 6. تتحقق جهة إصدار الشهادات لدى الهيئة من توقيع الـ CSR نفسه قبل إصدار الشهادة، وواجهة الامتثال لا تفعل. فإن ظهر هذا، فالـ CSR على الجهاز غير صالح: أنشئ واحداً جديداً في الخطوة الثالثة وأعد الربط برمز OTP جديد.
• كلمة مرور مؤقتة منتهية. ولّدها في الخطوة الرابعة لا قبلها.
• البيئة الخاطئة. الربط في بيئة التجربة وتوقّع عمل شهادات الإنتاج.
• جهاز أُعيد تنصيبه بلا نسخة احتياطية. فمفاتيح الجهاز تذهب معه ويلزم إعادة الربط.
• بيع بخصم مرفوض بـ BR-CO-15 / BR-32. خصم السطر لا يُرسل كخصم على مستوى المستند. أعد محاولة الفاتورة الفاشلة من المستندات بعد هذا التصحيح على الجهاز؛ ففاتورة ستستلم XML جديداً يكون فيه الإجمالي شامل الضريبة مساوياً للصافي زائداً الضريبة.

مسؤوليتك

ينفّذ البرنامج المواصفة الفنية. أما بيانات تسجيلك ونسب ضريبتك وإقراراتك فتبقى مسؤوليتك. تحقق في بيئة المحاكاة قبل الانتقال إلى الإنتاج، وإن لم تكن متأكداً من شمولك بالمرحلة فاسأل محاسبك بدل التخمين.