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