دورة حياة الطرد في لوحة الشركة

الغرض#

تشرح هذه الصفحة كيف يتنقل الطرد في لوحة الشركة: الحالات التي قد يكون عليها، ومن يحق له نقله، وما الذي يترتب على كل انتقال. تُفحص كل انتقالات التوصيل والإرجاع مقابل خريطة انتقالات واحدة، ويُرفض أي انتقال غير موجود فيها.

من يغيّر ماذا#

خطوات التراجع (تسمى «إلغاء» في القوائم) مقصورة على إدارة الشركة: الأدمن والمسؤول والفرع والسوبر أدمن.

المسار المعتاد#

نتائج التوصيل#

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

مسار الإرجاع#

«فشل التوصيل — راجع للشركة»، ثم راجع للتاجر (ويمكن تعيين مندوب)، ثم عند الحاجة إعادة جدولة الإرجاع للتاجر، ثم استلمه التاجر (مرتجع) وهي نهائية. وإذا سُجّل الطرد «استلمه التاجر» دون المرور بـ«راجع للشركة» يُسجَّل الفشل المالي مرة واحدة أيضاً.

سجل الحالات#

يعرض سجلات الطرود لكل طرد شريط تقدم من خمس خطوات (Pending، In Progress، Warehouse، Deliveryman Assigned، ثم Delivered؛ ويظهر في الخطوة الأخيرة، لحالات الإرجاع وللتسليم الجزئي، العنوان Return Courierr بحرف r زائد في آخره، وهو خطأ في الصفحة) وخطاً زمنياً لكل إدخال بتاريخه ووقته والفرع أو المندوب والملاحظة. وتبقى الخطوات الملغاة في الخط الزمني ويحمل معظمها شارة «Canceled». وفي قائمة الطرود عمود View Proof of Delivery فيه زر View للطرود «تم التسليم» (وليس «تسليم جزئي»). وهذه العناوين تظهر بالإنجليزية حتى في الواجهة العربية.

التراجع عن خطوة#

تنقل خيارات التراجع في قائمة الحالة الطرد خطوة إلى الخلف، وتضع علامة الإلغاء على الإدخال الملغى، وتعكس أثره المالي: التراجع عن «فشل التوصيل — راجع للشركة» يعكس قيد الفشل. وتتوفر خيارات التراجع لخطوات الاستلام والمستودع والفرع وتعيين المندوب و«فشل التوصيل — راجع للشركة» والإرجاع للتاجر. غير أن «إلغاء الاستلام بالمستودع» لا ينجح إلا للطرد الذي مرّ بإحدى خطوات الاستلام ويعيده إلى حالة تلك الخطوة؛ أما الطرد المنشأ بالطريقة المعتادة فينتقل مباشرة من «بانتظار الاستلام» إلى «بالمستودع — جاهز للتوزيع»، ولذلك يفشل التراجع برسالة الانتقال غير المسموح (انظر الحدود). أما الطرود «تم التسليم» و«تسليم جزئي» و«استلمه التاجر (مرتجع)» فلا تظهر لها قائمة تحديث الحالة في قائمة الطرود.

ما الذي يترتب على كل تغيير#

بعد اعتماد أي تغيير في المسار الذي تُفحص فيه الانتقالات (تعيين المندوب وإعادة جدولة التوصيل، والتسليم، والإرجاع، والاستلام بالمستودع، وخطوات التراجع عن «فشل التوصيل — راجع للشركة» وعن الإرجاع للتاجر) يرسل النظام حالة الطرد إلى طلبات المتاجر المربوطة (WooCommerce وشوبيفاي وسلة) وإلى طلبات زد وإلى مزامنة Store Syria الأقدم (للطرود المنشأة عبر ذلك الربط)، ويُرسَل ويب هوك التاجر الصادر إن كان مفعّلاً، وتُرسَل الإشعارات حسب قواعد مركز الإشعارات. ولا تُحدَّث طلبات WooCommerce وشوبيفاي وسلة إلا إذا فُعّل في ربط المتجر خيار إرجاع حالة الشحنة للمتجر، ولا يصل إلى المتجر كل تغيير: يتلقى شوبيفاي أحداث الخروج للتوصيل والتسليم والفشل (الإرجاع للشركة) والتأكيد (الاستلام بالمستودع)، ويضيف WooCommerce ملاحظة إلى الطلب عند كل تغيير ويضبطه «مكتملاً» عند التسليم، ويتلقى سلة الحالات التي لها مقابل عنده فقط، ويتلقى زد ثلاث حالات فقط: جاهز (الاستلام بالمستودع أو النقل إلى فرع آخر أو الاستلام بالفرع) ومع المندوب ومُسلَّم. أما خطوات الاستلام والنقل بين الفروع واستلام الفرع، وهي المسار الأقدم (انظر الحدود)، وكذلك خطوات التراجع المذكورة في الحدود، فلا تُشغّل خطوة المزامنة والإشعارات التي تلي كل تغيير: لا إرسال للحالة إلى طلبات المتاجر ولا إلى زد من التطبيق، ولا ويب هوك التاجر، ولا إشعارات تغيير الحالة المعتادة. وتكتفي خطوات تعيين مندوب الاستلام وإعادة جدولة الاستلام واستلام مندوب الاستلام والنقل بين الفروع واستلام الفرع، والتراجع عن تعيين مندوب الاستلام وعن إعادة جدولة الاستلام، بتشغيل مزامنة Store Syria الأقدم. أما وصول هذه الحالات إلى زد فيعتمد على trigger في قاعدة البيانات ليس جزءاً من شيفرة التطبيق. وتعيين مندوب الاستلام يرسل إشعار الاستلام الخاص به إلى المندوب والتاجر (مع رسالة SMS لهما عند اختيارها)، وإعادة جدولة الاستلام ترسل إشعارات مباشرة إلى المندوب والتاجر (مع SMS اختيارية). وتجمع صفحة التتبع العامة الحالات في أربع خطوات (انظر مقال التتبع).

طرود شركات الشحن#

الطرود المرسلة إلى شركة شحن خارجية تأخذ حالاتها من تلك الشركة، ويجوز أن تتخطى الحالة بعض المراحل، لكن لا يمكن الخروج من حالة نهائية، ولا يُقبل من «فشل التوصيل — راجع للشركة» إلا «راجع للتاجر» أو «استلمه التاجر (مرتجع)».

الحدود والصلاحيات#

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