تكاملات ZATCA ونفاذ ومدى وأنظمة ERP
نربط الأنظمة التي لا يمكن لمنتج سعودي أن ينطلق بدونها: الفوترة الإلكترونية من المرحلة الثانية لهيئة الزكاة والضريبة والجمارك، والهوية الوطنية عبر نفاذ، والدفع ببطاقات مدى، ونظام ERP أو CRM الذي يعمل عليه فريق المالية لديك. نبني التكامل ونختبره في بيئة المورّد ونراقبه بعد الإطلاق.
يُسعّر كل تكامل على حدة، وله اختبار قبول خاص به ومالك واضح في الخطة.
التكامل هو ما يحدد تاريخ الإطلاق
قد تُصمم البوابة وتُبنى وتُراجع في الموعد، ثم تبقى معلّقة أسابيع لأن شهادة الفوترة الإلكترونية لم تصدر، أو لأن المُيسّر لم يعتمد حساب التاجر، أو لأن مورّد نظام ERP لم يفتح بيئة اختبار.
نخطط للتكاملات أولاً لا أخيراً. قبل بدء التصميم نعرف أي نظام هو مصدر الحقيقة، وأي بيانات اعتماد موجودة، ومن يملكها، وما هو اختبار القبول.
هذا الترتيب هو ما يجعل مشروعاً بأربعة تكاملات يحافظ على موعده.
ما نربطه
أربعة أنظمة، وأربع طرق مختلفة للفشل
لكل نظام تسجيله وبيئة اختباره وطريقته في الفشل داخل الإنتاج. نتعامل معها كأربع عمليات تسليم منفصلة داخل مشروع واحد.
الفوترة الإلكترونية — المرحلة الثانية من ZATCA
التسجيل في منصة فاتورة، والختم التشفيري، وملف UBL 2.1، ورموز QR، والاعتماد أو الإبلاغ عبر واجهات الهيئة.
- توليد CSR وشهادة الامتثال ثم شهادة الإنتاج
- اعتماد الفاتورة الضريبية قبل وصولها إلى المشتري
- الإبلاغ عن الفاتورة المبسطة خلال 24 ساعة
- طابور إعادة محاولة يحفظ الفاتورة عند انقطاع الخدمة
نفاذ — الهوية الوطنية
دخول عبر مسار الدخول الوطني الموحد: يعرّف المستخدم عن نفسه، ويعتمد طلباً من رقمين في تطبيق نفاذ، فيصل إلى نظامك تعريف موثّق للهوية.
- OAuth 2.0 وOIDC مع خدمة الدخول الوطني الموحد
- ربط الأدوار بالهوية العائدة
- إدارة الجلسة والخروج بالعربية والإنجليزية
- مسار بديل لمن لا يملك حساب نفاذ
مدى والدفع بالبطاقات
مدفوعات بالبطاقة عبر مُيسّر أو بوابة دفع سعودية مرخّصة، مع 3-D Secure والتسوية التي يحتاجها فريق المالية.
- مدى وفيزا وماستركارد عبر بوابة واحدة
- مصادقة 3-D Secure
- معالجة إشعارات الاسترداد والتحصيل الجزئي
- تقرير تسوية يطابق دفترك
ERP وCRM
تقرأ البوابة من نظامك الأساسي بدل الاحتفاظ بنسخة ثانية. حيث توجد واجهة برمجية نستخدمها، وحيث لا توجد نستخدم مزامنة مجدولة أو رابط قاعدة بيانات آمن.
- SAP أو Microsoft Dynamics أو Odoo أو Zoho أو نظام مخصص
- خريطة حقول معتمدة كتابةً قبل البناء
- كتابة آمنة التكرار فلا تنشئ الإعادة طلباً مزدوجاً
- مراقبة تسمّي السجل الفاشل لا الواجهة فقط
كيف يُسلّم
كيف يصل التكامل إلى الإنتاج
أربع بوابات في كل تكامل، سواء كان فاتورة إلكترونية أو دفعة.
- 01
خريطة الوصول
نسرد كل نظام ومن يملكه وأي بيانات اعتماد موجودة وأيها يحتاج طلباً. هنا تظهر معظم التأخيرات قبل أن تكلّف أسبوعاً.
- 02
بيئة الاختبار أولاً
نبني على بيئة اختبار المورّد ونسجّل حالات القبول معك. العرض على بيانات وهمية لا يُحتسب.
- 03
التسوية
تُطابق كل كتابة مع النظام الأساسي: الإجماليات والحالات والتكرار. تعتمد المالية يوماً كاملاً من العمليات قبل الإطلاق.
- 04
المراقبة والتسليم
تنبيهات على الاستدعاءات الفاشلة والشهادات المنتهية وعمق الطابور. تستلم دليل التشغيل وقائمة مالكي بيانات الاعتماد عند التسليم.
أين تفشل التكاملات بعد الإطلاق
لا شيء منها مشكلة برمجية في اليوم الأول. وكلها مخطّط لها.
- انتهاء الشهادات
- تنتهي شهادات ZATCA وبيانات اعتماد الدفع. نضع تاريخ الانتهاء في نظام المراقبة بإنذار قبل 30 يوماً، لا في جدول بيانات.
- بيئة الاختبار ليست الإنتاج
- تختلف حدود المعدل وأحجام البيانات ورموز الأخطاء. نشغّل تجربة إنتاج بعدد محدود من العمليات الحقيقية قبل التحويل الكامل.
- الكتابة المزدوجة
- انتهاء المهلة لا يعني فشل الكتابة. كل استدعاء يحمل مفتاح منع تكرار فلا تنشئ الإعادة فاتورة أو طلباً ثانياً.
- انحراف الخريطة
- يضيف نظام ERP حقلاً أو يغيّر رمزاً ضريبياً. خريطة الحقول محفوظة بإصدارات في المستودع، فتُراجع التغييرات بدل ترقيعها في الإنتاج.
تكاملات تعمل في الإنتاج
بوابات الدفع سلّمناها في ضامن، منصة الثقة والضمان للتجارة الإلكترونية السعودية، ووفرة، سوق سعودي للبائعين المحليين. وتُسلّم تكاملات ZATCA ونفاذ ومدى وأنظمة ERP بالطريقة نفسها: نطاق محدد، واختبار على بيئة المورّد، ومراقبة بعد الإطلاق.
- أنواع تكاملات سلّمناها: الفوترة والهوية والدفع وERP
- 4
- منصتان سعوديتان في أعمالنا ببوابة دفع مسلّمة
- 2
- أسبوعاً لإصدار أول من البوابة بتكامل واحد من الانطلاق
- 6–12
المشروعان مدرجان في أعمالنا مع التقنيات التي سلّمناها.
أسئلة يطرحها المشترون قبل تحديد النطاق
هل تتكاملون مع الفوترة الإلكترونية للمرحلة الثانية من ZATCA؟
نعم. نتولى التسجيل في منصة فاتورة، وتوليد CSR وشهادة الامتثال ثم شهادة الإنتاج، وملف UBL 2.1، ورموز QR، والاعتماد أو الإبلاغ. اختبار القبول فاتورة حقيقية تعتمدها الهيئة، لا استجابة من بيئة اختبار.
هل يمكن ربط نظام ERP بلا واجهة برمجية؟
غالباً. نستخدم مزامنة مجدولة على مخطط وسيط، أو رابط قاعدة بيانات آمن، أو تبادل ملفات حيث يدعمه المورّد. يُكتب القيد في النطاق قبل البناء.
من يملك بيانات اعتماد التكامل؟
أنت. الشهادات ومفاتيح الواجهات وحسابات المُيسّر تُسجّل باسمك. نعمل بوصول مفوّض ونسلّم قائمة مالكي بيانات الاعتماد عند الإطلاق.
كم يستغرق التكامل؟
يضيف التكامل الواحد عادة أسبوعين إلى أربعة أسابيع على بناء البوابة، وغالباً يكون تسجيل المورّد هو الأطول. موافقات ZATCA والمُيسّر تسير وفق جدولها، لذلك نبدأها في الأسبوع الأول.
ماذا يحدث إذا تعطّل ZATCA أو بوابة الدفع؟
تدخل الاستدعاءات طابور إعادة محاولة بفاصل متزايد، وتبقى الفاتورة أو الدفعة في حالة معلّقة يراها فريقك. لا يُعتبر أي شيء مكتملاً حتى يؤكده النظام الآخر.
هل تعملون مع مورّد التكامل الحالي لدينا؟
نعم. يمكننا تولّي تكامل قائم أو مراجعته أو العمل إلى جانب المورّد الذي يدير نظام ERP. تغطي خريطة الوصول من يفعل ماذا حتى لا يكتب فريقان في الحقل نفسه.
أرسل الأنظمة ونرسم خريطة التكامل
أخبرنا بالأنظمة التي يجب أن تتحدث مع بعضها ومن يملك كل واحد منها. نعود إليك بخريطة الوصول وخطوات تسجيل المورّد وخطة بتواريخ.
30 دقيقة، دون التزام. وإن لم يكن التكامل يستحق البناء سنقول ذلك.
