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

Yalidine

اربط Yalidine بمتجرك في DZBuild لشحن الطلبات وتوليد أرقام التتبع ومزامنة الولايات والبلديات والأسعار ونقاط الاستلام عبر API الرسمي.

بقلم: Support

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

ما تحتاجه

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

  • API ID

  • API Token

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

ربط Yalidine في DZBuild

  1. افتح /dashboard/link-shipping في لوحة التحكم وابحث عن «Yalidine» في شبكة البطاقات (أو Yalitec / Guepex / Easy & Speed إن كانت شركتك).

  2. اضغط ربط على البطاقة.

  3. الصق API ID في الحقل الأول.

  4. الصق API Token في الحقل الثاني.

  5. اضغط اختبار الاتصال. تتصل لوحة التحكم بـ Yalidine مباشرةً وتُظهر علامة خضراء عند صحة البيانات.

  6. اضغط ربط وحفظ. وفعّل تعيين كشركة افتراضية إن أردت أن تكون Yalidine هي الافتراضية للمتجر.

أما الأسعار فمكانها الصفحة المنفصلة /dashboard/shipping. من هناك يمكنك:

  • مزامنة الأسعار — لسحب أسعار البيت ونقاط الاستلام لكل ولاية من Yalidine.

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

⚠️ تنبيه — حدّد ولاية متجرك أولاً

تحتاج مزامنة الأسعار لعائلة Yalidine (Yalidine و Yalitec و Guepex و Easy & Speed) إلى ولاية متجرك أنت. وإن لم تكن محدّدة في إعدادات المتجر تفشل المزامنة بالرسالة «يرجى تحديد ولاية المتجر من إعدادات المتجر قبل مزامنة الأسعار.». ونفس الولاية تُرسَل كـ from_wilaya_name مع كل طرد، وتصبح Alger افتراضياً إن لم تُحدَّد.

Express مقابل Économique (لـ Guepex فقط)

تعرض نافذة البيانات مُحدِّد درجة التوصيل — Express أو Économique — لـ Guepex فقط. أما Yalidine و Yalitec و Easy & Speed فتشحن دائماً Express، لأن API الخاص بها يرفض المعامل economic رفضاً تاماً.

الدرجة التي تختارها تُستعمل في السعر المعروض عند الدفع وفي الطرد المُرسَل معاً، لذا فتغييرها يغيّر ما يدفعه زبونك.

ما الذي يُسحب

  • قائمة كاملة من الولايات والبلديات. تُؤخذ أسماء البلديات أساساً من قائمة البلديات المُزامَنة من المزوّد (بكتابة Yalidine نفسها)، مع قائمة البلديات المدمجة في DZBuild كخيار احتياطي. أما البلدية التي لا تنتمي إلى ولاية الطلب فتجعل الإرسال يفشل («البلدية المحددة لا تنتمي إلى الولاية المختارة») بدل أن تُصحَّح تلقائياً.

  • سعر التوصيل للبيت لكل ولاية.

  • سعر نقطة الاستلام لكل ولاية.

  • قائمة نقاط الاستلام في كل ولاية، تُستعمل في مُختار نقاط الاستلام.

أبعاد المنتج

لا تظهر حقول الطول / العرض / الارتفاع في نموذج المنتج إلا عند ربط شركة من عائلة Yalidine — فلا عائلة أخرى تقبل الأبعاد. وإن تركتها فارغة يخرج الطرد بأبعاد 10 × 10 × 10 سم ووزن 0.5 كغ.

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

عند تأكيد طلب من /dashboard/orders ومزوّد المتجر هو Yalidine، تُنشئ DZBuild الطرد لدى Yalidine بالبيانات التالية:

  • الاسم واللقب ورقم الهاتف (يُهيّأ تلقائياً للصيغة المحلية 0X). يصل إلى Yalidine رقم هاتف واحد فقط — أما الرقم الثاني للزبون فيُحفَظ على الطلب في DZBuild ولا يُمرَّر.

  • العنوان، الولاية الوجهة، البلدية الوجهة (محوّلة للاسم الفرنسي).

  • ولاية الانطلاق (ولاية متجرك — تُستخدم كـ from_wilaya_name).

  • ملخص قائمة المنتجات.

  • مبلغ COD (price = المجموع الفرعي، يدفعه الزبون عند الاستلام).

  • القيمة المعلنة، الطول، العرض، الارتفاع، الوزن.

  • الراية is_stopdesk إضافة إلى stopdesk_id صحيح عند توصيل المكتب.

  • freeshipping و do_insurance ورايات التبديل عند الحاجة.

تُرجع Yalidine:

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

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

📝 ملاحظة — طباعة ملصق Yalidine

لا يوجد في لوحة تحكم DZBuild أي زر يفتح رابط ملصق Yalidine. والضغط على طباعة الملصق في طلب Yalidine يطبع وصل DZBuild الخاص بصيغة HTML — أما ملصق Yalidine الرسمي فاطبعه من بوابة Yalidine.

ينتقل الطلب إلى حالة processing عند الإرسال (وفقط إن كان pending أو confirmed)، ويرى الزبون رقم التتبع على صفحة طلبه. ثم يصبح shipped عندما ترى مزامنة التتبع التلقائية حالة نقل من Yalidine مثل «Ramassé» أو «Expédié» أو «En cours de livraison»، ثم delivered (أو returned / cancelled).

اختصار قائمة المنتجات

الطلبات الطويلة متعددة المنتجات تُختصر قائمة منتجاتها لتتّسع لحد الـ 150 حرفاً عند Yalidine. وتتدرّج DZBuild في الاختصار: القائمة الكاملة a | b | c، ثم نفس القائمة بعد حذف لواحق المتغيّرات بين قوسين، ثم أول بضعة منتجات مع +N، وأخيراً ملخّص من نوع x8 ORD-12345. وتتيح لك إضافة Custom Delivery Label (خطة Pro) التحكّم بما يُكتب هناك.

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

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

  • تعرض إضافة Stop Desk المكاتب في الولاية المحدّدة مع الاسم والعنوان والهاتف.

  • يحفظ الطلب desk_id / desk_name الخاصين بـ DZBuild. أما stopdesk_id الخاص بـ Yalidine فيُحدَّد لحظة الإرسال: المكتب الذي اختاره الزبون، وإلا أي مكتب في بلديته، وإلا أي مكتب في الولاية. ثم تُفرَض على الطرد بلدية المكتب نفسه، فيتطابق المعرّف والبلدية دائماً.

  • يُرفَض الإرسال — ولا يُخفَّض أبداً إلى توصيل بيت — فقط عندما لا تملك الولاية كلها أي مكتب Yalidine. وقد ترفضه DZBuild قبل الاتصال بـ Yalidine أصلاً، اعتماداً على بيانات المكاتب المُزامَنة لديها.

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

الرسالة

السبب

الحل

بيانات API غير صحيحة - تأكد من معرف API والرمز السري / HTTP 400

صيغة API ID أو API Token غير سليمة

أعد نسخ القيمتين من لوحة Yalidine؛ من السهل تبديل الحقلين.

بيانات الاعتماد غير صحيحة / HTTP 401

Yalidine رفضت البيانات

نفس الحل — وتأكّد أن الحساب ما زال يملك وصول API.

غير مصرح - تحقق من صلاحيات حساب Yalidine / HTTP 403

الحساب موجود لكن API غير مفعل

تواصل مع Yalidine لتفعيل API على حسابك.

تم تجاوز حد الطلبات - حاول لاحقاً / HTTP 429

كثرة طلبات في وقت قصير

انتظر دقيقة ثم أعد المحاولة؛ Yalidine تحدّ المعدل بصرامة.

لا يوجد مكتب استلام (Stop Desk) متاح

الولاية كلها بلا أي مكتب Yalidine

حدّث بيانات المزوّد من البطاقة، أو حوّل الطلب إلى توصيل بيت.

البلدية المحددة لا تنتمي إلى الولاية المختارة

عدم تطابق البلدية مع الولاية في الطلب

صحّح البلدية على الطلب ثم أعد الإرسال.

إنشاء الطلب دون رقم تتبع

عنوان أو بلدية غير مفهومين

تحقق من كتابة البلدية على الطلب ثم أعد الإرسال.

نصائح

  • تتوقّع Yalidine البلديات بالفرنسية. تطابق DZBuild أولاً مع قائمة البلديات المُزامَنة من Yalidine نفسها ثم تعود إلى قائمة البلديات المدمجة لديها، لكن الكتابات النادرة قد تفشل — حافظ على نظافة قائمة بلديات متجرك، واضغط تحديث البيانات على بطاقة Yalidine إن بدت القائمة المُزامَنة قديمة.

  • القيمة price التي تُرسَل إلى Yalidine هي المجموع الفرعي (سعر المنتجات) لا الإجمالي مع الشحن. هذا هو ما تجمعه الشركة في COD.

  • إن كان لديك حساب في Yalitec / Guepex / Easy & Speed، اربطه تحت معرّفه؛ بنية API نفسها لكن البيانات غير قابلة للتبديل.

المقالات ذات الصلة
هل أجاب هذا عن سؤالك؟