دليل · 8 دقائق قراءة

تكامل Yalidine المباشر مع متجرك — الدليل التقني الكامل

كيف تربط Yalidine بمتجرك الإلكتروني تلقائيّاً: API ID + Token، إنشاء الشحنات، Webhook لتحديث الحالة، طباعة الملصقات. خطوة بخطوة.

M

فريق Mystoq

2026-05-03 · TKAWEN SAS

لماذا Yalidine ضروري لـ80% من تجار الجزائر

Yalidine يخدم 48 ولاية ويصل إلى أكثر من 1,500 بلديّة في الجزائر. شبكته أعمق من Maystro و ZR Express في معظم المناطق الداخليّة. سعره التنافسي + تأمينه الجيّد + نسبة تسليمه العالية يجعله الخيار الافتراضي لـ80% من تجار COD. المشكلة: تكامله مع المنصّات العالميّة (Shopify, WooCommerce) إمّا غير موجود أو يحتاج تطبيقات طرف ثالث مدفوعة.

الخطوة 1: استخراج API ID + Token من حسابك Yalidine

سجّل دخولك إلى لوحة Yalidine المهنيّة. اذهب إلى Settings → API → Generate Credentials. سيظهر لك: API ID (سلسلة من 20 رقماً) و API Token (سلسلة طويلة). احتفظ بهما — لا تشاركهما مع أحد. هذه المفاتيح تعطي صلاحيّة كاملة لإنشاء وشحن طرود من حسابك.

الخطوة 2: إعداد التكامل في Mystoq

في dashboard Mystoq → Settings → Shipping → Yalidine Integration. الصق الـAPI ID + Token. اضغط Save. سيتحقّق Mystoq من المفاتيح بـAPI ping. النتيجة الخضراء = اتّصال جاهز. الآن كلّ طلب جديد يصل إلى dashboardك جاهز ليُنشأ كشحنة.

الخطوة 3: إنشاء الشحنة تلقائيّاً

في كلّ طلب، اضغط زر «شحن». Mystoq يرسل بياناته تلقائيّاً إلى Yalidine API: العنوان، رقم الزّبون، السّعر، نوع التوصيل (منزل/مكتب). يرجع لك: tracking number + رابط ملصق PDF جاهز للطباعة. تطبع، تسلّم لساعي Yalidine، انتهى.

الخطوة 4: Webhook لتحديث الحالة في الوقت الحقيقي

هذا الجزء يفصل بين تكامل سطحي وتكامل احترافي. Mystoq يسجّل webhook URL على Yalidine. كلّ تغيير في حالة الطرد (تمّ الاستلام، في الطريق، تمّ التسليم، رفض، مرتجع) يصلك خلال ثوانٍ → يحدّث حالة الطلب في dashboard تلقائيّاً → يُطلق الـEmail Automation المناسب (post_purchase عند delivered، win-back عند returned). كلّ هذا بدون عمل يدوي.

الخطوة 5: طباعة الملصقات بكميّة

في نهاية اليوم، اضغط «طباعة كلّ ملصقات اليوم» في dashboard. Mystoq يجمع كلّ الـPDFs في ملف واحد، يطبع 10 ملصقات في صفحة A4. توفير وقت ضخم لتجار +20 طلب/يوم.

الأخطاء الشائعة وكيف تتجنّبها

(1) رقم الزّبون خاطئ — Yalidine يرفض الطرد. الحلّ: تحقّق الرقم في Mystoq قبل الإنشاء (نمط 0[567]\d{8}). (2) commune غير موجودة — تستخدم Mystoq autocomplete مباشر من Yalidine. (3) سعر COD خاطئ — تأكّد إنّ سعر الطلب في Mystoq يطابق السّعر المتفّق عليه مع الزّبون قبل الإنشاء.

تكامل Yalidine جاهز في 5 دقائق على Mystoq

لا حاجة لـapps طرف ثالث ولا لمبرمج. الصق المفاتيح، انطلق.

ابدأ مجاناً

دلائل أخرى