تخط وانتقل إلى المحتوى الرئيسي

الربط مع طرف ثالث باستخدام الـ API

إذا كنت تدير متجرًا داخل مول، فإن إدارة المول تحتاج إلى متابعة الطلبات الواردة إلى كل متجر، ولتحقيق ذلك، يجب ربط "إدارة" مع النظام الخاص بالمول للاطلاع على طلبات المبيعات بشكل لحظي.

الربط مع طرف ثالث باستخدام الـ API

تستطيع إتمام ذلك باتباع الخطوات التالية:

1- إنشاء مستخدم للربط (Token) من خلال "إدارة"

  • اذهب إلى معالجة البيانات

  • افتح صفحة التكامل

  • اضغط على "تحكم" أسفل "تكامل مخصص"

  • اضغط على "أضف مستخدم جديد"

  • أضِف وصفًا (اسم) لمستخدم الربط (Token)

  • امنح صلاحية "الحصول على المخزن حسب الاسم" و "استرجاع قائمة مستندات المبيعات حسب معايير محددة"

  • اضغط على "حفظ"

ملحوظة: المستخدم الذي تمت إضافته مخصص فقط لعملية الربط عبر الـ API، ولا يمكنه تسجيل الدخول إلى واجهة برنامج "إدارة".

2- منح المستخدم صلاحية على المخزن والأصناف

لا بد وأن يكون للمستخدم (اسم الـ Token) صلاحية لاستعراض المخزن، والأصناف لذا يجب منحه صلاحية على ذلك، ويمكنك التعرف على الخطوات من خلال المقالات التالية:

ملاحظات:

  • قبل تنفيذ الخطوات التالية، تأكد أن لديك أحد برامج اختبار الـ End Point) API).

  • تأكد عند إضافة رمز التفويض (authorization Token) أنه من نوع "Bearer"، ومن ثم تأكد من حذف كلمة "Bearer" من الرابط (Token) نفسه، وكذلك تأكد من عدم وجود أي مسافات إضافية في بدايته أو نهايته.

3- معرفة ID المخزن

وهذه أولى الخطوات التي ينفذها الطرف الثالث أو المبرمج، وهنا لا بد وأن يكون لديه:

  • اسم المخزن كما هو موجود على "إدارة"

  • الـ End Point المتمثلة في: “Return a Warehouse by Name"

وفيما يلي مثال لطريقة كتابة الـ End Point في هذه الخطوة:

https://api.edara.io/v2/warehouses/FindByName/Zayed Warehouse

ستظهر لك النتيجة كما يلي، حيث يوضّح النظام معرف المخزن (ID) بناءً على اسم المخزن الذي تم إدخاله:

4- استدعاء الأوردرات بالـ API

يرجى مراعاة المتطلبات التالية في الـ API:

  • معرف المخزن (إجباري): عدد صحيح (ID).

  • التاريخ من: (صيغة التاريخ والوقت) (مثل 2020-01-08T00:00:00.00Z) (إجباري)

  • التاريخ إلى: (صيغة التاريخ والوقت) (مثل 2020-01-08T00:00:00.00Z) (إجباري)

  • نوع المستند: SO، SR، أو NULL

مثال على رابط الاستدعاء (API Sample):

https://api.edara.io/v2/salesOrders/Find?warehouseID=1&limit=20&dateFrom=2025-08-21T00:00:00.00Z&dateTo=2025-08-26T23:59:59.00Z&offset=0

ستظهر لك النتيجة كما يلي:

ملاحظات هامة:

  • الحد الأقصى لاسترجاع الطلبات هو 1000 معاملة لكل استدعاء.

  • لن يتم استرجاع المستندات الخاصة بالخدمات فقط من خلال هذه الواجهة البرمجية.

  • إذا لم يكن رمز الاستجابة (Response Code) يساوي 200 عند استدعاء الـ API، تأكد من صحة رابط الـ API، وصحة إدخال رمز التفويض (Token)، ومنح مستخدم التكامل الصلاحيات اللازمة.

  • يمكنك الحصول على المزيد من الـ End Points عن طريق مركز الدعم الخاص بالتكامل.

في حال واجهتك أي تحديات أو استفسارات أثناء تنفيذ العمليات، يمكنك التواصل مع فريق الدعم الفني الخاص بنا، فهو على استعداد لمساعدتك.

المقالات ذات الصلة
تثبيت الإضافات اللازمة للربط مع ووكومرس
هل أجاب هذا عن سؤالك؟