حالات الطرد المرتبطة بالمستودع

الغرض#

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

من يحتاجها#

• موظفو الشركة والمنسّقون الذين ينقلون الطرود من صفحات الطرود ولوحة توزيع الطرود.
• مشرفو المستودعات الذين تُبنى قائمة الطرود الطالعة لديهم من هذه الحالات.
• المطوّرون الذين يقرؤون status_code بقيمة 5 والمرحلة processing في ردود الـ API والويب هوك.
• التجار الذين يرون الحالة ويستطيعون حذف الشحنة وهي في هذه الحالة.

الحالات#

مسار الإرجاع الحالي لا يمرّ بالمستودع: بعد فشل التوصيل تنتقل الشحنة إلى «فشل التوصيل — راجع للشركة» ثم «راجع للتاجر» ثم «استلمه التاجر (مرتجع)». وتبقى الحالات القديمة الثلاث في الشيفرة من أجل السجلات القديمة والأسماء والفلاتر والتقارير (تبويب «راجع / فشل» عند التاجر ومجموعة المرتجع في التقارير يتضمنانها).

كيف تصل الشحنة إلى «بالمستودع — جاهز للتوزيع»#

• عند الإنشاء (النظام). بعد خصم الأجرة، تنتقل الشحنة التي أُنشئت عبر منشئ الطرود في المنصة (لوحة التاجر، الـ API، المتاجر المربوطة، الاستيراد من Excel عند التاجر، موظفو الشركة) من «بانتظار الاستلام» إلى «بالمستودع — جاهز للتوزيع» فوراً. والشحنة المرسلة إلى شركة شحن خارجية تنتقل إليه عندما تقبلها الشركة. والشحنة التي تنتظر رصيد التاجر تبقى «بانتظار الاستلام» ومخفية إلى أن يُشحن الرصيد.
• موظفو الشركة. على دومين الشركة، تعرض قائمة الحالة في صف الطرد خيار بالمستودع — جاهز للتوزيع للطرود التي في حالة «تم تعيين مندوب الاستلام» أو «إعادة جدولة الاستلام». ويحتاج إلى الصلاحية parcel_status_update.
• المندوب. في تطبيق الجوال، عندما يتعذّر إتمام التسليم (مثلاً رفض المستلم الاستلام أو تعذّر الوصول إليه)، يرسل المندوب الحالة «بالمستودع» للطرد المسند إليه أو المعاد جدولته (عبر إجراء تحديث الحالة في تطبيق المندوب مع status_action بقيمة 5). وهذه «عودة للمستودع» وليست فشلاً نهائياً.
• لوحة توزيع الطرود. الزر تأجيل في لوحة التوزيع يعيد الطرد الذي مع مندوب إلى المستودع؛ وفي قائمة طرود التاجر صاحب شركة التوصيل الخاصة يسمّى الإجراء نفسه رجوع للمستودع.
• واجهة الشركة (API). تتيح واجهة الشركة (انظر مقال مرجعها) الإجراءين received (إلى المستودع) وreschedule (عودة إلى المستودع). وتُرفض طرود شركات الشحن الخارجية بالرمز 409 مع not_allowed.

استلام شحنة في المستودع (موظفو الشركة)#

1. افتح قائمة الطرود

   على دومين الشركة افتح الطرود ثم كل الطرود (وهذا يحتاج الصلاحية parcel_read). يظهر عمود الحالة وزر السهم فيه فقط للحسابات التي تملك الصلاحية parcel_status_update، ولا يظهر للطرود «تم التسليم» أو «تسليم جزئي» أو «استلمه التاجر (مرتجع)».

2. افتح قائمة الحالة في الصف

   تعرض القائمة فقط الإجراءات المسموحة للحالة الحالية. وللطرد في حالة «تم تعيين مندوب الاستلام» أو «إعادة جدولة الاستلام» تتضمن «بالمستودع — جاهز للتوزيع».

3. اختر الفرع وأضف ملحوظة

   تحمل النافذة اسم الحالة عنواناً، وفيها حقل فرع إلزامي (يكون فرع الطرد محدداً مسبقاً إن وُجد) وحقل ملحوظة.

4. احفظ

   اضغط حفظ. عند النجاح تظهر رسالة تأكيد. وبدون فرع تظهر رسالة تنبّه إلى أن الحقول المطلوبة ناقصة. تصبح الشحنة جاهزة للإسناد.

الانتقالات المسموحة#

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

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

التراجع عن الاستلام بالمستودع#

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

ماذا تفعل الحالة#

• على الشحنة. الاستلام أو الإرجاع إلى المستودع يزيل المندوب المسند عن الشحنة؛ ويُضبط الفرع إذا اختير فرع. والعودة إلى المستودع تزيد محاولات التوصيل واحداً وتسجّل قيداً (الشحنة والمندوب واسم من نفّذ الإجراء وسبباً، مع نص افتراضي إن لم يُذكر سبب) في قائمة الطرود المرفوضة الطلبات المرفوضة (وتظهر في القائمة الإنجليزية باسم "Rejected requests"). ولا تحرّك هذه الخطوات أي مبلغ: فالأجرة تُخصم عند إنشاء الشحنة.
• للتاجر. تظهر الشحنة «بالمستودع — جاهز للتوزيع» تحت تبويب قيد التجهيز وعند خطوة «بالمستودع» في شريط متابعتها. وما دامت الشحنة «بانتظار الاستلام» أو «بالمستودع — جاهز للتوزيع» ولم تُرسل إلى شركة شحن خارجية، يستطيع التاجر حذفها (ويفعل إلغاء الشحنة عبر واجهة التاجر الشيء نفسه) ويُرد له كل ما خُصم؛ وبعد أن تصير مع مندوب يُرفض ذلك (ويردّ الـ API بـ 409 مع not_cancellable). وعند الإنشاء يصل إشعار «طرد جديد» من مركز الإشعارات إلى موظفي الشركة افتراضياً؛ أما نسخة التاجر فمعطّلة افتراضياً ولا تُرسل إلا إذا فعّلها مشغّل المنصة. والدخول اللاحق إلى الحالة لا يرسل إشعاراً خاصاً من مركز الإشعارات.
• للموظفين. تأكيد الوزن الفعلي في تطبيق الموظفين مسموح فقط عندما تكون الشحنة في هذه الحالة وتتولى شركة التوصيل نفسها معالجتها (لا شركة شحن خارجية)؛ ويُرحَّل فرق الرسوم إلى رصيد الشحن عند التاجر.
• للمطوّرين. يعرض الـ API الحقل status_code بقيمة 5 والاسم والمرحلة processing؛ ويستقبل الويب هوك الصادر للتاجر parcel.status_changed (وparcel.created عند الإنشاء) دون حدث مرحلة. ويمكن تصفية قائمة واجهة الشركة بـ stage=processing لعرضها.
• للمتاجر المربوطة. تصبح الحالة in_progress في سلة، وready في زد، وحدث تنفيذ confirmed في شوبيفاي (عند وجود تنفيذ للطلب)، وملاحظة على الطلب في ووكومرس.

خدمة المستودعات وحالات الطرد#

ليس لخدمة المستودعات (الطبليات والمخزون ولوحة المشرف) حالة طرد خاصة بها؛ فهي تقرأ الحالات العادية.

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

أخطاء شائعة#

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

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

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