التوثيق/المخزون/قوائم الالتقاط (Pick Lists) — سحابة صناديق

قوائم الالتقاط (Pick Lists) — سحابة صناديق

إصدار المنتج: 1.0.0+1
آخر تحديث: 2026-10-14
الجمهور: مالكو المستأجر، موظفو المستأجر، المستخدمون العاديون

أ. ما هي قائمة الالتقاط؟

قائمة الالتقاط مستند صرف مخزون. مستخدم مصرح يأخذ صنفا أو أكثر من صندوق المصدر في مخزون المستأجر لغرض داخلي أو تشغيلي — ليست عملية بيع، وليست نقلا بين صناديق.

المستند يجيب: من أخذ ماذا، ومن أين، ومتى، ولماذا؟

لا يوجد صندوق وجهة. الأصناف المصروفة تغادر الكمية المتوفرة؛ قد تستخدم لاحقا في الإنتاج أو الجودة أو الصيانة أو استهلاك المواد أو العينات أو التعامل مع التالف أو أعمال داخلية أخرى. النظام لا يتتبع موقع تعبئة/وجهة.

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

العملية الغرض
البيع المخزون يغادر لأن عميلا اشتراه (مسار المبيعات؛ يتطلب عميلا)
التحويل (Transfer) نقل المخزون بين المخزونات (صندوق مصدر → صندوق وجهة)
نقل الصندوق نقل كمية بين صناديق داخل نفس المخزون (المتوفر لا يتغير)
التسوية (Adjustment) تصحيح الكمية المتوفرة
قائمة الالتقاط صرف المخزون من صندوق مصدر لاستخدام داخلي/تشغيلي (تنخفض الكمية عند الصرف)

الاسم الظاهر للمستخدم يبقى قائمة الالتقاط. داخليا هي صرف مخزون (transaction_type=issue، reference_type=pick_list).

ب. دورة الحالة

المسار الأساسي:

مسودة → مكتمل (مصروف)
      ↘ ملغى

نفس المستخدم الذي أنشأ قائمة الالتقاط يمكنه صرفها. لا يلزم موافقة مستخدم ثان، ولا توجد خطوة التقاط أو تغليف منفصلة.

تحجز الكمية المطلوبة لكل بند عند حفظه (في المسودة)، فلا يستطيع مستند آخر أخذ هذا المخزون. الإكمال يحرر الحجز ويصرف المخزون.

الحالة المعنى
مسودة (draft) قابلة للتعديل. الكميات المطلوبة محجوزة؛ الكمية المتوفرة لا تنقص. الصرف مسموح من هنا.
مكتمل (completed) صرف الكمية المطلوبة لكل بند نشط من صندوق مصدره؛ كتابة دفتر الأستاذ؛ تحرير الحجز
ملغى (cancelled) تحرير الحجز؛ بلا صرف

تنخفض كمية المخزون فقط عند الصرف (الإكمال)، لا عند إنشاء القائمة.

ج. القائمة والإنشاء من الصنف

تصفح: مركز المستودعات → استكشاف → قوائم الالتقاط (/inventory/pick-lists).

من صنف مخزون: تفاصيل الصنف → العمليات → إنشاء قائمة التقاط. يقفل المخزون وبند المخزون مثل التحويل. تختار صندوق المصدر والكمية. لا يوجد صندوق وجهة.

إذا كانت كمية الصنف كلها في صناديق، يجب اختيار صندوق مصدر. السحب بدون صندوق يستخدم الرصيد غير المعين فقط.

د. إنشاء قائمة التقاط

يتطلب inventory:pick_list:create.

  1. المخزون (مجموعة) — يقفل عند الفتح من تفاصيل الصنف.
  2. صادر بواسطة — المستخدم المسجل (للقراءة فقط).
  3. سبب اختياري (غرض تشغيلي)، مرجع، وملاحظات.
  4. كل بند: صنف المخزون، صندوق المصدر، الكمية.
  5. احفظ → الحالة مسودة.

هـ. إجراءات سير العمل

يتطلب inventory:pick_list:update.

الإجراء من الأثر
صرف مسودة إنقاص المتوفر من صندوق المصدر بالكمية المطلوبة لكل بند نشط؛ تحرير الحجز. المنشئ يمكنه الصرف.
إلغاء بند مسودة إلغاء بند واحد مع ذكر السبب؛ يحرر حجزه ولا يصرف منه شيء
إلغاء مسودة تحرير الحجز؛ بلا صرف

رفض الكمية غير الكافية يترك المخزون دون تغيير.

و. الصلاحيات

الصلاحية القدرة
inventory:pick_list:read عرض القائمة والتفاصيل
inventory:pick_list:create إنشاء
inventory:pick_list:update تعديل المسودة والانتقالات والصرف
inventory:pick_list:delete حذف بنود المسودة عند التوفر

ز. الطباعة

من التفاصيل يمكن طباعة PDF لصرف المخزون: المعرف، التاريخ، الصادر بواسطة، السبب، مجموعة المخزون / المستودع المصدر، البنود والكميات وصندوق المصدر. بلا صندوق وجهة.

ح. الواجهة البرمجية (البوابة)

البادئة: /api/inventory/v1/pick-lists

  • POST / — إنشاء (اختياريا مع البنود؛ reason اختياري؛ البنود تأخذ physical_location_id فقط)
  • GET /، GET /statistics، GET /{id}
  • PUT /{id} — تعديل المسودة (بما فيها reason)
  • POST /{id}/complete | cancel
  • مسارات البنود تحت /{id}/items

OpenAPI: ‏/docs في خدمة المخزون.

ط. وثائق ذات صلة