صف الحدث التجاري قبل اختيار واجهة API
قد تتضمن عملية الدفع بين الشركات (B2B) أسعارًا متفقًا عليها وأوامر شراء وحدود موافقة وشروط دفع. ابدأ بسير عمل واحد وحدّد الأنظمة المعنية. على سبيل المثال: يقدّم مشترٍ معتمد طلبًا، ويسجّله النظام المالي، ويعيد المستودع حالة التنفيذ إلى بوابة العميل.
تصف هذه المقالة مثالًا تخطيطيًا، وليس مشروع عميل مكتملًا. ينطبق الإعداد نفسه على تكاملات إدارة علاقات العملاء (CRM) والدفع والحجز: حدّد الحدث والبيانات المرجعية ومعنى التسليم الناجح.
جهّز موجز تكامل
- الأنظمة والوصول: حدّد المنصة وخطة الحساب وإصدار API والتوثيق والبيئة التجريبية. تأكّد من توفر نقاط النهاية والأذونات المقصودة.
- ملكية البيانات: حدّد أي نظام يملك هوية العميل والسعر والمخزون وحالة الطلب وحالة الدفع. وفّر سجلات تمثيلية مع إزالة البيانات الشخصية.
- الربط: حدّد المعرّفات المشتركة والحقول المطلوبة والعملة ومعالجة الضرائب والمناطق الزمنية. سجّل ما ينبغي فعله عند وجود منتج أو عميل غير مطابق.
- الاستثناءات: اشمل الإلغاء والتنفيذ الجزئي والدفع الفاشل والسعر المتغيّر والنظام التابع غير المتاح.
- العمليات: حدّد من يراجع حالات الفشل ويمكنه إعادة تشغيل عملية نقل ويعتمد التصحيح.
افترض أن الإشعارات قد تتكرر أو تصل متأخرة
تحتاج معالجة الـ webhook إلى سياسة واضحة لإعادة المحاولة ومعالجة التكرار. وكمثال ملموس على منصة واحدة، توثّق Stripe التحقق من التوقيع والأحداث المكررة والمعالجة غير المتزامنة في دليل webhook. ينبغي مصادقة إشعار الدفع ومعالجته وفقًا لعقد مزوّد الخدمة. للمنصات الأخرى قواعدها الخاصة للتسليم وإعادة المحاولة؛ تحقّق منها كلّ على حدة.
مثال على القبول: قدّم طلبًا في البيئة التجريبية، وأرسل حدثه مرتين، ثم عطّل النظام المستقبِل مؤقتًا. تحقّق من إنشاء الطلب مرة واحدة، وأن عملية النقل الفاشلة ظاهرة ويمكن أن تستردها إعادة التشغيل. تحقّق أيضًا من أن العميل لا يمكنه عرض أسعار أو طلبات شركة أخرى.
اتفق على ما يتضمنه الإصدار الأول
قد يدعم النطاق الأول الواقعي نوع طلب واحدًا ومستودعًا واحدًا ومجموعة محددة من الحالات. افصل ترحيل البيانات التاريخية وإعداد الموردين وقواعد التسعير غير المعتادة إذا كانت تحتاج إلى بحث إضافي. اتفق على ما سيكون يدويًا في البداية وكيف سيقيس الفريق ما إذا كان التكامل يقلل العمل.
ينبغي أن يتضمن التسليم عمليات ربط الحقول وتعليمات الإعداد والمراقبة وإجراء إعادة تشغيل وملكية محددة لترقيات المنصة. تعتمد شروط الصيانة على الأنظمة والارتباط المتفق عليه. استكشف تطوير وتكامل API, أتمتة سير العمل و تطوير التجارة الإلكترونية.
