قوائم الالتقاط (Pick Lists) — سحابة صناديق
إصدار المنتج: 1.0.0+1
آخر تحديث: 2026-08-13
الجمهور: مالكو المستأجر، موظفو المستأجر، المستخدمون العاديون
أ. ما هي قائمة الالتقاط؟
قائمة الالتقاط مستند صرف مخزون. مستخدم مصرّح يأخذ صنفاً أو أكثر من صندوق المصدر في تجمع مخزون المستأجر لغرض داخلي أو تشغيلي — ليست عملية بيع، وليست نقلاً بين صناديق.
المستند يجيب: من أخذ ماذا، ومن أين، ومتى، ولماذا؟
لا يوجد صندوق وجهة. الأصناف المصروفة تغادر الكمية المتوفّرة؛ قد تُستخدم لاحقاً في الإنتاج أو الجودة أو الصيانة أو استهلاك المواد أو العيّنات أو التعامل مع التالف أو أعمال داخلية أخرى. النظام لا يتتبع موقع تعبئة/وجهة.
| العملية | الغرض |
|---|---|
| البيع | المخزون يغادر لأن عميلاً اشتراه (مسار المبيعات؛ يتطلّب عميلاً) |
| التحويل (Transfer) | نقل المخزون بين تجمعات المخزون (صندوق مصدر → صندوق وجهة) |
| نقل الصندوق | نقل كمية بين صناديق داخل نفس التجمع (المتوفّر لا يتغير) |
| التسوية (Adjustment) | تصحيح الكمية المتوفّرة |
| قائمة الالتقاط | صرف المخزون من صندوق مصدر لاستخدام داخلي/تشغيلي (تنخفض الكمية عند الصرف) |
الاسم الظاهر للمستخدم يبقى قائمة الالتقاط. داخلياً هي صرف مخزون (transaction_type=issue، reference_type=pick_list).
ب. دورة الحالة
المسار الأساسي:
مسودة → مكتمل (مصروف)
↘ قيد المعالجة → مكتمل (حجز اختياري ثم صرف)
↘ ملغى (قبل الاكتمال)
نفس المستخدم الذي أنشأ قائمة الالتقاط يمكنه صرفها. لا يلزم موافقة مستخدم ثانٍ. قيد المعالجة اختياري عند الحاجة لحجز الكمية قبل الصرف.
حالات التسليم القديمة (collected، ready، received) ما زالت قابلة للإكمال عبر واجهة البرمجة. التطبيق لا يعرض أزرار الجمع/الجاهز/الاستلام.
| الحالة | المعنى |
|---|---|
| مسودة (draft) | قابلة للتعديل. الكمية المتوفّرة لا تُنقص. الصرف مسموح من هنا. |
| قيد المعالجة (processing) | اختياري: بدأ الصرف؛ الكمية المطلوبة محجوزة |
| مكتمل (completed) | صرف الكمية من صندوق المصدر؛ كتابة دفتر الأستاذ (وتحرير الحجز إن وُجد) |
| ملغى (cancelled) | تحرير الحجز إن وُجد؛ بلا صرف |
تنخفض كمية المخزون فقط عند الصرف (الإكمال)، لا عند فتح القائمة أو بدء المعالجة.
ج. القائمة والإنشاء من الصنف
تصفح: مركز المستودعات → استكشاف → قوائم الالتقاط (/inventory/pick-lists).
من صنف مخزون: تفاصيل الصنف → العمليات → إنشاء قائمة التقاط. يُقفل المخزون وبند المخزون مثل التحويل. تختار صندوق المصدر والكمية. لا يوجد صندوق وجهة.
إذا كانت كمية الصنف كلها في صناديق، يجب اختيار صندوق مصدر. السحب بدون صندوق يستخدم مجمع غير المعيّن فقط.
د. إنشاء قائمة التقاط
يتطلب inventory:pick_list:create.
- المخزون (مجموعة) — يُقفل عند الفتح من تفاصيل الصنف.
- صادر بواسطة — المستخدم المسجّل (للقراءة فقط).
- سبب اختياري (غرض تشغيلي)، مرجع، وملاحظات.
- كل بند: صنف المخزون، صندوق المصدر، الكمية.
- احفظ → الحالة مسودة.
هـ. إجراءات سير العمل
يتطلب inventory:pick_list:update.
| الإجراء | من | الأثر |
|---|---|---|
| صرف | مسودة أو قيد المعالجة أو الحالات القديمة | إنقاص المتوفّر من صندوق المصدر. المنشئ يمكنه الصرف. |
| بدء المعالجة | مسودة (اختياري) | حجز الكمية على البنود النشطة |
| تحديث كمية الالتقاط | قيد المعالجة | تعيين quantity_picked لكل بند (اختياري) |
| إلغاء | أي حالة عدا مكتمل/ملغى | تحرير الحجز إن لزم |
رفض الكمية غير الكافية يترك المخزون دون تغيير.
و. الصلاحيات
| الصلاحية | القدرة |
|---|---|
inventory:pick_list:read |
عرض القائمة والتفاصيل |
inventory:pick_list:create |
إنشاء |
inventory:pick_list:update |
تعديل المسودة والانتقالات والصرف |
inventory:pick_list:delete |
حذف بنود المسودة عند التوفر |
البادئة: /api/inventory/v1/pick-lists.
ز. الطباعة
من التفاصيل يمكن طباعة PDF لصرف المخزون: المعرّف، التاريخ، الصادر بواسطة، السبب، المصدر، البنود والكميات وصندوق المصدر. بلا صندوق وجهة.