ربط متجر سلة بالمنصة بكود الربط

الغرض#

يُربط متجر سلة عبر تطبيق Delivery Syria في «متجر التطبيقات» في سلة، بكود ربط يُستعمل مرة واحدة من حسابك. بعد ذلك يتحوّل إلى طرد كل طلب في سلة اختار فيه الزبون شحن Delivery Syria وكان مؤهلاً (انظر الجدول أدناه). وما دام خيار «إرجاع حالة الشحنة للمتجر» مفعّلاً (وهو الافتراضي) تُنشأ شحنة في سلة تتبع حالتها حالة الطرد، ويُرسل إليها رابط التتبع.

من يستطيع استخدامها وما الذي تحتاجه#

• حساب تاجر منصة فعّال وموثّق وله ملف تاجر فعّال. وصفحة «ربط المتاجر» التي تُكمل منها الإعداد مغلقة أمام التاجر الذي أنشأته شركة توصيل.
• مكان استلام فعّال واحد على الأقل (تسميه رسالة النظام «فرعاً»).
• باقة تتضمن «ربط المتاجر» وفيها متسع ضمن «عدد المتاجر المربوطة». وإعادة ربط المتجر نفسه لا تُحتسب.
• تثبيت التطبيق في متجر سلة. وإعداد بيانات التطبيق على المنصة مسؤولية مدير المنصة.

خطوات الربط#

1. ثبّت التطبيق في سلة

   من لوحة متجرك في سلة افتح «متجر التطبيقات» وابحث عن Delivery Syria واضغط «تثبيت» ووافق على الصلاحيات.

2. خذ كود الربط

   تطلب سلة «كود الربط». في «ربط المتاجر» وعلى بطاقة سلة اضغط «خذ كود ربط سلة» فتُفتح صفحة في تبويب جديد. الكود بصيغة XXXX-XXXX، صالح 10 دقائق ويُستعمل مرة واحدة. وكل فتح جديد للصفحة يُصدر كوداً جديداً ويلغي السابق.

3. الصق الكود في سلة

   الصق الكود في حقل «كود الربط» في سلة ثم اضغط Activate the App.

4. حدّد شركة التوصيل ومكان الاستلام

   يظهر متجرك تحت «متاجرك المربوطة». اختر «شركة التوصيل لطلبات هذا المتجر» و«مكان الاستلام» ثم «حفظ». وإلى أن تفعل تظهر الصفحة تنبيهاً وتفشل الطلبات برسالة تبدأ بـ «إعداد المتجر ناقص:».

5. فعّل Delivery Syria كشركة شحن في سلة

   من إعدادات الشحن في سلة فعّل Delivery Syria ليختارها الزبون عند الدفع.

6. جرّب طلباً

   أنشئ طلباً تجريبياً في متجرك مع اختيار شحن Delivery Syria. تعرض بطاقة سلة «آخر طلبات سلة الواصلة» بنتيجة كل حدث.

123

1. شاهد طلبات هذا المتجر
2. شركة التوصيل لطلبات المتجر
3. مكان الاستلام الافتراضي

النتيجة المتوقعة#

تظهر على بطاقة سلة شارة «مربوط» وشريط «صلاحية الربط». وتعالج المنصة الطلبات هكذا:

عند إنشاء الطرد، وما دام خيار «إرجاع حالة الشحنة للمتجر» مفعّلاً، تُنشأ شحنة في سلة وتتبع حالتها حالة الطرد: الاستلام والمستودع in_progress، والنقل بين الفروع in_transit، والوصول إلى الفرع received_at_final_hub، وتعيين مندوب التوصيل delivering، وإعادة الجدولة to_be_reattempted، والتسليم delivered، والتسليم الجزئي partially_delivered، والإرجاع return_in_progress، والرجوع إلى التاجر return_to_origin. وغير ذلك، كحالة «بانتظار الاستلام» وحالات الإلغاء، لا يُرسل. وإن كان الخيار معطّلاً لم تُنشأ شحنة في سلة ولم تُرسل حالات، وللطرد الذي ينتظر رصيد المحفظة لا تُنشأ الشحنة إلا بعد اكتماله. وبعد بلوغ حالة نهائية لا تقبل سلة الرجوع عنها، فتظهر رسالة تطلب مراجعة يدوية. رابط التتبع المرسل هو صفحة التتبع العامة للطرد، وتعيد مهمة كل 15 دقيقة إرسال الحالات التي لم تصل لطلبات تحدّثت خلال آخر 30 يوماً. ويفتح التطبيق داخل سلة أيضاً صفحتي «المحافظ» (Wallets) و«الطرود المعلّقة» (Pending parcels).

الفصل وإعادة الربط وتغيير الحساب#

• حذف التطبيق من سلة يعلّم المتجر على أنه ملغى التثبيت ويمسح التوكنات ويوقف الربط برسالة «تم حذف تطبيق Delivery Syria من متجر سلة.». وعند إعادة التثبيت تُفعّل المنصة الربط حين ترسل سلة التفويض، وإن لم يظهر فخذ كوداً جديداً.
• زر «حذف» في الصفحة يزيل الربط وطلباته التي لا طرد لها، ولا يحذف التطبيق من سلة. وتتوقف المنصة عن تحويل طلبات سلة إلى طرود إلى أن يُنشأ الربط من جديد، بكود ربط جديد أو بإعادة تفويض التطبيق من سلة.
• تغيير الحساب: إن ربطت المتجر نفسه بكود من حساب آخر انتقل إلى ذلك الحساب وتُمسح شركة التوصيل ومكان الاستلام.
• توكن الربط يتجدد تلقائياً. فإن رفضت سلة التجديد افتح التطبيق من «التطبيقات المثبتة» في سلة ووافق على الأذونات من جديد، أو اضغط «جدّد الآن» إن انتهت صلاحية التوكن.

أخطاء شائعة#

الأمان والحدود#

• يجب أن يحمل كل حدث من سلة إما X-Salla-Signature صحيحاً (HMAC-SHA256 لجسم الطلب) وإما السر المشترك في ترويسة Authorization، وإلا رُفض بـ HTTP 401. والتوكنات مخزّنة مشفّرة وتُحذف من سجل الأحداث، ولا يُخزَّن الكود ذاته، بل تُخزَّن بصمته فقط، فلا تشاركه مع أحد.
• صفحة الكود لا تُخزَّن مؤقتاً ولا تُعرض داخل إطار، ويتحقق التطبيق المضمّن من سلة قبل فتح جلسة مدتها 120 دقيقة.
• صفحة الكود: 30 طلباً في الدقيقة. استقبال الأحداث: 600. واجهة الربط: 60.
• بعض رسائل الأخطاء أعلاه (كود الربط، وربط المتجر بحساب تاجر، واختيار شركة شحن أخرى، وحالة الطلب، وإيقاف الربط) تظهر بالعربية فقط حتى في الواجهة الإنجليزية، وكذلك زر «جدّد الآن» وعنوانا صفحتي «المحافظ» و«الطرود المعلّقة».