Maystro Delivery شركة توصيل وطنية بحضور قوي في الولايات الجزائرية. التكامل من أبسط ما يكون: توكن API واحد فقط هو كل ما تحتاجه.
ما تحتاجه
قيمة واحدة، اسمها Authentication Token في نافذة البيانات، تُصدر من لوحة تحكم Maystro للتجار. تصادق Maystro بالترويسة
Authorization: Token <value>— وهي ليست توكن Bearer.
إن لم يتح حسابك وصول API، تواصل مع Maystro لتفعيله.
ربط Maystro في DZBuild
افتح
/dashboard/link-shippingواعثر على بطاقة Maystro.اضغط ربط.
الصق Authentication Token في حقل البيانات الوحيد.
اضغط اختبار الاتصال. تستدعي DZBuild Maystro مباشرةً وتؤكّد صلاحية التوكن.
اضغط ربط وحفظ.
أما أسعار الولايات فتُحرَّر في الصفحة المنفصلة /dashboard/shipping.
ما الذي يُسحب
قائمة الولايات التي تخدمها Maystro.
البلديات لكل ولاية.
أسعار البيت + المكتب لكل ولاية — انظر أدناه.
قائمة نقاط الاستلام لـمُختار Stop Desk.
الأسعار
أسعار Maystro قابلة للمزامنة. فـ مزامنة الأسعار تقرأ تسعيرة التوصيل الخاصة بـ Maystro لكل ولاية وتملأ سعر البيت وسعر المكتب معاً.
مع تحفّظ واحد يستحق المعرفة: تُسعّر Maystro حسب البلدية لا حسب الولاية، لذلك تقارب DZBuild كل ولاية ببلدية مركزها. والولاية التي لا تُرجع بلدية مركزها أي تسعيرة تبقى على 0 — اضبطها يدوياً في /dashboard/shipping.
المكاتب
تُكتشَف قائمة مكاتب Maystro بلديةً بلدية، بدءاً من بلدية مركز كل ولاية. لذلك قد يحتاج مكتب في بلدية طرفية إلى دورة مزامنة كاملة ليظهر — والضغط على تحديث البيانات في بطاقة Maystro يفرض ذلك.
ولا تُدرَج سوى مكاتب Maystro الخاصة؛ أما نقاط استلام الشركاء فغير مدعومة.
ماذا يحدث عند شحن طلب
تُرسل DZBuild الطلب إلى Maystro بالاسم والهاتف والعنوان والولاية الوجهة والبلدية على شكل معرّف البلدية الرقمي لدى Maystro وقائمة المنتجات ورقم طلبك كـ external_order_id والقيمة product_price — وهي مجموع الطلب لا المجموع الفرعي.
أمران لا تستقبلهما Maystro:
الوزن لا يُرسَل إلى Maystro إطلاقاً.
لا معرّف مكتب. يُعبَّر عن التوصيل للمكتب بـ
delivery_type: 2فقط (1 = بيت، 3 = نقطة استلام). أما المكتب المحدّد الذي اختاره الزبون فلا يُمرَّر اليوم — فقط البلدية وراية المكتب.
يُستخرَج معرّف البلدية من بيانات البلديات المُزامَنة في DZBuild ثم من بحث مباشر؛ وإن تعذّر استخراجه يفشل الإرسال برسالة «لم يتم العثور على البلدية …».
تُرجع Maystro رقم تتبع (يُحفظ على الطلب) ورابط ملصق.
📝 ملاحظة — طباعة ملصق Maystro
لا يوجد أي زر في لوحة التحكم يفتح رابط ملصق Maystro — والضغط على طباعة الملصق في طلب Maystro يطبع وصل DZBuild الخاص بصيغة HTML. أما بوردرو Maystro الرسمي فاطبعه من بوابة Maystro.
أخطاء شائعة وحلولها
العَرَض | السبب المحتمل | الحل |
اختبار الاتصال يفشل فوراً | توكن خاطئ أو منتهٍ | انسخ Authentication Token جديداً من Maystro وأعد لصقه. |
| البلدية الموجودة على الطلب ليس لها معرّف بلدية لدى Maystro | صحّح البلدية على الطلب، أو اضغط تحديث البيانات على البطاقة لإعادة مزامنة قائمة بلديات Maystro. |
بعض الولايات ما زالت بسعر 0 بعد المزامنة | لم تُرجع Maystro أي تسعيرة لبلدية مركز تلك الولاية | اضبط تلك الولايات يدوياً في |
نصائح
إن لم يكن لحسابك في Maystro أي شحنات بعد، يعود اختبار الاتصال ببيانات قليلة جداً. يكفي أن تُظهر DZBuild أخضر لتعرف أن التوكن صالح.
بعد مزامنة الأسعار، راجع الجدول في
/dashboard/shipping— فمقاربة بلدية المركز قد تكون أعلى أو أدنى قليلاً مما تدفعه فعلاً في البلديات الطرفية.Maystro خيار جيد كمكمّل لـ Yalidine حين تريد بديلاً لمناطق معيّنة.