حالات الطرد: المرجع الكامل للتاجر

الغرض#

لكل طرد حالة واحدة تدلّ على موضعه في رحلة التوصيل. تعرض هذه الصفحة الحالات التي قد تظهر لك في لوحة التاجر بأسمائها كما تُكتب في اللوحة، ومعنى كل حالة، ومن يغيّرها، والترتيب المعتاد لها. الأسماء العربية هي التي تعرضها اللوحة افتراضياً، أما الأسماء الإنجليزية فتظهر حين تُبدَّل لغة الواجهة إلى الإنجليزية.

من يرى الحالة ومن يغيّرها#

التاجر يرى حالة طرده هو فقط، ولا يستطيع تغييرها من لوحته: أي محاولة لتغيير الحالة من لوحة التاجر تُرفض برمز 403 (ممنوع). تتغيّر الحالة على يد:

• موظفي شركة التوصيل من صفحات الطرود والتوزيع.
• المندوب عبر تطبيق الهاتف، على الطرود المسندة إليه فقط.
• شركة الشحن الخارجية، إذا سُلّم الطرد إليها: تصل حالاتها وتُحوَّل إلى حالات المنصة.
• النظام عند إنشاء الطرد.

والتاجر الذي يدير قسم «شركتي للتوصيل» يسجّل بنفسه نتيجة التوصيل لطروده التي يوصلها مناديبه هو.

أين تظهر الحالة#

• «طرودي»: شارة ملوّنة في عمود «الحالة» لكل صف، وخمسة تبويبات يظهر بجانب كل منها عدد طرودك فيه. الأعداد تشمل كل طرودك ولا تتأثر بالبحث أو بفلتر التاريخ.

• صفحة تفاصيل الطرد: الشارة بجانب رقم التتبع، وبطاقة «سجل الطرد» التي تسرد كل تغيّر بتاريخه ووقته وملاحظته، الأحدث أولاً. ويظهر «محاولات التوصيل» فقط حين يصبح العدد أكبر من صفر، أي بعد إعادة جدولة التوصيل أو بعد محاولة فاشلة أعادت الطرد إلى «بالمستودع — جاهز للتوزيع»؛ ولا يظهر للطرد الذي سُلّم من المحاولة الأولى. وإذا كان الطرد عند شركة شحن خارجية يظهر أيضاً «الحالة عند الشركة» كما تبلّغها الشركة.
• صفحة التتبع العامة: تعرض الحالة على شريط من أربع مراحل مبسّطة، وتحته سجل الحالات (راجع مقال التتبع).
• واجهة الـAPI: يعيد GET /api/v1/parcels/{tracking} الحقول status_code (الرقم في الجداول أدناه) وstatus_label وstage. وتقبل القائمة GET /api/v1/parcels فلتر stage بإحدى القيم: pending، out_for_delivery، delivered، partially_delivered، returning، returned. ويحمل الحقل stage إحدى هذه القيم الست بحسب مجموعة الحالة (فمثلاً «مع مندوب التوصيل» و«إعادة جدولة التوصيل» تحملان out_for_delivery). ويحمل الطرد الذي ينتظر الرصيد القيمة awaiting_funds: القائمة تُخفي مثل هذه الطرود، فتراها في ردّ طلب الإنشاء (المرسل مع wait_for_balance=true) وعند طلب هذا الطرد برقم تتبعه. أما الحالات التي لا تدخل في أي من هذه المجموعات الست، مثل «بالمستودع — جاهز للتوزيع» و«عم ينتقل لفرع تاني» و«وصل الفرع» وحالات الاستلام الثلاث، فتحمل processing. وتتطلب الواجهة مفتاح API، وباقة تتضمن ميزة الـAPI إن كانت المنصة تقدّم باقات تجار، ولا تتاح للتاجر التابع لشركة توصيل.

الحالات بحسب ترتيبها المعتاد#

مرحلة التجهيز والاستلام

مرحلة التوصيل

مرحلة الإرجاع

التفاصيل العملية للإرجاع والرفض في مقال «الإرجاع ورفض المستلم».

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

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

تسميات موجودة لا يضبطها المسار الحالي#

هذه التسميات معرّفة في النظام لكن لا يوجد في المسار الحالي انتقال يوصل إليها، لذلك لا تتوقع رؤيتها على طرود جديدة.

• تسميات قديمة: 10 «توصيل»، 11 «مرتجع بالمستودع»، 12 «تعيين للتاجر»، 13 «رجع للتاجر». يحتسب تبويب «راجع / فشل» الثلاث الأخيرة، أما الأولى فتظهر تحت «الكل» فقط.
• تسميات الإلغاء: 14 «إلغاء تعيين مندوب الاستلام»، 15 «إلغاء استلام مندوب الاستلام»، 16 «إلغاء الاستلام بالمستودع»، 17 «إلغاء تعيين مندوب التوصيل»، 18 «إلغاء إعادة جدولة التوصيل»، 20 «إلغاء النقل للفرع»، 21 «إلغاء الاستلام بالفرع»، 22 «إلغاء التسليم»، 23 «إلغاء إعادة جدولة الاستلام»، 25 «إلغاء الإرجاع للشركة»، 28 «إلغاء إعادة جدولة الإرجاع»، 29 «إلغاء الإرجاع للتاجر»، 31 «إلغاء استلام المرتجع»، 33 «إلغاء التسليم الجزئي».

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

ماذا تستطيع أن تفعل بحسب الحالة#

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

أخطاء شائعة#

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

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

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