كيف تعمل شركاء Loops

تربط Loops التجار بالقنوات التي يبيعون عبرها: تطبيقات التوصيل والأسواق الإلكترونية ومنصات التجارة الإلكترونية. وتمنح واجهة شركاء Loops نظامك وصولًا إلى هذه الشبكة للتجار الذين يختارون الارتباط بك.

 نظامك                          Loops                            القنوات
 (نقاط بيع، تخطيط موارد، أداة)                                    (تطبيقات توصيل، أسواق)

   ┌────────┐   واجهة الشركاء  ┌──────────────────────┐   ┌──── القناة أ
   │  أنت   │ ◀──────────────▶ │  توحيد · توجيه       │ ◀─┼──── القناة ب
   └────────┘   Webhooks       │  موافقة التاجر       │   └──── القناة ج
                               └──────────────────────┘

المكونات

التطبيق : تكاملك الخاص. له معرّف عميل ومفتاح سري، والصلاحيات التي اعتمدتها Loops، وعناوين الـ Webhook الخاصة بك. لكل من البيئة التجريبية والإنتاج تطبيق مستقل.

التاجر : نشاط تجاري يستخدم Loops (mer_…). للتاجر علامات تجارية وفروع (loc_…).

ارتباط القناة : ربط فرع بحساب في قناة معيّنة (chc_…). يديره التاجر في Loops، وتستطيع قراءته لتعرف مصدر طلبات كل فرع.

الارتباط : موافقة التاجر على تطبيقك (con_…)، وتحدد الفروع التي يمكنك الوصول إليها والصلاحيات الممنوحة. يمكن للتاجر تعديلها أو إلغاؤها في أي وقت.

الطلب : طلب من أي قناة بصيغة موحدة (ord_…)، مع الاحتفاظ برقم الطلب في القناة في الحقل channel_ref.

الحدث : سجل لما حدث، مثل order.created. تُرسل الأحداث إلى عناوين الـ Webhook الخاصة بك، وتبقى متاحة للاستعراض لمدة 30 يومًا.

كيف يعمل التكامل عادة

1. تحصل على الاعتماد وتستلم بيانات اعتماد البيئة التجريبية.
2. يرتبط بك تاجر: يوافق على وصولك ويختار فروعه، فيصلك حدث connection.created يحمل معرّف التاجر ومرجعك الخاص به.
3. تزامن البيانات الحالية: استعرض فروع التاجر وطلباته الأخيرة.
4. تبقى متزامنًا: تصلك الطلبات الجديدة وتغيّرات الحالة عبر الـ Webhooks لحظة حدوثها.
5. تتعافى بعد الانقطاع: إذا تعذّر الوصول إلى عنوانك، استعرض الأحداث بعد آخر حدث عالجته.

المتاح الآن

تغطي نسخة المعاينة قراءة البيانات:

• الفروع وارتباطاتها بالقنوات؛
• الطلبات بتفاصيلها الكاملة مع المزامنة التدريجية؛
• أحداث الطلبات عبر الـ Webhooks؛
• واجهة الأحداث.

الكتابة إلى Loops ضمن الخطة القادمة: قبول الطلبات ورفضها، والقوائم، والتوفر، وأوقات العمل. راجع ما القادم.