لا تحتاجون إلى كتابة أي شيفرة لتقرروا ما الذي تربطونه. يشرح هذا الدليل ما تفعله واجهة البرمجة، وكيف تُقارن باستيراد الملفات والموصلات الجاهزة، وأي عمليات الربط تؤتي ثمارها أولًا للشركات في الخليج. ويتتبع ربط متجر إلكتروني لموزّع في دبي، مع الأرقام، وينتهي بفحوص الأمن وحماية البيانات التي يجب إجراؤها أولًا.
ماذا تفعل واجهة البرمجة فعلًا؟
تخيّلوا واجهة البرمجة كمكتب خدمة بنموذج ثابت. لا يمكنكم طلب إلا ما يسمح به النموذج، ويتحقق الموظف من هويتكم، ويعود الرد دائمًا بالتنسيق نفسه، حتى يتمكن الحاسوب من قراءته والتصرف بناءً عليه دون وسيط بشري.
عمليًا، يرسل متجركم الإلكتروني إلى نظام تخطيط موارد المؤسسة رسالة مفادها: «أنشئ أمر البيع هذا لهذا العميل، بهذه الأصناف». فيتحقق النظام من مفتاح المتجر، وينشئ الطلب ويرد «تم، الطلب 10482»، أو «مرفوض، رمز الصنف غير موجود».
بعض المصطلحات تتكرر في كل نقاش حول التكامل:
| المصطلح | ما يعنيه | مثال |
|---|---|---|
| نقطة النهاية (Endpoint) | مكتب واحد لنوع واحد من الأعمال | نقطة نهاية للعملاء، وأخرى للأصناف، وأخرى للفواتير |
| مفتاح واجهة البرمجة أو الرمز المميز | بطاقة الهوية التي يُبرزها النظام المتصل | المفتاح الخاص بالمتجر الإلكتروني، المسموح له فقط بطلبات الطلبيات والمخزون |
| خطاف الويب (Webhook) | النظام الآخر يتصل بكم عندما يحدث شيء، بدلًا من أن تسألوه مرارًا | يُبلغ المتجر النظام لحظة سداد الطلب |
| مطابقة الحقول | أي حقل في نظام يقابل أي حقل في الآخر | «SKU» في المتجر يساوي «رمز الصنف» في النظام |
واجهة البرمجة بحد ذاتها مجرد مدخل. أما التكامل فهو المدخل إضافة إلى القواعد بشأن ما يمر عبره، ومتى، وماذا يحدث عندما يسوء شيء.
كيف تختلف واجهة البرمجة عن استيراد الملفات أو الموصل الجاهز؟
هناك أربع طرق شائعة لنقل البيانات من تطبيق أعمال إلى آخر.
| الطريقة | آلية عملها | الأنسب لـ | انتبهوا إلى |
|---|---|---|---|
| الإدخال اليدوي | يقرأ أحدهم شاشة ويكتب في أخرى | الأحجام المنخفضة | أخطاء الإدخال؛ ووقت الموظفين يزداد مع الحجم |
| استيراد الملفات أو تصديرها | يحفظ نظام ملف CSV أو Excel ويحمّله الآخر | كشوف الحساب البنكية اليومية، والرواتب الشهرية | ملفات تُحمّل مرتين أو لا تُحمّل أبدًا، دون أن يلاحظ أحد |
| الموصل الجاهز | بنى مزوّد ربط واجهة البرمجة ويتولى صيانته؛ تفعّلونه وتضبطون المطابقة | التطبيقات الشائعة التي يستخدمها كثير من العملاء | تحققوا مما ينقله وما يتركه |
| التكامل المخصص عبر واجهة البرمجة | يربط مطوّر واجهتي البرمجة في نظاميكم | التطبيقات التي لا موصل لها، أو الإجراءات الخاصة | أنتم تملكونه: يجب أن يراقبه أحد ويحدّثه |
الخيار الأفضل عادةً هو الأبسط الذي يلبي التوقيت الذي تحتاجونه. فكشف الحساب البنكي الذي تطابقونه مرة يوميًا يمكن أن يصل كملف. أما مستويات المخزون على موقع يستقبل الطلبات طوال الليل فلا.
أي التطبيقات تربطها الشركات في الخليج أولًا عادةً؟
ابدؤوا بعمليات الربط التي تحمل أكبر عدد من المعاملات أو أعلى مخاطر الالتزام التنظيمي.
| التطبيق | ما يُنقل | لماذا يهم |
|---|---|---|
| المتجر الإلكتروني أو بوابة الطلبات بين الشركات | الطلبات واردة؛ ومستويات المخزون صادرة | يمنع البيع بما يتجاوز المتاح وإعادة كتابة الطلبات |
| أجهزة نقاط البيع في الفروع | المبيعات وأنواع الدفع والمرتجعات واردة | رقم واحد للمخزون والمبيعات لكل فرع |
| البنوك وبوابات الدفع | كشوف الحساب والتسويات والرسوم واردة | مطابقة يومية بدلًا من اللحاق بالأمور في نهاية الشهر |
| مزوّد الفوترة الإلكترونية (الإمارات) أو هيئة الزكاة والضريبة والجمارك (السعودية) | الفواتير صادرة؛ وردود الحالة عائدة | متطلب قانوني بمواعيد محددة |
| أجهزة الحضور | أوقات تسجيل الدخول والخروج واردة | العمل الإضافي والغياب من بيانات حقيقية |
| تطبيقات التوصيل والأسواق الإلكترونية | الطلبات والعمولات واردة | الهامش الحقيقي لكل طلب |
الفوترة الإلكترونية هي الربط الذي لا تستطيع معظم الشركات في الخليج تجنبه. ففي السعودية، تتصل أنظمة الفوترة بمنصة هيئة الزكاة والضريبة والجمارك عبر واجهات البرمجة الخاصة بها، وتعتمد الهيئة الفواتير الموجهة للأعمال قبل مشاركتها مع المشتري. وفي الإمارات، يجري تطبيق الفوترة الإلكترونية تدريجيًا؛ اطّلعوا على مقالنا «الفوترة الإلكترونية في الإمارات 2027» لمعرفة ما تتضمنه.
كيف يبدو التكامل؟ مثال تطبيقي
موزّع أدوات منزلية في دبي يستقبل نحو 1,500 طلب شهريًا عبر موقع الطلبات بين الشركات. وحتى الآن، كان موظف يكتب كل طلب إلكتروني في نظام تخطيط موارد المؤسسة.
طلب نموذجي: 40 كرتونة بسعر 31 درهمًا للكرتونة، أي 1,240 درهمًا قبل الضريبة، إضافة إلى ضريبة قيمة مضافة 5% قدرها 62 درهمًا، بإجمالي 1,302 درهم. وهذا ما يفعله ربط واجهة البرمجة به:
| الحقل | ما يرسله المتجر | ما يفعله النظام |
|---|---|---|
| العميل | رقم الحساب على الموقع | يطابق حساب العميل ويتحقق من حد الائتمان |
| الصنف | رمز SKU في المتجر | يطابقه مع رمز الصنف ويحجز 40 كرتونة |
| السعر | 31 درهمًا للكرتونة | يقارنه بقائمة أسعار العميل ويُبرز الفروق |
| ضريبة القيمة المضافة | 62 درهمًا | يعيد احتساب 5% على 1,240 درهمًا ويُبرز أي اختلاف |
| حالة الدفع | مدفوع أو على الحساب | يسجّل المقبوض، أو يتركه على حساب العميل |
ثم يرسل النظام مستويات المخزون المحدّثة إلى الموقع كل بضع دقائق، حتى لا يتمكن العملاء من طلب ما بيع بالفعل.
الأرقام الشهرية، بتكلفة موظفين قدرها 45 درهمًا للساعة:
| قبل (الإدخال اليدوي) | بعد (الربط عبر واجهة البرمجة) | |
|---|---|---|
| إدخال الطلبات | 1,500 × 4 دقائق = 100 ساعة | لا شيء |
| إصلاح أخطاء الإدخال | 2% = 30 طلبًا × 20 دقيقة = 10 ساعات | لا شيء |
| معالجة الاستثناءات | مشمولة أعلاه | 1% = 15 طلبًا × 10 دقائق = 2.5 ساعة |
| المراجعة اليومية لسجل التكامل | لا شيء | 15 دقيقة × 22 يوم عمل = 5.5 ساعات |
| وقت الموظفين | 110 ساعات = 4,950 درهمًا | 8 ساعات = 360 درهمًا |
| رسوم الموصل | لا شيء | 500 درهم |
| التكلفة الشهرية | 4,950 درهمًا | 860 درهمًا |
التوفير الشهري 4,090 درهمًا. ومع تكلفة إعداد لمرة واحدة قدرها 15,000 درهم، يسترد الربط تكلفته في أقل من أربعة أشهر (15,000 ÷ 4,090 = 3.7)، ثم يوفّر نحو 49,000 درهم سنويًا.
كما تصل الطلبات إلى المستودع في اليوم نفسه، ويُبرز السعر أو رقم الضريبة الخاطئ بدلًا من أن يُفوتر. والجزء الأصعب لم يكن واجهة البرمجة، بل مطابقة 300 رمز SKU في المتجر مع رموز الأصناف في النظام. وكل الأرقام توضيحية.
ما الذي يجب الاتفاق عليه قبل بناء التكامل؟
معظم عمليات التكامل الفاشلة تفشل بسبب قرارات لم يتخذها أحد، لا بسبب الشيفرة. اتفقوا على هذه الأمور كتابةً قبل أن يبدأ المطوّر.
- حددوا مصدر الحقيقة لكل نوع من البيانات. الأصناف والأسعار تتبع عادةً نظام تخطيط موارد المؤسسة، والطلبات تتبع المتجر. فإذا كان النظامان كلاهما يستطيعان تغيير حقل، فسيكتب كل منهما فوق الآخر.
- طابقوا كل حقل ورمز، وقرروا ماذا يحدث للرموز غير المتطابقة.
- قرروا التوقيت: فوري، أو كل بضع دقائق، أو يومي. فالأسرع يكلّف أكثر ولا يُجدي إلا حيث يكلّف التأخير مالًا.
- قرروا ماذا يحدث عند الفشل. تذهب السجلات الفاشلة إلى قائمة استثناءات ويُنبَّه شخص محدد. ولا يجب أن يختفي شيء بصمت.
- اختبروا ببيانات حقيقية وخاطئة، مثل صنف غير معروف أو طلب مكرر.
- حددوا مسؤولًا يقرأ سجل التكامل كل يوم.
- خطّطوا للتغيير. اسألوا المزوّدين كليهما عن كيفية إعلانهما تغييرات واجهة البرمجة، ومن يحدّث الربط.
كيف تحافظون على أمن عمليات التكامل والتزامها بالمتطلبات التنظيمية؟
كل ربط باب إلى نظام تخطيط موارد المؤسسة لديكم، لذا تعاملوا مع مفاتيح واجهة البرمجة ككلمات مرور النظام المالي. امنحوا كل تكامل مفتاحه الخاص بصلاحية الوصول إلى ما يحتاجه فقط: فالمتجر الإلكتروني يمكنه إنشاء الطلبات وقراءة المخزون، لا قراءة الرواتب.
تنطبق قوانين حماية البيانات في الإمارات والسعودية، لأن معظم عمليات التكامل تحمل بيانات شخصية مثل أسماء العملاء وأرقام هواتفهم وعناوينهم. اعرفوا ما البيانات الشخصية التي يحملها كل ربط وإلى أين تذهب، واطلبوا المشورة القانونية إذا لم تكونوا متأكدين مما يجب أن تغطيه عقودكم مع مزوّدي التطبيقات.
قبل تفعيل أي ربط، تحققوا من:
ماذا ترى HYP عندما تربط الشركات تطبيقاتها؟
عندما تربط الشركات في أنحاء الإمارات والسعودية تطبيقات مثل المتاجر الإلكترونية وأنظمة نقاط البيع والبنوك ومزوّدي الفوترة الإلكترونية بنظام تخطيط موارد المؤسسة، يرى فريق التنفيذ لدينا نمطين يتكرران.
التكامل بلا مسؤول. بناه مستقل قبل عامين، ويعمل معظم الأيام، ولا يقرأ أحد السجل. ويكتشف العملاء حالات الفشل.
النظامان كلاهما يملكان البيانات نفسها. فتُعدَّل الأسعار على الموقع وفي النظام، ويفوز آخر ما تمت مزامنته. والحل قرار، لا ربط أفضل.
الشركات التي تدير عمليات التكامل جيدًا تُبقي القائمة قصيرة، وتستخدم الموصلات الجاهزة حيث توجد، وتكلّف شخصًا واحدًا بمعالجة الاستثناءات كل صباح. كما تختبر روابط الفوترة الإلكترونية قبل بدء التشغيل بأشهر، لا في الأسبوع الأخير.
يتصل HYP بتطبيقات الأعمال الأخرى عبر سوق التكاملات وواجهات البرمجة (APIs). اطّلعوا على المتاح في صفحة سوق التكاملات وواجهات البرمجة (APIs).
قراءات ذات صلة: للمخزون المشترك بين موقع إلكتروني ومتاجر، اطّلعوا على الطلبات الإلكترونية ومخزون المتجر: البيع من مخزون واحد دون تجاوز الكمية المتاحة. ولاختبار عمليات التكامل قبل الشراء، اطّلعوا على قائمة التحقق للعرض التوضيحي لنظام ERP: ما تطلبون من المورّدين عرضه ببياناتكم.