تغطّي ZR Express الـ 58 ولاية، بشبكة قوية من نقاط الاستلام وتطبيق تتبع مألوف. تُشغّل ZR واجهتَي API — واجهة Procolis الكلاسيكية على procolis.com والمنصة الأحدث على api.zrexpress.app — لكن في DZBuild توجد بطاقة واحدة باسم «ZR Express».
أنت لا تختار API. الصق أيّ زوج بيانات لديك وتتولّى DZBuild الباقي: تجرّب المنصة الجديدة أولاً، ثم ترجع إلى زوج Procolis الكلاسيكي، وتحفظ الربط تحت المنصة التي قبلت البيانات (النجاح على الكلاسيكية يظهر برسالة «تم الاتصال بنجاح مع ZR Express (المنصة القديمة)»).
المتاجر التي رُبطت قبل دمج البطاقتين تحتفظ بربطها الكلاسيكي القائم مع ZR Express وتُديره من نفس البطاقة.
ما تحتاجه
قيمتان، مهما كانت منصتك. في البطاقة يحمل الحقلان اسمَي API ID و API TOKEN:
منصتك | API ID | API TOKEN |
المنصة الجديدة | Secret Key | Tenant ID (UUID مثل |
Procolis الكلاسيكي | Token | Key |
كلتاهما من حسابك في ZR Express — البوابة الجديدة تعرضهما في قسم API/التكاملات، واللوحة الكلاسيكية في إعدادات API الخاصة بها.
أما Abex Express فتعمل على نفس بنية API Procolis وعلى نفس النطاق، ولا تزال تعرض تسميتَي Token / Key — لكن لها بطاقتها الخاصة وبياناتها الصادرة عن Abex وبيانات بلدياتها المُزامَنة الخاصة. والاثنتان غير قابلتين للتبديل.
ربط ZR Express في DZBuild
افتح
/dashboard/link-shippingوابحث عن «ZR Express».اضغط ربط على البطاقة.
الصق القيمتين في API ID و API TOKEN.
اضغط اختبار الاتصال. تجرّب هذه الضغطة الواحدة المنصتين بالتتابع — الجديدة أولاً ثم Procolis الكلاسيكية — وتخبرك أيّهما قبلت بياناتك.
اضغط ربط وحفظ.
ما الذي يُسحب
قائمة الولايات والبلديات التي تخدمها الشركة.
أسعار التوصيل للبيت لكل ولاية.
أسعار نقاط الاستلام لكل ولاية.
قائمة نقاط الاستلام — في المنصة الجديدة فقط. تأتي من بحث المراكز (hubs) لدى ZR مع الإبقاء على المراكز المؤشَّرة كنقاط استلام، وتغذّي مُختار Stop Desk.
منصة Procolis الكلاسيكية لا تنشر أي قائمة مكاتب إطلاقاً. لذلك تُعتبر كل بلديات الولاية مؤهّلة للتوصيل للمكتب كلما كان سعر Stopdesk في تلك الولاية أكبر من صفر؛ ثم يختار الزبون خياراً عاماً على مستوى البلدية باسم «وكالة ZR Express»، وتختار ZR المكتب الفعلي عند إرسال الطرد.
⚠️ تنبيه — المنصة الجديدة: معرّفات المناطق (UUID)
تتعامل المنصة الجديدة مع الأماكن عبر UUID للمنطقة لا عبر الاسم. وإذا كانت بيانات المناطق المُزامَنة قديمة يفشل الإرسال برسالة «تعذر العثور على معرّفات المنطقة». الحل: اضغط تحديث البيانات على بطاقة ZR Express (أو انتظر التحديث اليومي التلقائي) ثم أعد الإرسال.
ماذا يحدث عند شحن طلب
تُرسل DZBuild بيانات الزبون والولاية والبلدية ووصف المنتج ورقم طلبك كمرجع خارجي ومبلغ COD — وهو في كلتا المنصتين مجموع الطلب (المنتجات مع الشحن) لا المجموع الفرعي.
ويُعبَّر عن التوصيل للمكتب بطريقة مختلفة في كل منصة، ولا تستعمل أيّ منهما is_stopdesk أو stopdesk_id:
Procolis الكلاسيكي:
TypeLivraison = 1(و 0 = بيت). ولا يُرسَل أي وزن.المنصة الجديدة:
deliveryType: "pickup-point"معhubId. وإن لم يُزوَّد أي مركز تختار DZBuild الأقرب تلقائياً؛ وإن فشل ذلك يُرفَض الإرسال بدل أن يُخفَّض إلى توصيل بيت.
تُرجع ZR Express رقم تتبع تحفظه DZBuild على الطلب وتعرضه للزبون.
ووصف المنتج محدود بـ 100 حرف على المنصة الجديدة (و 250 على Procolis الكلاسيكي)، وأي | في اسم منتج تُستبدل بشرطة.
أخطاء شائعة وحلولها
الرسالة | السبب | الحل |
| أحد الحقلين فارغ | الحقلان مطلوبان معاً — تأكّد من لصق UUID كاملاً. |
فشل اختبار الاتصال برسالة ZR نفسها | لم تقبل أي من المنصتين الزوج | تُظهر DZBuild خطأ المنصة الجديدة عندما تفشل المحاولتان، لذا قد لا تذكر الرسالة التي تراها Procolis حتى لو كان حسابك كلاسيكياً. أعد نسخ القيمتين؛ وإن استمر الخطأ اطلب من ZR Express تفعيل وصول API. |
| تعذّر على المنصة الجديدة تحديد معرّفات منطقة الولاية/البلدية | اضغط تحديث البيانات على البطاقة ثم أعد إرسال الطلب. |
ورسائل Procolis الكلاسيكية مثل Clé non détectée S1 / S2 و Token désactivé قد تظهر أيضاً على حالة التوصيل الخاصة بالطلب للحسابات على المنصة القديمة — وتعني على الترتيب: Token خاطئ، Key خاطئ، وحساب معطّل.
نصائح
لا حاجة لأي إلغاء ربط يدوي عند الانتقال بين المنصتين: حفظ أي من زوجَي البيانات يحلّ تلقائياً محل ربط ZR Express الآخر ويرث منه إعداد «الشركة الافتراضية». تحفظ DZBuild مزوّد ZR Express واحداً لكل متجر.
إدارة المزوّدين (الربط، الإدارة، الاختبار، إلغاء الربط، التعيين كافتراضي) مكانها
/dashboard/link-shipping؛ أما أسعار الولايات فمكانها/dashboard/shipping.إن كان زبائنك يحتاجون فعلاً إلى اختيار مكتب بالاسم، فأنت بحاجة إلى المنصة الجديدة — فالـ API الكلاسيكي لا يقدّم سوى خيار الوكالة العام على مستوى البلدية.