ربط الطلبات بنظام ERP: مراجعة يدوية، وإرسال متكرر الأثر، وسجل مزامنة
باختصار: الخطأ الأكثر شيوعًا في ربط نظام ERP هو اعتبار “قبِل ERP الطلب” مساويًا لـ”نجح الطلب”. كثير من أنظمة ERP لا تزال تراجع الطلبات يدويًا ثم ترحّل حركة المخزون، والمنصة لا تملك إلا الانتظار. نعطي كل عملية إرسال مفتاح عمل ثابتًا لتمكن إعادة محاولتها بأمان، ونعرف الحالة بالاستعلام الدوري بدل الاعتماد على استجابة واحدة، ونكتب كل إجراء مزامنة في سجل مزامنة، ونشغّل مطابقة يومية للعثور على المستندات التي لم تعد متطابقة بين الطرفين.
1.0 ارسموا مسار العمل أولًا
قبل كتابة أي سطر من شيفرة الربط، اجلسوا مع جهة تنفيذ ERP ومسؤول العمل واكتبوا كل خطوة من الطلب حتى الفاتورة. حدّدوا في أي جانب تجري كل خطوة، وهل هي آلية أم يدوية. سلسلة نموذجية: إنشاء العميل، إرسال الطلب، المراجعة في ERP، ترحيل حركة المخزون، الشحن مع رقم التتبع، تأكيد التحصيل، جلب الفاتورة.
تحديد الخطوات اليدوية أمر حاسم. الطلب الذي تعرضه المنصة “قيد المعالجة” قد يكون قابعًا في قائمة مهام شخص ما داخل ERP، ولن تحرّكه أي إعادة محاولة. يجب أن تميّز الواجهة والتنبيهات بين “ننتظر ERP” و”فشل الإرسال”، وإلا حمل فريق التشغيل النوعين كليهما إلى المطورين.
2.0 إرسال يمكن إعادته بأمان
الحالة الصعبة هي انتهاء المهلة: ربما وصل الطلب وربما لم يصل. إذا أنشأ ERP مستندًا ثانيًا عند إعادة المحاولة، فلديكم طلب مكرر.
- يحمل كل مستند مفتاح عمل ثابتًا، عادةً رقم الطلب في المنصة، ويزيل ERP التكرار بناءً عليه. إن لم يستطع ERP إزالة التكرار، يُستعلم قبل الإرسال عمّا إذا كان المستند موجودًا.
- البيانات الرئيسية التي يُعتمد عليها تُرسل أولًا: يُنشأ العميل الجديد قبل طلبه. إن لم تكن التبعية جاهزة، ينتظر المستند في طابور محلي بدل دفعه قسرًا.
- عدم تطابق الرموز هو القاعدة لا الاستثناء. اتفقوا كتابيًا على ما يُرسل حين لا يكون المنتج أو العميل موجودًا بعد في ERP، وعلى الجانب الذي يسد النقص.
- كثيرًا ما تختبئ أخطاء ERP داخل جسم استجابة HTTP 200. عميل واحد يتعرّف على دلالات هذه الأخطاء حتى لا يفسرها كل موضع استدعاء على طريقته.
3.0 الحالة تأتي من الاستعلام
استجابة الإرسال تخبركم فقط بأن ERP استلم المستند. الحالات اللاحقة تأتي من استعلام مجدول:
| نقطة التصميم | اختيارنا |
|---|---|
| طريقة المسح | ترقيم صفحات بمجموعة المفاتيح على المفتاح الأساسي بدل OFFSET؛ مستقر مع نمو الحجم ولا يُسقط صفوفًا بين الصفحات |
| ترتيب المسح | مؤشر يتقدم في حلقة ويستأنف من حيث توقف التشغيل السابق، حتى لا تُعاد الدفعة نفسها من الإخفاقات كل مرة |
| التراجع التدريجي | المستندات التي تفشل مرارًا يُستعلم عنها بتواتر أقل حتى حد أقصى، وبعده تُحال إلى شخص |
| التزامن | لا يعالج المستند الواحد إلا عامل واحد في الوقت نفسه، بضمان قفل صف أو عقد إيجار مؤقت |
4.0 سجل المزامنة هو نقطة بداية التشخيص
كل استدعاء يكتب صفًا واحدًا: رقم المستند، والإجراء، وملخص الطلب، ورمز النتيجة، ورسالة ERP، والمدة، ورقم المحاولة. كلمات المرور والرموز المميزة والبيانات الشخصية الكاملة تبقى خارجه.
بهذا الجدول يبدأ سؤال “لماذا لم يُشحن هذا الطلب بعد؟” باستعلام واحد، لا بالبحث في سجلات التطبيق أو طلب لقطات شاشة من فريق ERP. ونحتفظ أيضًا بدليل لمعالجة الأعطال: كل مشكلة جديدة تُحل تُدوَّن بعَرَضها وسببها الجذري وإصلاحها واستعلامات التشخيص، والأحدث في الأعلى. مشكلات ربط ERP تعود كثيرًا في صور مختلفة، وينتهي هذا الدليل إلى أن يكون أنفع من أي لوحة متابعة.
5.0 المطابقة
حتى حين تكون كل خطوة صحيحة، يتباعد الطرفان تدريجيًا: يعدّل أحدهم طلبًا أو يلغيه مباشرة في ERP، أو لا تُحفظ نتيجة استعلام ما. تقارن مطابقة يومية حالات الطلبات والمبالغ والفواتير، وتضع الفروق في قائمة لشخص مسؤول. لا “تصحح” أي طرف تلقائيًا أبدًا؛ ناتجها قائمة عمل.
6.0 التطوير والاختبار
- محوّل ERP واجهة لها تنفيذ محاكٍ للعمل المحلي وCI، فتعمل دورة حياة الطلب كاملة، بما فيها الفوترة، دون اتصال.
- كثيرًا ما تختلف بيئات اختبار ERP عن الإنتاج أو لا توجد أصلًا. أثناء اختبارات الربط، احفظوا الطلبات والاستجابات الحقيقية لكل نقطة نهاية بعد إخفاء البيانات، واستخدموها حالات لاختبار الانحدار.
- طابقوا بتواتر أعلى في الأسابيع الأولى بعد الإطلاق لكشف الحالات التي لم تُظهرها بيئة الاختبار قط.
إذا كنتم تربطون نظام طلبات بنظام ERP، أو كان ربط قائم ينكسر مرارًا، فراجعوا الويب والسحابة وإدارة الأجهزة، أو حدثونا عن مشروعكم.
المراجع
- Stripe، الطلبات متكررة الأثر: https://docs.stripe.com/api/idempotent_requests
- Use The Index, Luke، ترقيم الصفحات بمجموعة المفاتيح: https://use-the-index-luke.com/no-offset
الأسئلة الشائعة
لا يتيح نظام ERP إلا عروضًا من قاعدة البيانات، دون واجهة برمجية. هل يمكن الربط؟
العروض للقراءة فقط كافية لجلب المنتجات والمخزون. أما كتابة المستندات مباشرة في قاعدة بيانات ERP فمحفوفة بالمخاطر: فهي تتخطى تحققات النظام نفسه وتجعل المسؤولية غامضة عند حدوث خلل. ينبغي أن تمر الكتابة عبر واجهة ERP البرمجية أو وظيفة الاستيراد فيه، وأن يُتفق على حدود القراءة والكتابة مسبقًا مع جهة تنفيذ ERP.
كم مرة ينبغي مزامنة المخزون؟
يتوقف ذلك على تكلفة البيع بما يتجاوز المخزون وعلى الحمل الذي يحتمله نظام ERP. إعادة التحقق من المخزون لحظيًا عند تأكيد الطلب أكثر موثوقية عادةً من رفع تواتر المزامنة المجدولة كثيرًا، وأرفق بنظام ERP.
المراجعة في ERP بطيئة والعملاء يرون «قيد المعالجة» باستمرار. ما العمل؟
اعرضوا بصدق أين ينتظر الطلب، مثل «بانتظار مراجعة ERP»، مع مدة المعالجة المتفق عليها مع جهة العمل. لا تستطيع المنصة أن تراجع بدلًا من فريق ERP، لكنها تستطيع أن تجعل الانتظار ظاهرًا وأن تنبّه المسؤول تلقائيًا عند تجاوز المدة.
إذا غيّرنا نظام ERP لاحقًا، فهل يلزم إعادة كتابة المنصة؟
إذا كانت شيفرة الربط في محوّل واحد، فتغيير ERP يعني في الأساس إعادة كتابة هذا المحوّل وإعادة ربط الرموز والاختبار من طرف إلى طرف. أما إذا كانت شيفرة العمل تستدعي واجهة ERP في كل مكان، فالتغيير أكبر بكثير، ولهذا نبني طبقة المحوّل من البداية.