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