خدمة
تكامل الأنظمة والربط مع المنصات الخارجية
تكامل الأنظمة هو ربط ERPNext بالأدوات التي تعمل بها مؤسستك خارج النظام: واتساب، ملفات البنوك والمدفوعات، المتجر الإلكتروني، أجهزة نقاط البيع، أجهزة البصمة والحضور، وقوالب التقارير الخارجية. تبني يمن فرابي هذا الربط للشركات والجهات الحكومية والمنظمات غير الربحية في اليمن عبر REST API وWebhooks والمزامنة المجدولة، مع سجلات أخطاء وإعادة محاولة وصلاحيات محكمة. النتيجة أن البيانات تُدخَل مرة واحدة وتنتقل تلقائياً بدل النسخ اليدوي بين الشاشات.
ما خدمة تكامل الأنظمة ولمن تُقدَّم؟
في أغلب المؤسسات لا يعمل ERPNext وحده: الفواتير تُرسَل للعملاء عبر واتساب يدوياً، وكشوف البنك تُطابَق في Excel، وطلبات المتجر الإلكتروني تُعاد كتابتها في النظام، وسجلات جهاز البصمة تُنقَل إلى الرواتب في نهاية الشهر. كل خطوة يدوية من هذه مصدر للتأخير والأخطاء وتعارض الأرقام.
خدمة التكامل تحوّل هذه الخطوات إلى تدفق آلي موثّق: يحدد كل ربط مصدر البيانات ووجهتها، ومتى تنتقل، وماذا يحدث عند فشلها. تعمل يمن فرابي منذ 2022 على ERPNext وFrappe في اليمن، ونصمم الربط بحيث يبقى ERPNext المرجع الوحيد للأرقام المالية والمخزنية، بينما تكون الأنظمة الأخرى قنوات إدخال أو إشعار.
ما الذي يمكن ربطه بـ ERPNext
- واتساب: إرسال الفاتورة بصيغة PDF عند اعتمادها، تذكير العملاء بالمستحقات المتأخرة، وإشعار حالة الطلب أو الشحنة، كما نشرح في مقال تكامل واتساب مع ERPNext.
- المدفوعات والبنوك: استيراد ملفات كشوف الحساب أو حركات المحافظ والبوابات لمطابقتها مع سندات القبض والصرف، وتصدير ملفات دفع الرواتب أو الموردين بالصيغة التي يطلبها البنك.
- المواقع والمتاجر الإلكترونية: مزامنة الأصناف والأسعار والكميات المتاحة إلى المتجر، واستقبال الطلبات كأوامر بيع في ERPNext مع بيانات العميل.
- أجهزة نقاط البيع: ربط الكاشير والطابعات وقارئات الباركود بنقطة البيع، وترحيل المبيعات إلى المخزون والقيود، كما في نظام نقاط البيع.
- أجهزة الحضور والبصمة: سحب سجلات الدخول والخروج إلى سجل الحضور في وحدة الموارد البشرية لحساب الغياب والتأخير والإضافي.
- التقارير والقوالب الخارجية: تصدير بيانات بصيغة محددة لجهة رقابية أو مانح أو نظام آخر، أو تغذية أدوات تحليل خارجية.
أدوات الربط: REST API وWebhooks والمزامنة المجدولة
يوفر Frappe Framework ثلاث طرق أساسية للتكامل، ونختار لكل حالة ما يناسبها بدل فرض طريقة واحدة:
| الطريقة | كيف تعمل | متى نستخدمها |
|---|---|---|
| REST API | النظام الخارجي يقرأ أو ينشئ مستندات في ERPNext عبر طلبات HTTP موثّقة بمفتاح | متجر يرسل طلباً، تطبيق جوال يقرأ رصيد عميل |
| Webhooks | ERPNext يرسل البيانات تلقائياً إلى عنوان خارجي عند حدث محدد كاعتماد فاتورة | إشعار فوري لنظام آخر أو خدمة رسائل |
| المزامنة المجدولة | مهمة خلفية تعمل كل فترة لسحب أو دفع دفعة من البيانات | سجلات البصمة، كشوف البنك، تحديث الأسعار |
وعندما لا يكفي ذلك نكتب منطق الربط كتطبيق Frappe مستقل بدل تعديل نواة النظام، وهو النهج نفسه المتبع في خدمة تخصيص ERPNext وتطوير Frappe، فيبقى النظام قابلاً للتحديث.
اتساق البيانات ومعالجة الأخطاء
التكامل الذي يعمل في العرض التجريبي ويتعطل بصمت في الإنتاج أسوأ من عدم وجوده. لذلك نبني في كل ربط:
- سجل لكل عملية: ما الذي أُرسل أو استُقبل، ومتى، وما النتيجة، حتى يعرف المسؤول أين توقفت البيانات.
- طابور إعادة المحاولة: عند فشل الإرسال بسبب انقطاع الإنترنت أو توقف الخدمة الأخرى، تبقى العملية في طابور المهام الخلفية وتُعاد لاحقاً بدل أن تضيع.
- منع التكرار: مفتاح مرجعي لكل طلب أو حركة يمنع إنشاء الفاتورة أو سند القبض مرتين إذا وصل الطلب نفسه مرة ثانية.
- التحقق قبل الإنشاء: فحص وجود الصنف والعميل والحساب قبل إنشاء المستند، وتحويل الحالات الناقصة إلى قائمة مراجعة بدل قيود خاطئة.
- تنبيهات الفشل: إشعار للمسؤول عندما يتكرر فشل ربط معين، لا الاكتفاء بسجل لا يقرؤه أحد.
أمان التكامل والصلاحيات
كل ربط هو باب إضافي إلى بيانات مؤسستك، ونعامله على هذا الأساس:
- مستخدم مخصص لكل تكامل بمفتاح API مستقل، وصلاحيات محصورة في المستندات التي يحتاجها فقط، فلا يملك ربط المتجر صلاحية على الرواتب.
- الاتصال عبر HTTPS فقط، وعدم حفظ المفاتيح في الكود أو تبادلها عبر الرسائل.
- توقيع طلبات Webhooks والتحقق منها في الطرف المستقبل حتى لا يُقبل طلب مزيّف.
- إمكانية إيقاف مفتاح أو تدويره دون تعطيل بقية الأنظمة، مع سجل يوضح أي تكامل أنشأ أي مستند.
كيف ننفّذ مشروع التكامل
- حصر نقاط الربط: نحدد العمليات اليدوية المتكررة بين ERPNext والأنظمة الأخرى، ونرتبها حسب الأثر على العمل اليومي.
- دراسة الطرف الآخر: نراجع ما يوفره النظام الخارجي فعلاً: واجهة برمجية، ملفات تصدير، أو قاعدة بيانات للجهاز، لأن هذا يحدد الطريقة الممكنة.
- تصميم التدفق: نوثّق اتجاه البيانات، وتوقيتها، والحقول المقابلة، وأي نظام هو المرجع عند التعارض.
- البناء والاختبار: نطوّر الربط على بيئة تجريبية ونختبر الحالات الصعبة: انقطاع، بيانات ناقصة، تكرار، وأحجام كبيرة.
- التشغيل والمراقبة: نطلق الربط تدريجياً ونراقب سجلاته في الفترة الأولى، ثم نسلّم دليلاً مختصراً لمعالجة الأخطاء الشائعة.
اعتبارات السوق اليمني ولمن تناسب الخدمة
الإنترنت المتقطع وانقطاع الكهرباء في اليمن يجعلان طابور إعادة المحاولة شرطاً أساسياً لا ميزة إضافية، كما أن كثيراً من البنوك ومزودي الدفع المحليين يتعاملون بملفات لا بواجهات برمجية، فنبني الاستيراد والتصدير بالملفات حين يكون هو الواقع. وتعدد العملات يفرض أن يحمل كل مستند مستورد عملته وسعر صرفه بوضوح.
- المؤسسات والجهات الحكومية: ربط محكوم بالصلاحيات وسجل تدقيق كامل، وتصدير تقارير بالصيغ التي تطلبها الجهات الرقابية.
- المنظمات غير الربحية: ربط أنظمة المشاريع أو التوزيع بالمحاسبة حسب المشروع والممول، وتصدير بيانات بقوالب المانحين.
- الشركات والمؤسسات التجارية: واتساب للفواتير والتحصيل، المتجر الإلكتروني، نقاط البيع، وأجهزة البصمة في الفروع.
- المشاريع والشركات الناشئة: البدء بربط واحد عالي الأثر كإشعارات واتساب، ثم التوسع، وقد يتطور لاحقاً إلى حلول الذكاء الاصطناعي المبنية على بيانات ERPNext.
أسئلة شائعة
هل يمكن ربط ERPNext بواتساب لإرسال الفواتير تلقائياً؟
نعم. يمكن إرسال الفاتورة بصيغة PDF إلى رقم العميل عند اعتمادها، وإرسال تذكيرات بالمستحقات وحالة الطلبات. يتم ذلك عبر مزود واتساب للأعمال وWebhooks أو مهام مجدولة في ERPNext، مع سجل يبيّن ما أُرسل وما فشل.
هل يدعم ERPNext الربط عبر API؟
نعم. يوفر Frappe Framework واجهة REST API لكل نوع مستند تقريباً، للقراءة والإنشاء والتعديل، مع توثيق بمفتاح API وصلاحيات المستخدم نفسها. كما يدعم Webhooks لإرسال البيانات تلقائياً عند أحداث محددة.
ماذا يحدث إذا انقطع الإنترنت أثناء المزامنة؟
في الربط المصمم جيداً لا تضيع البيانات: تبقى العملية الفاشلة في طابور المهام الخلفية وتُعاد عند عودة الاتصال، مع مفتاح مرجعي يمنع إنشاء المستند مرتين. لذلك نبني إعادة المحاولة والسجلات في كل تكامل نسلّمه.
هل يمكن ربط جهاز البصمة بنظام الموارد البشرية في ERPNext؟
يعتمد ذلك على ما يتيحه الجهاز: بعض الأجهزة توفر واجهة شبكية أو برنامجاً وسيطاً، وبعضها يصدّر ملفات فقط. في الحالتين يمكن تحويل السجلات إلى حركات حضور في ERPNext بشكل مجدول، فنراجع طراز الجهاز أولاً قبل تحديد الطريقة.
كم يستغرق بناء تكامل بين ERPNext ونظام آخر؟
تعتمد المدة على عدد نقاط الربط، وما يوفره النظام الآخر من واجهات أو ملفات، وحجم البيانات، ومتطلبات معالجة الأخطاء. ربط إشعارات بسيط يختلف كثيراً عن مزامنة متجر بالمخزون والأسعار في اتجاهين. نحدد التقدير بعد دراسة الطرف الآخر.