BITEX التوثيق English

دمج BITEX مع التطبيقات الأخرى

تم تصميم BITEX ليتم دمجه مع التطبيقات الأخرى. نظرًا لأن BITEX مبني على Frappe Framework، يتم عرض سجلات الأعمال من خلال REST API المتسق. وهذا يجعل من السهل ربط BITEX بالأنظمة الخارجية مثل منصات CRM ومقدمي الخدمات اللوجستية وأنظمة إدارة الطلبات ومنصات إعادة التجارة وخدمات Google والأنظمة المصرفية وبوابات الدفع وتطبيقات الأعمال الداخلية.

لماذا من السهل دمج BITEX

معظم كائنات الأعمال BITEX هي DocTypes. يتبع العملاء والأصناف وأوامر المبيعات وأوامر الشراء وفواتير المبيعات ومذكرات التسليم وإدخالات الدفع وإدخالات المخزون والمشاريع والعديد من السجلات الأخرى نفس نموذج المستند. يوفر Frappe تلقائيًا إمكانية الوصول إلى REST API لـ DocTypes، بحيث يمكن لعمليات التكامل قراءة السجلات وإنشاءها وتحديثها وحذفها باستخدام نقاط نهاية يمكن التنبؤ بها.

وهذا يعني أن تطبيق الجهة الخارجية لا يحتاج إلى API مخصص منفصل لكل وحدة BITEX. بمجرد أن يعرف النظام الخارجي DocType وأسماء الحقول، يمكنه تبادل البيانات مع BITEX باستخدام طلبات HTTPS القياسية وحمولات JSON.

تصبح الحقول المخصصة المضافة في BITEX جزءًا من بيانات تعريف DocType وتكون متاحة لعمليات التكامل على الفور. على سبيل المثال، إذا أضافت شركة ما حقلاً مخصصًا مثل marketplace_order_id في أمر المبيعات أو courier_tracking_id في مذكرة التسليم، فيمكن لتطبيقات الجهات الخارجية إرسال هذه القيم واستلامها من خلال نفس REST API المستخدم للحقول القياسية.

يعد هذا مفيدًا بشكل خاص عندما يكون BITEX متصلاً بأنظمة خارجية تحتاج إلى معرفات أو حالات أو مراجع أو بيانات تشغيلية خاصة بها. تسمح الحقول المخصصة للفرق بتوسيع BITEX دون كسر نموذج البيانات القياسي.

كيف تعمل واجهات برمجة تطبيقات REST

يوفر Frappe نقاط نهاية REST API لـ DocTypes. يمكن لتطبيق جهة خارجية المصادقة باستخدام مفتاح API وسر API، ثم استدعاء نقاط النهاية لسرد المستندات، أو جلب مستند محدد، أو إنشاء سجل جديد، أو تحديث سجل موجود، أو حذف سجل حيث تسمح الأذونات بذلك.

تتضمن أنماط التكامل الشائعة ما يلي:

  • اقرأ من BITEX: جلب العملاء أو العناصر أو الأسعار أو مستويات المخزون أو الفواتير أو حالة الدفع.
  • اكتب إلى BITEX: أنشئ العملاء المتوقعين أو العملاء أو أوامر المبيعات أو أوامر الشراء أو مذكرات التسليم أو إدخالات الدفع أو تذاكر الدعم.
  • تحديث BITEX: أرسل تحديثات الشحن أو مراجع التسوية أو معرفات المعاملات المصرفية أو معرفات أوامر السوق أو حالات التنفيذ.
  • ** الرد على أحداث BITEX: ** استخدم خطافات الويب لإعلام تطبيق آخر عند إنشاء مستند أو تحديثه أو إرساله أو إلغائه.

أمثلة على التكامل

  • CRM: مزامنة العملاء المتوقعين والفرص والعملاء وعروض الأسعار وحالة المتابعة بين BITEX ومبيعات CRM.
  • الخدمات اللوجستية: أرسل مذكرات التسليم أو طلبات الشحن إلى منصة البريد السريع واستقبل أرقام التتبع مرة أخرى في BITEX.
  • إدارة الطلبات: ادفع الطلبات من نظام إدارة الطلبات إلى BITEX كأوامر مبيعات، ثم أرسل حالة الاستيفاء والفاتورة مرة أخرى.
  • منصات إعادة التجارة: مزامنة كتالوج المنتجات وطلبات العملاء وتوافر المخزون والمرتجعات وحالة التجديد والدفعات.
  • ** خدمات Google: ** قم بتوصيل BITEX بمساحة عمل Google أو تقويم Google أو أوراق Google أو سير عمل التقارير.
  • البنوك وأنظمة الدفع: استيراد المعاملات المصرفية، أو تحديث مراجع الدفع، أو تسوية المدفوعات، أو ربط سير عمل تحصيل المدفوعات.

تدفق التكامل النموذجي

  1. حدد BITEX DocTypes المعني، مثل العميل أو العنصر أو أمر المبيعات أو مذكرة التسليم أو فاتورة المبيعات أو إدخال الدفع أو DocType المخصص.
  2. قم بتعيين الحقول بين BITEX والتطبيق الخارجي، بما في ذلك أي حقول مخصصة تتطلبها عملية الأعمال.
  3. قم بإنشاء مستخدم تكامل في BITEX بالأدوار والأذونات المطلوبة للتكامل فقط.
  4. قم بإنشاء بيانات اعتماد API لهذا المستخدم ومصادقة مكالمات API بشكل آمن.
  5. استخدم نقاط النهاية REST API لإنشاء السجلات أو جلبها أو تحديثها أو حذفها حسب الحاجة.
  6. استخدم خطافات الويب أو وظائف الخلفية للمزامنة المستندة إلى الأحداث وإعادة المحاولة والمعالجة غير المتزامنة.

الممارسات الجيدة

  • استخدم مستخدم تكامل مخصصًا بدلاً من حساب المسؤول.
  • قم بتطبيق الأذونات المستندة إلى الأدوار حتى يتمكن التكامل من الوصول إلى السجلات التي يحتاجها فقط.
  • قم بتخزين المعرفات الخارجية في الحقول المخصصة لتسهيل عملية التسوية واستكشاف الأخطاء وإصلاحها.
  • يجب أن تكون عمليات تكامل التصميم غير فعالة، لذا فإن إعادة محاولة الطلب لا تؤدي إلى إنشاء سجلات مكررة.
  • استخدم خطافات الويب أو قوائم الانتظار لسير العمل بكميات كبيرة بدلاً من جعل كل شيء متزامنًا.
  • قم بتسجيل معرفات الطلبات والمراجع الخارجية ورسائل الخطأ حتى يمكن تتبع حالات الفشل بسرعة.

موضوعات ذات صلة