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

ZR Express

تغطّي ZR Express الـ 58 ولاية، بشبكة قوية من نقاط الاستلام وتطبيق تتبع مألوف. تدعم DZBuild كلا API:

  • ZR Express (Procolis) — API القديم على procolis.com. اختره إذا كانت لوحة تحكمك هي القديمة.
  • ZR Express New Platform — API الجديد على api.zrexpress.app. اختره إذا كانت لوحة تحكمك هي البوابة الجديدة بـ UUID للمستأجر.

إن لم تكن متأكداً أيّهما لديك، اسأل دعم ZR Express — حسابك على واحد فقط.

ما تحتاجه​

ZR Express الكلاسيكي (zrexpress)​

  • Token
  • Key

كلاهما من حسابك في اللوحة القديمة. نفس بنية Procolis تعمل أيضاً مع Abex Express تحت معرّف abexexpress.

ZR Express المنصة الجديدة (zr-express-new)​

  • API Key (المفتاح السري)
  • Tenant ID (UUID يميّز حسابك)

تجدهما في البوابة الجديدة في قسم API/التكاملات. الـ Tenant ID على شكل UUID مثل xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.

ربط ZR Express في DZBuild​

  1. افتح /dashboard/shipping.
  2. اضغط Link provider واختر ZR Express (الكلاسيكي) أو ZR Express New Platform.
  3. الصق البيانات من الجدول المطابق أعلاه.
  4. اضغط Test API. تستدعي DZBuild نقطة تحقق مباشرة (كلاسيكي: /token؛ جديد: /api/v1/users/profile) وتُظهر أخضر إذا كانت البيانات صحيحة.
  5. احفظ.

ما الذي يُسحب​

  • قائمة الولايات والبلديات التي تخدمها الشركة.
  • أسعار التوصيل للبيت لكل ولاية.
  • أسعار نقاط الاستلام لكل ولاية.
  • قائمة نقاط الاستلام لكل ولاية، تستعملها إضافة Stop Desk.

ماذا يحدث عند شحن طلب​

تُرسل DZBuild الطرد مع بيانات الزبون ومبلغ COD (المجموع الفرعي) والولاية/البلدية، إضافة إلى is_stopdesk وstopdesk_id لتوصيل المكتب. تُرجع ZR Express رقم تتبع تحفظه DZBuild على الطلب وتعرضه للزبون.

أخطاء شائعة وحلولها​

الرسالةالسببالحل
Token غير صحيح (Procolis "Clé non détectée S1")Token خاطئأعد نسخ Token من لوحة ZR Express.
Key غير صحيح (Procolis "Clé non détectée S2")Key خاطئ، أو API غير مفعّل لحسابكأعد نسخ Key؛ إن استمرّت الرسالة، اطلب من ZR Express تفعيل API.
الحساب معطل (Procolis "Token désactivé")الحساب موقوفتواصل مع ZR Express لإعادة تفعيله.
المنصة الجديدة: "API Key و Tenant ID مطلوبان"أحد الحقلين مفقودالحقلان مطلوبان معاً في المنصة الجديدة — تأكّد من لصق UUID كاملاً.

نصائح​

  • لا تخلط بين API: بيانات الكلاسيكي لا تعمل على الجديد والعكس صحيح.
  • عند الانتقال من الكلاسيكي إلى الجديد، افصل القديم أولاً من /dashboard/shipping ثم اربط الجديد — تحفظ DZBuild مزوّد ZR Express واحداً لكل متجر في كل لحظة.
  • لا تزال أغلب المتاجر على API الكلاسيكي؛ لا تنتقل إلى الجديد إلا حين تطلبه ZR Express.