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

Maystro Delivery

Maystro Delivery شركة توصيل وطنية بحضور قوي في الولايات الجزائرية. التكامل من أبسط ما يكون: توكن API واحد فقط هو كل ما تحتاجه.

ما تحتاجه​

  • API token (توكن Bearer وحيد يُصدر من لوحة تحكم Maystro للتجار).

إن لم يتح حسابك وصول API، تواصل مع Maystro لتفعيله.

ربط Maystro في DZBuild​

  1. افتح /dashboard/shipping.
  2. اضغط Link provider واختر Maystro.
  3. الصق API token في الحقل الوحيد.
  4. اضغط Test API. تستدعي DZBuild نقطة الطلبات في Maystro مباشرةً وتؤكّد صلاحية التوكن.
  5. احفظ.

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

  • قائمة الولايات التي تخدمها Maystro (Maystro لا تعرض نقطة wilayas، لذلك تأتي DZBuild بالقائمة المعيارية الـ 58 ولاية وتستخدم تطابق رموز Maystro).
  • البلديات لكل ولاية.
  • قائمة نقاط الاستلام لكل ولاية لمستعمل مُختار Stop Desk.

لا تُسحب الأسعار آلياً من Maystro لكل ولاية — تضبطها يدوياً في /dashboard/shipping. يمكنك تطبيق متوسط افتراضي من اللوحة أو التعديل ولاية ولاية.

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

تُرسل DZBuild الطلب إلى نقطة الطلبات في Maystro بالاسم والهاتف والعنوان ومبلغ COD (المجموع الفرعي) ورمز الولاية والبلدية والوزن. لتوصيل المكتب، تمرّر DZBuild أيضاً is_stopdesk (إلى جانب التعيينات stopdesk / stopdesk_id التي تقبلها Maystro).

تُرجع Maystro:

  • رقم تتبع (يُحفظ على الطلب).
  • رابط ملصق على https://backend.maystro-delivery.com/api/stores/orders_store/{tracking}/label/ لطباعة البوردرو.

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

العَرَضالسبب المحتملالحل
Test API يفشل فوراًتوكن خاطئ أو منتهٍانسخ توكناً جديداً من Maystro وأعد لصقه.
الطلب مرفوض بسبب خطأ ولايةرمز ولاية خاطئتأكّد أن ولاية الزبون من الرموز الـ 58 المعيارية — Maystro تتوقع الرمز كسلسلة نصية.
لا يصدر ملصقرقم التتبع محفوظ لكن نقطة الملصق لم تجهز بعدانتظر دقيقة ثم اضغط "Print label" مجدداً — Maystro تولّد الملصقات بشكل غير متزامن.

نصائح​

  • Test API في Maystro يطلب قائمة الطلبات؛ إن لم يكن لحسابك شحنات بعد، تأتي الاستجابة قليلة المحتوى. يكفي أن تُظهر DZBuild أخضر لتعرف أن التوكن صالح.
  • اضبط أسعار البيت ونقطة الاستلام يدوياً في /dashboard/shipping لكل ولاية — انقلها مباشرة من آخر فاتورة Maystro لتنطلق بسعر عادل.
  • Maystro خيار جيد كمكمّل لـ Yalidine حين تريد بديلاً لمناطق معيّنة.