Yalidine

Yalidine من أكثر شركات التوصيل الوطنية استخداماً في الجزائر، تغطّي الـ 58 ولاية، وتمتلك شبكة كبيرة من نقاط الاستلام و API مستقراً. يدعم نفس التكامل في DZBuild أيضاً Yalitec وGuepex وEasy & Speed التي تشترك مع Yalidine في بنية API لكن لها لوحات تحكم مستقلة.

ما تحتاجه

تحتاج فقط قيمتين من لوحة تحكم Yalidine:

• API ID
• API Token

كلاهما يُصدر من حسابك في Yalidine؛ إن لم تجدهما اطلب من Yalidine تفعيل وصول API لحسابك. عادةً يتطلب الوصول إلى API حساباً تجارياً موثّقاً.

ربط Yalidine في DZBuild

1. افتح /dashboard/shipping في لوحة التحكم.
2. اضغط Link provider واختر Yalidine (أو Yalitec / Guepex / Easy & Speed إن كانت شركتك).
3. الصق API ID في الحقل الأول.
4. الصق API Token في الحقل الثاني.
5. اضغط Test API. تتصل لوحة التحكم بـ Yalidine مباشرةً وتُظهر علامة خضراء عند صحة البيانات.
6. احفظ.

تصبح Yalidine هي مزوّد التوصيل الافتراضي للمتجر. من نفس الصفحة يمكنك:

• Sync rates from provider — لسحب أسعار البيت ونقاط الاستلام لكل ولاية.
• تجاوز سعر أي ولاية يدوياً إن أردت تحمّل جزء من الشحن أو تطبيق هامش.

ما الذي يُسحب

• قائمة كاملة من الولايات والبلديات (مع تحويل تلقائي لاسم البلدية من العربية إلى الفرنسية كما يطلبها Yalidine).
• سعر التوصيل للبيت لكل ولاية.
• سعر نقطة الاستلام لكل ولاية.
• قائمة نقاط الاستلام في كل ولاية، تُستعمل في مُختار نقاط الاستلام.

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

عند تأكيد طلب من /dashboard/orders ومزوّد المتجر هو Yalidine، تستدعي DZBuild نقطة /parcels/ بالبيانات التالية:

• الاسم واللقب ورقم الهاتف (يُهيّأ تلقائياً للصيغة المحلية 0X، مع رقم ثانٍ إن جمعته).
• العنوان، الولاية الوجهة، البلدية الوجهة (محوّلة للاسم الفرنسي).
• ولاية الانطلاق (ولاية متجرك — تُستخدم كـ from_wilaya_name).
• ملخص قائمة المنتجات.
• مبلغ COD (price = المجموع الفرعي، يدفعه الزبون عند الاستلام).
• القيمة المعلنة، الطول، العرض، الارتفاع، الوزن.
• الراية is_stopdesk إضافة إلى stopdesk_id صحيح عند توصيل المكتب.
• freeshipping و do_insurance ورايات التبديل عند الحاجة.

تُرجع Yalidine:

• رقم تتبع (يُحفظ على الطلب).
• رابط ملصق (PDF) للطباعة المباشرة.

تنتقل حالة الطلب إلى shipped ويرى الزبون رقم التتبع على صفحة طلبه. مع تحرّك الطرد، تتدفق التحديثات عودةً إلى المخطّط الزمني للطلب (processing → shipped → delivered أو returned / cancelled).

نقاط الاستلام مع Yalidine

تمتلك Yalidine أكبر شبكة نقاط استلام في الجزائر. عند اختيار الزبون لتوصيل المكتب:

• تعرض إضافة Stop Desk المكاتب في الولاية المحدّدة مع الاسم والعنوان والهاتف.
• تحفظ DZBuild stopdesk_id على الطلب — Yalidine تتطلب هذا، وإن غاب لشحنة مكتبية، تُرجع DZBuild خطأ قبل الإرسال حتى لا تتحوّل الشحنة عن طريق الخطأ إلى توصيل بيت.

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

الرسالة	السبب	الحل
بيانات API غير صحيحة / HTTP 401	API ID أو API Token خاطئ	أعد نسخ القيمتين من لوحة Yalidine؛ من السهل تبديل الحقلين.
غير مصرح / HTTP 403	الحساب موجود لكن API غير مفعل	تواصل مع Yalidine لتفعيل API على حسابك.
تم تجاوز حد الطلبات / HTTP 429	كثرة طلبات في وقت قصير	انتظر دقيقة ثم أعد المحاولة؛ Yalidine تحدّ المعدل بصرامة.
لا يوجد مكتب استلام (Stop Desk) متاح	شحنة مكتبية بدون stopdesk_id	اطلب من الزبون اختيار مكتب جديد أو حوّل الطلب إلى توصيل بيت.
إنشاء الطلب دون رقم تتبع	عنوان أو بلدية غير مفهومين	تحقق من كتابة البلدية ثم أعد الإرسال. تُظهر سجلات الطلب في DZBuild الاستجابة الخام من Yalidine.

نصائح

• تتوقّع Yalidine البلديات بالفرنسية. تتولى DZBuild الترجمة من العربية تلقائياً عبر جدول communes، لكن الكتابات النادرة قد تفشل — حافظ على نظافة قائمة بلديات متجرك.
• القيمة price التي تُرسَل إلى Yalidine هي المجموع الفرعي (سعر المنتجات) لا الإجمالي مع الشحن. هذا هو ما تجمعه الشركة في COD.
• إن كان لديك حساب في Yalitec / Guepex / Easy & Speed، اربطه تحت معرّفه؛ بنية API نفسها لكن البيانات غير قابلة للتبديل.