- المنصة
- الفاتورة الإلكترونية (زاتكا)
- ما هي
- نظام الفوترة الإلكترونية لهيئة الزكاة والضريبة والجمارك، طُبّق في مرحلة إصدار ثم مرحلة ربط على دفعات من المكلّفين.
- ما يتطلبه التكامل
- إصدار فواتير مطابقة، وانضمام حل الفوترة، وهوية تشفيرية للجهاز أو الحل، واعتماد الفواتير أو الإبلاغ عنها عبر الواجهة المنشورة، والأرشفة.
- المصدر الرسمي
- zatca.gov.sa
دليل تخطيط
تخطيط تكامل أنظمة المؤسسات مع المنصات الرقمية السعودية
الفاتورة الإلكترونية لدى هيئة الزكاة والضريبة والجمارك، وهوية نفاذ، ومنصة اعتماد للمشتريات، وبيانات السجل التجاري في واثق: واجهات موثّقة، والتكامل مع أيٍّ منها برنامج هندسي معروف المراحل. يبيّن هذا الدليل تلك المراحل، من الانضمام إلى بيئة الاختبار إلى مسؤولية الإنتاج، ليُحدَّد نطاق العمل ويُطرح للشراء بدقة.
دليل تخطيط نُشر في 5 دقائق قراءة
01باختصار
ما الذي يتطلبه التكامل مع منصة وطنية فعلًا
تنشر كل منصة مواصفة، وإجراء انضمام، وبيئة اختبار. والعمل هو قراءة المواصفة كما نُشرت، والبناء على بيئة الاختبار بسلوك المصادقة والسجلات وإعادة المحاولة ومعالجة الأخطاء الذي ستطلبه واجهة الإنتاج، ثم الانتقال مع توثيق مسؤوليات تشغيل الاتصال. ونادرًا ما تكون التقنية هي الجزء الصعب؛ الصعب هو الترتيب، ونموذج الهوية، ومن يملك الواجهة بعد الإطلاق.
دور إنتركي هنا هو دور فريق هندسة برمجيات وتكامل أنظمة يحدّد نطاق العمل ويبني على واجهات موثّقة. تصف هذه الصفحة التخطيط، لا سجل تنفيذ، والمصادر الرسمية المرتبطة أدناه هي المرجع في متطلبات كل منصة.
02المنصات
أربع منصات، وما يتطلبه التكامل مع كلٍّ منها
اقرؤوا التوثيق الرسمي أولًا؛ فهو يتغير، وهذا الجدول خريطة لشكل التكامل لا بديل عن المواصفة.
- المنصة
- نفاذ
- ما هي
- خدمة الهوية الرقمية الوطنية والدخول الموحّد.
- ما يتطلبه التكامل
- تفويض مصادقة المواطنين والمقيمين إلى مزوّد الهوية الوطني، وربط الهوية التي تعيدها المنصة بنموذج المستخدمين عندكم، ومعالجة الموافقة ودورة حياة الجلسة.
- المصدر الرسمي
- iam.gov.sa (نفاذ)
- المنصة
- اعتماد
- ما هي
- منصة المشتريات والمنافسات الحكومية.
- ما يتطلبه التكامل
- التسجيل مورّدًا، ومواءمة بيانات المنافسات والعروض والعقود مع إجراءات المنصة المنشورة إذا ربطت الجهة أنظمتها بها.
- المصدر الرسمي
- etimad.sa
- المنصة
- واثق
- ما هي
- خدمات بيانات السجل التجاري لوزارة التجارة.
- ما يتطلبه التكامل
- جلب بيانات السجل التجاري عبر الواجهات المنشورة، بشروط الاشتراك والمصادقة والاستخدام التي تحدّدها الخدمة.
- المصدر الرسمي
- wathq.sa
03التسلسل
من المواصفة المنشورة إلى اتصال إنتاجي
الترتيب أهم من السرعة. كل مرحلة تنتج ما تعتمد عليه التالية، وتخطّي إحداها هو ما يجعل التكامل ينجح في الاختبار ويفشل في الإنتاج.
-
اقرؤوا المواصفة كما نُشرت
الإصدارات، ونقاط النهاية، وصيغ المستندات، ورموز الأخطاء، وحدود المعدّل، من مواد المطوّرين لدى المنصة نفسها. ودوّنوا ما هو إلزامي وما هو توصية.
-
انضمّوا إلى بيئة الاختبار
سجّلوا الحل أو الجهة، واستلموا بيانات اعتماد الاختبار، وابنوا التكامل على بيئة الاختبار كما سيعمل في الإنتاج تمامًا، بما في ذلك مسارات الفشل.
-
احسموا المصادقة والهوية
الشهادات أو الرموز أو الهوية المفوَّضة، وإصدارها وتدويرها، وكيف تُربط الهوية التي تعيدها المنصة بمستخدميكم وأدواركم وسجلاتكم.
-
صنّفوا البيانات التي تعبر الواجهة
ما يغادر أنظمتكم، وما يعود، وتصنيفه وفق سياستكم، وأين يُخزَّن ولأي مدة.
-
ابنوا متطلبات التشغيل من البداية
سجلات منظّمة، ورصد، وإعادة محاولة بمفاتيح تكرار آمنة، ومعالجة أخطاء صريحة، وسجل تدقيق يستطيع المراجع تتبّعه من طرف إلى طرف.
-
انتقلوا إلى الإنتاج بمسؤوليات موثّقة
بيانات اعتماد الإنتاج، ومسار النشر، ومن يراقب الاتصال، ومن يجيب عن إشعارات التغيير من المنصة، وما يحدث حين يتغير الإصدار.
04القرارات الهندسية
اثنا عشر قرارًا تحدد ثبات التكامل في الإنتاج
- القرار
- ما الذي يُحسم
- الانضمام إلى الواجهة
- من يسجّل لدى المنصة، وتحت أي جهة، ومن يحتفظ ببيانات الاعتماد الصادرة.
- بيئة الاختبار مقابل الإنتاج
- ما الذي يختلف بينهما من بيانات وحدود وشهادات، وكيف يُنقل البناء المختبَر في إحداهما إلى الأخرى.
- المصادقة
- نوع بيانات الاعتماد الذي تطلبه المنصة، ومدته، وتدويره، وأين يُخزَّن.
- الهوية
- كيف تُربط الهوية التي تؤكدها المنصة بنموذج مستخدميكم، وما يحدث حين يختلفان.
- تصنيف البيانات
- تصنيف كل خانة بيانات تعبر الواجهة، وقاعدة المعالجة التي يتطلبها كل تصنيف.
- السجلات
- ما يُسجَّل، وبأي مستوى، وأي المعرّفات تُحجب، ولأي مدة.
- الرصد
- كيف تُتابَع صحة الاتصال وزمن استجابته ومعدل أخطائه، ومن يراها، على منصة الرصد التي تشغّلونها أصلًا.
- بوابات الواجهات
- هل يمرّ الاتصال عبر بوابة مُدارة، وأي السياسات، من معدّل ومصادقة وتحويل، تُطبَّق فيها.
- إعادة المحاولة والتكرار الآمن
- أي الطلبات تُعاد بأمان، ومفتاح التكرار الذي يجعلها آمنة، والتراجع الزمني الذي تتحمّله المنصة.
- معالجة الأخطاء
- رموز أخطاء المنصة مربوطة بنتائج صريحة: إعادة، أو تصعيد، أو رفض، أو إيقاف لمراجعة بشرية.
- قابلية التدقيق
- سجل ما أُرسل، ومتى، وبأي هوية، وبأي استجابة، محفوظ حيث يستطيع المدقّق قراءته.
- مسؤولية النشر
- من ينشر، ومن يشغّل، ومن يُستدعى، ومن يملك التغيير حين تنشر المنصة إصدارًا جديدًا.
05مصمَّم ليصمد
ثلاث حالات فشل ينبغي أن يتحملها كل تكامل مع منصة
يمر كل تكامل قائم بكلٍّ منها عاجلًا أو آجلًا. والقرارات الهندسية أعلاه تجعلها حينها حدثًا مسجَّلًا لا عطلًا.
01
تنشر المنصة إصدارًا جديدًا
تتغير نقاط النهاية أو صيغ المستندات أو قواعد التحقق على جدول المنصة لا جدولكم. يتتبّع البناء إصدار المواصفة الذي يستهدفه، وتُجرَّب إعادة التشغيل على بيئة الاختبار مسبقًا، ويُسمّى من يقرأ إشعارات التغيير.
02
تنتهي صلاحية بيانات اعتماد أو تُدوَّر
للشهادات والرموز مدة صلاحية. يُجدوَل التدوير ويُختبر قبل الانتهاء، ويُحفظ السر في مكان واحد، ويكون فشل المصادقة تنبيهًا له مسؤول، لا قائمة انتظار من الإرساليات المرفوضة لا ينتبه لها أحد.
03
يُرسل طلب مرتين
انتهاء المهلة بعد أن قبلت المنصة الطلب هو الحالة المعتادة. مفاتيح التكرار الآمن تجعل الإعادة آمنة، ويُظهر سجل التدقيق محاولتين ونتيجة واحدة، وتقرير المطابقة هو الدليل.
06قبل الشراء
أسئلة تُحسم أثناء الشراء
ضعوها في كراسة الشروط. الإجابة المفصّلة تدل على أن المورّد قرأ المواصفة، والإجابة العامة لا تدل على ذلك.
- أي إصدار من مواصفة المنصة يُبنى عليه، ومن يتابع تغييراته
- أي جهة تسجّل لدى المنصة، ومن يحتفظ ببيانات الاعتماد بعد التسليم
- كيف تُنقل نتائج بيئة الاختبار إلى الإنتاج، وما يُعاد اختباره عند الانتقال
- أي نموذج هوية يُستعمل، وكيف تُحل الاختلافات بين المنصة وسجلاتكم
- تصنيف كل خانة بيانات تعبر الواجهة، ومدة الاحتفاظ بها
- ما يُسجَّل، وما يُحجب، وأين يُحفظ سجل التدقيق
- أي الطلبات آمنة التكرار، وكيف يُمنع الإرسال المكرر
- من يشغّل الاتصال بعد الإطلاق، ومن يستجيب لإشعار تغيير من المنصة
ما تقدّمه إنتركي تحديدًا
فريق هندسة برمجيات وتكامل أنظمة في الرياض يحدّد نطاق التكاملات مع الواجهات الموثّقة ويبنيها ويختبرها ويشغّلها، بممارسات السجلات والرصد والبوابات المرتبطة أعلاه. أما هل ينتمي تكامل منصة بعينها إلى برنامج، وتحت تسجيل أي جهة، فيُحسم في أول اجتماع وفق متطلبات المنصة الحالية.
07أسئلة المشترين
ما يسألنا عنه العملاء
إجابات مباشرة عن الأسئلة التي تتكرر في محادثات التقييم والشراء. وما لم تجدوه هنا، اسألونا عنه في النموذج أدناه.
هل نحتاج إلى تكامل منفصل لكل منصة؟
لكل منصة مواصفتها وبيانات اعتمادها وإجراء انضمامها، فكلٌّ منها تكامل قائم بذاته. أما ما ينبغي مشاركته فهو الهندسة تحته: البوابة، ونهج السجلات والتدقيق، ونمط إعادة المحاولة والتكرار الآمن، وربط الهوية، ليكون التكامل الثاني أرخص من الأول.
أين توجد المواصفة الرسمية؟
على موقع كل منصة نفسها، المرتبط في الجدول أعلاه. ابنوا على الإصدار المنشور واعتبروا هذا الدليل إطارًا للتخطيط حوله، لا بديلًا عن المواصفة.
هل يمكن بناء التكامل واختباره دون المساس بالإنتاج؟
نعم، ولهذا الغرض توفّر المنصة بيئة اختبار. يكتمل البناء وتُجرَّب مسارات فشله ببيانات اعتماد الاختبار، ولا تصدر بيانات اعتماد الإنتاج إلا عند الانتقال، مع تحديد ما يُعاد اختباره عند تلك النقطة مسبقًا.
من المسؤول عن الاتصال بعد الإطلاق؟
من يحدده العقد، ولهذا هو أحد القرارات الاثني عشر. تستطيع إنتركي تشغيل تكامل ضمن نطاق خدمات مدارة مكتوب؛ ويبقى التسجيل وبيانات الاعتماد للجهة.
من مركز المعرفة
المزيد عن تكامل الأنظمة
ممارسة
تكامل الأنظمة في السعودية
ربط أنظمة الموارد والتشغيل والأنظمة القديمة التي تشغّلها المؤسسة أصلًا، مع مسؤول محدد لكل واجهة.
ممارسةإدارة واجهات البرمجة والبوابات
حصر الواجهات، والسياسات، وتنفيذ البوابة وتشغيلها، داخل المملكة حيث يلزم.
قطاعالتقنية للجهات الحكومية
نشر داخل المملكة من طرف إلى طرف، وبرمجيات تُبنى بالعربية أولًا، وتشغيل بعد التسليم.
الخطوة التالية
حدّدوا نطاق تكامل مع منصة
سمّوا المنصة والأنظمة من طرفكم ومن سيشغّل الاتصال، ويأتي الرد من المهندسين الذين سيبنونه.
أو مباشرةً
+966-11-2180999 [email protected]أبراج التعاونية، البرج الشمالي، الطابق السابع، طريق الملك فهد، العليا، ص.ب. ٥٦٨٣٥، الرياض ١١٥٦٤، المملكة العربية السعودية