اربط نظام ERP الخاص بك بـ Global Container Network

لمن هذا موجّه

مصمّم للشركات التي تدير حاوياتها بالفعل في نظام ERP أو TMS أو جدول بيانات وترغب في إتاحة ذلك الكتالوج مباشرةً على GCN.

• التجار والمؤجّرون الذين يزامنون مخزون البيع / التأجير
• المستودعات وحائزو المخزون الذين ينشرون التوافر المباشر
• الناقلون ووكلاء الشحن الذين يرفعون عروض الشحن

خطوات التأهيل

1. 1

   التسجيل كشركة

   أنشئ حساب أعمال باسم شركتك. لا يمكن للحسابات الفردية إصدار مفاتيح API.

   فتح التسجيل
2. 2

   تقديم توثيق KYB / الشركة

   أكمل ملف مؤسستك. إلى أن يوثّقك المسؤول، تبقى عمليات إنشاء API بحالة PENDING. تنشر المؤسسات الموثّقة تلقائياً بحالة ACTIVE.

   فتح لوحة تحكم الشركة
3. 3

   إصدار مفتاح API

   في لوحة التحكم ← واجهة برمجة التطبيقات للمؤسسات، أنشئ مفتاح TEST أو LIVE. انسخه مرة واحدة — فهو يُعرض عند الإنشاء فقط.

   فتح واجهة برمجة التطبيقات للمؤسسات
4. 4

   استيراد Postman (أو OpenAPI)

   استورد المجموعة، واضبط مفتاح apiKey الخاص بك، ثم شغّل Ready ← Me ← المخزون/الإعلانات بالجملة. استخدم externalId ثابتاً من نظام ERP لكل صف.

   تنزيل مجموعة Postman
5. 5

   مزامنة الكتالوج وتسجيل خطافات الويب

   حدِّث حتى 200 عنصر في كل طلب عبر جميع الوحدات. اختياري: سجّل رابط خطاف ويب لأحداث الإنشاء / الإشراف / الاستفسار.

   قراءة وثائق API

أدوات المُكامِل

• /api/v1/ready — يؤكّد أن المخطط مفعّل
• /api/v1/openapi — مخططات OpenAPI 3 الكاملة
• مجموعة Postman — طلبات جاهزة للتشغيل
• مرجع API — نقاط النهاية والنطاقات والملاحظات

قواعد تتجنّب فشل المزامنة

• يحتاج كل عنصر بالجملة إلى externalId ثابت (المفتاح الأساسي في نظام ERP).
• حد أقصى 200 عنصر لكل طلب بالجملة — قسّم الكتالوجات الأكبر إلى صفحات.
• استخدم Idempotency-Key عند إعادة محاولات POST/PATCH.
• تكتب مفاتيح TEST حالياً على قاعدة البيانات ذاتها التي تكتب عليها مفاتيح LIVE — تعامل معها بحذر إلى أن يُطرح عزل بيئة الاختبار.