دليل نظام الحجوزات الشامل (Comprehensive Reservation System Guide)

يوفر هذا الدليل توثيقاً شاملاً لنظام الحجوزات في Nama ERP، وهو موجّه لفريق الدعم الفني ومسؤولي النظام.

نظرة عامة (Overview)

نظام الحجوزات في Nama ERP هو ميزة متقدمة لإدارة المخزون تتيح للمؤسسات حجز أصناف المخزون عبر أنواع مختلفة من مستندات سلسلة التوريد. يدير النظام تأثيرات الحجز بشكل مختلف بناءً على نوع المستند، ويتكامل مع آليات تتبع الكميات لتوفير تحكم فوري في تخصيص المخزون.

مسار القائمة: المخازن > سندات الحجوزات > سند حجز

أين يظهر الحجز في رحلتك

الحجز جزء من رحلة المبيعات (حجز المخزون لأمر العميل) ويمهّد لـالتسليم والتحميل. ولتجاهل مخازن/مواقع معينة في التحقق من كمية الحجز بالتاريخ، راجع الدليل المخصص لذلك.

المفاهيم الأساسية (Fundamental Concepts)

اتجاه الحجز حسب نوع المستند (Reservation Direction by Document Type)

يؤثر نظام الحجوزات على كميات المخزون بشكل مختلف بحسب نوع المستند:

مستندات المبيعات والصرف (Pre-Out Reservations)

• مستندات المبيعات: عروض الأسعار، أوامر البيع، فواتير المبيعات
• مستندات الصرف: طلبات الصرف المخزني، طلبات التحويل، سحوبات الإنتاج
• التأثير: ينشئ كميات Pre-Out (محجوز للصرف)
• الغرض: ضمان تخصيص الأصناف لطلبات العملاء أو الاستهلاك الداخلي

مستندات المشتريات والاستلام (Pre-In Reservations)

• مستندات المشتريات: طلبات الشراء، أوامر الشراء، فواتير المشتريات
• مستندات الاستلام: طلبات استلام المخزون
• التأثير: ينشئ كميات Pre-In (محجوز للاستلام)
• الغرض: تتبع الوارد المتوقع من المخزون والتخصيصات

مستندات المخزون (بدون حجز مباشر)

مستندات الصرف المخزني، الاستلام المخزني، والتحويل المخزني لا تنشئ حجوزات لأنها تؤثر على الكميات الفعلية (الداخل والخارج) وليس الكميات المحجوزة.

غير أن هذه المستندات تدعم:

• إلغاء حجز المستندات الأعلى: عند إنشاء صرف مخزني من أمر بيع، يجب إلغاء حجز أمر البيع
• تحديث حجز المستندات المرتبطة: من خلال إعداد updateReservationOfRelatedDocs

مثال: إنشاء صرف مخزني من أمر بيع يجب أن يلغي حجز Pre-Out الخاص بأمر البيع، لأن الأصناف قد صُرفت فعلياً (تحوّلت من الكميات المحجوزة إلى الكميات الفعلية الخارجة).

أنواع الكميات في نظام الحجوزات (Quantity Types in Reservation System)

يدير النظام أربعة أنواع من الكميات لكل بُعد من أبعاد الصنف:

نوع الكمية	العربي	الوصف
In	داخل	الكميات المستلمة فعلياً
Out	خارج	الكميات المصروفة فعلياً
Pre-In	محجوز داخل	الكميات المحجوزة المتوقع استلامها
Pre-Out	محجوز خارج	الكميات المحجوزة المخصصة للصرف

حساب الرصيد المتاح:

Available = (In + Pre-In) - (Out + Pre-Out)

ملاحظة: إدراج Pre-In وPre-Out في الرصيد يعتمد على إعداد الصنف.

هيكل سند الحجز (Reservation Document Structure)

الكيان الرئيسي: ReservationDocument (سند حجز)

نوع الكيان: ReservationDocument
جدول قاعدة البيانات: ReservationDocument
التصنيف: ملف مستند (وليس ملف رئيسي)

الحقول الرئيسية في الرأسية (Key Header Fields)

• حالة الحجز (Reservation Status): يتحكم في الحالة الراهنة للمستند بأكمله
• تاريخ الاستحقاق (Due Date): موعد انتهاء الحجز أو الوفاء به
• إلى موظف (To Employee): الموظف المعين للتعامل مع الحجز
• نسخة إلى موظف (Copy To Employee): موظف إضافي لإشعاره
• المخزن (Warehouse): المخزن الرئيسي للحجز
• الموقع (Locator): الموقع المحدد داخل المخزن
• العميل (Customer): العميل المرتبط بالحجز
• بناءاً على (From Document): المستند المصدر الذي أنشأ هذا الحجز

سطور التفاصيل (Detail Lines)

يحتوي كل سند حجز على سطور تفاصيل تحدد:

• معلومات الصنف: رمز الصنف، الاسم، والمواصفات
• الكميات: الكمية المحجوزة بالوحدات الأولية والثانوية
• المحددات: المخزن، الموقع، الشحنة، الأرقام التسلسلية، الألوان، المقاسات
• تفاصيل الحجز: حالة الحجز على مستوى السطر، التاريخ، والمخزن/الموقع المحدد
• معلومات التتبع: الكميات المنفذة وغير المنفذة للمستندات المرتبطة

قيم حالة الحجز (Reservation Status Values)

الإنجليزي	العربي	الوصف
Reserved	محجوز	الأصناف محجوزة بالكامل ومخصصة
PostReserved	حجز مؤجل	الحجز معلق أو مؤجل
None	بدون	لا توجد حالة حجز
Confirmed	مؤكد	الحجز مؤكد ومقفل
PartialyReserved	PartialyReserved	جزء فقط من الكميات محجوز

الحجز الانتقائي للسطور (Selective Line Reservation)

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

نمط الاستخدام:

1. تهيئة reservationCriteria في توجيه المستند لتصفية السطور بناءً على الحالة
2. تعيين حالة الحجز على مستوى السطر للتحكم في السطور التي تُحجز
3. يُطبَّق تأثير الحجز فقط على السطور المطابقة للمعايير

يتيح ذلك تحكماً دقيقاً في السطور المشاركة في نظام الحجوزات.

تتبع كميات المستند والكميات المنفذة (Document Quantity Tracking and Satisfied Quantities)

آلية الكمية المنفذة (The Satisfied Quantity Mechanism)

يتضمن نظام الحجوزات آلية متقدمة لتتبع الكميات ترصد مقدار الكميات التي تم الوفاء بها عبر المستندات اللاحقة.

المفاهيم الأساسية (Key Concepts)

الكمية المنفذة (Satisfied Quantity): مقدار سطر المستند الذي وفّت به مستندات أخرى
الكمية غير المنفذة (Unsatisfied Quantity): المقدار المتبقي الذي لا يزال يحتاج إلى وفاء
الكمية المنفذة يدوياً (User Satisfied Quantity): الكميات المنفذة المعدَّلة يدوياً

مثال عملي: من عرض السعر إلى أوامر البيع (Practical Example: Sales Quotation to Orders)

1. إنشاء عرض السعر: 100 قطعة من الصنف A مع تفعيل الحجز

   • التأثير: ينشئ حجز Pre-Out لـ 100 قطعة
   • الكمية المنفذة: 0، الكمية غير المنفذة: 100

2. إنشاء أمر البيع #1: 50 قطعة من عرض السعر

   • يحدّث النظام عرض السعر:
     • الكمية المنفذة: 50، الكمية غير المنفذة: 50
   • يحدّث النظام الحجز: يقلل حجز عرض السعر إلى 50 قطعة
   • ينشئ الأمر: حجز Pre-Out جديد لـ 50 قطعة

3. إنشاء أمر البيع #2: 20 قطعة من نفس عرض السعر

   • يحدّث النظام عرض السعر:
     • الكمية المنفذة: 70، الكمية غير المنفذة: 30
   • يحدّث النظام الحجز: يقلل حجز عرض السعر إلى 30 قطعة
   • ينشئ الأمر: حجز Pre-Out جديد لـ 20 قطعة

إعداد تتبع الكميات (Configuration for Quantity Tracking)

إعداد توجيه المستند:

• forceTrackQtyOfRelatedDocs: تفعيل تتبع الكميات الإجباري
• updateTrackQtyInRelatedDoc: تحديث كميات التتبع في المستندات المصدر
• relatedDocQtyPolicy: سياسة التعامل مع فوارق الكميات
• relatedDocQtyFields: الحقول المستخدمة للتتبع (الكمية الأولى أو الثانية)

الإعداد الخاص بالحجوزات:

• reservationSatisfiedFields: حقول الكمية التي تتبع الوفاء بالحجوزات
• updateReservationOfRelatedDocs: تفعيل تحديثات الحجز عند تتبع الكميات

إعداد الحجز على مستوى الصنف (Item-Level Reservation Configuration)

يمكن تهيئة الأصناف بسلوكيات حجز محددة عبر ItemConfigurations:

إعدادات الحجز الأساسية (Core Reservation Settings)

• includeReservedInBalance: هل تؤثر الكميات المحجوزة على حسابات الرصيد المتاح
• allowOverdraftInReservation: السماح بالحجوزات حتى عند نقص الكميات

تسلسل سياسة السحب على المكشوف (Overdraft Policy Hierarchy)

يستخدم النظام نهجاً هرمياً لتحديد صلاحيات السحب على المكشوف:

1. مستوى الصنف: سياسة السحب على المكشوف للصنف المنفرد
2. مستوى مجموعة الصنف: سياسة السحب على المكشوف لفئة الصنف
3. مستوى النظام: سياسة السحب على المكشوف الخاصة بإعداد سلسلة التوريد العام

قيم السياسة:

• Yes: السماح بالسحب على المكشوف
• No: منع السحب على المكشوف
• Inherited: استخدام سياسة المستوى الأعلى

خيارات الإعداد الشاملة (Comprehensive Configuration Options)

إعداد توجيه المستند (InvDocTermConfig)

التحكم الأساسي في الحجز (Basic Reservation Control)

• reserve: تفعيل/تعطيل وظيفة الحجز
• reserveFromReservationQty: الحجز من كميات الحجز الموجودة بدلاً من كميات المستند
• preventCancelReservation: تعطيل إلغاء الحجز

تسلسل الحجز (Reservation Sequentiality)

• checkReservationSequentiality: فرض ترتيب الحجز الصحيح
• checkReservationSequentialityInFirstSaveOnly: تطبيق فحص التسلسل عند الحفظ الأول فقط

إدارة المخزن والموقع (Warehouse and Location Management)

• reservationWarehouseSource:
  • NormalWarehouse: استخدام المخزن المعتاد للمستند
  • ReservationWarehouse: استخدام مخزن الحجز المتخصص
• reservationLocatorSource:
  • NormalLocator: استخدام الموقع المعتاد للمستند
  • ReservationLocator: استخدام موقع الحجز المتخصص

تكامل تتبع الكميات (Quantity Tracking Integration)

• reservationSatisfiedFields:
  • TrackInFirst: تتبع الكميات المنفذة في حقل الكمية الأول
  • TrackInSecond: تتبع الكميات المنفذة في حقل الكمية الثاني
• reservationCriteria: المعايير لتصفية السطور القابلة للحجز

التعامل مع المستندات المرتبطة (Related Document Handling)

• cancelReservationOfRelatedDocs: إلغاء تلقائي للحجوزات المرتبطة
• updateReservationOfRelatedDocs: تحديث الحجوزات المرتبطة عند تغيير الكميات
• updateReservationStatusInFromDoc: مزامنة الحالة مع المستندات المصدر

الفحص وضبط الجودة (Validation and Quality Control)

• checkAvailableQties: التحقق قبل الحفظ
• forceDoNotIncludeReserved: استبعاد الكميات المحجوزة من التحقق

تكامل نظام التوصيل (Delivery System Integration)

• useDelivSysEntriesForReserv: استخدام نظام التوصيل للحجوزات
• reserveFromDeliveryEntryQty: الحجز بناءً على كميات التوصيل
• rootDeliveryDocument: ربط بمستند التوصيل الرئيسي

مسار عملية الحجز (Reservation Process Flow)

1. إنشاء المستند والإعداد (Document Creation and Setup)

1. تحديد نوع المستند: يحدد النظام إذا كان المستند مبيعات/صرف (Pre-Out) أو مشتريات/استلام (Pre-In)
2. تحميل إعداد التوجيه: استرداد إعدادات الحجز من إعداد توجيه المستند
3. فحص إعداد الصنف: التحقق من صلاحيات الحجز وسياسات السحب على المكشوف على مستوى الصنف
4. تعيين المخزن/الموقع: تطبيق قواعد المخزن والموقع الخاصة بالحجز

2. توليد طلب الحجز (Reservation Request Generation)

عند حفظ مستند بحجوزات:

1. إنشاء InvTransReq: ينشئ النظام طلبات معاملات المخزون
2. معالجة السطور: تحويل سطور المستند إلى سطور طلب حجز
3. حساب الكمية:
   • للحجوزات الجديدة: استخدام كميات المستند الكاملة
   • للتحديثات بكميات منفذة: طرح المقادير المنجزة
4. نقل المحددات: نسخ محددات الصنف، المخزن، الموقع، ومعلومات التتبع

مرجع الكود: InvSystemFilesUtils.addRequestLine:354-373

3. فحص الكميات والتأثيرات (Quantity Validation and Effects)

تُجري طريقة setIdAndValidateQtyEffects فحصاً شاملاً:

1. فحص الكمية المتاحة: التحقق من وجود كميات كافية
2. فحص السحب على المكشوف: مراجعة سياسات السحب على مستوى الصنف، المجموعة، والنظام
3. معالجة الكميات المحجوزة:
   • لمستندات المبيعات/الصرف: زيادة كميات Pre-Out
   • لمستندات المشتريات/الاستلام: زيادة كميات Pre-In
4. حساب الرصيد: تحديث الرصيد المتاح بناءً على إعداد الصنف

مرجع الكود: QtyTransUtils.setIdAndValidateQtyEffects:154-285

4. تحديثات الكمية المنفذة (للمستندات المرتبطة)

عند إنشاء مستند من مستند آخر بحجوزات:

1. تحديد المستند المصدر: إيجاد المستند الأصل
2. إعداد تتبع الكميات: استرداد إعدادات حقل التتبع
3. حساب الكمية المنفذة: تحديث المقادير المنجزة في المستند المصدر
4. تعديل الحجز: تقليل حجز المستند المصدر بمقدار الكمية المنفذة
5. إنشاء حجز جديد: إنشاء حجز جديد للمستند الحالي

مرجع الكود: SCRelatedQtiesUtil.updateSatisfiedQtiesd:80-149

5. إلغاء الحجز (Reservation Cancellation)

مشغلات الإلغاء التلقائي (Automatic Cancellation Triggers)

• حذف المستند: يلغي تلقائياً جميع تأثيرات الحجز
• علامة CancelReservation: إلغاء يدوي عبر واجهة المستند
• معالجة المستندات المرتبطة: إلغاء متتالي عبر سلاسل المستندات

عملية الإلغاء (Cancellation Process)

1. التحقق: فحص ما إذا كان الإلغاء مسموحاً به حسب إعداد التوجيه
2. تغيير نوع الطلب: تحويل طلبات الحجز إلى عمليات DELETE
3. عكس التأثير: إزالة كميات Pre-In/Pre-Out
4. التحديثات المرتبطة: تحديث جميع المستندات المرتبطة في السلسلة

مرجع الكود: BasicSCDocument.cancelReservationOfRelatedIfNeeded

نقاط التكامل مع النظام (System Integration Points)

تكامل إدارة المخزون (Inventory Management Integration)

تأثيرات الكميات (Quantity Effects)

• سجلات ItemDimensionsQty: تخزن تأثيرات الحجز لكل تركيبة صنف/محدد
• ItemDimensionsQty.data: تتبع كميات الداخل/الخارج/Pre-In/Pre-Out
• حساب الرصيد: مراعاة الكميات المحجوزة بناءً على إعداد الصنف

معالجة المعاملات (Transaction Processing)

• ReservationTransLine: يدير سطور معاملات الحجز

تكامل سير عمل المستندات (Document Workflow Integration)

علاقات المستند المصدر (Source Document Relationships)

• معالجة "بناءاً على": الإنشاء التلقائي من أوامر البيع، أوامر الشراء، وغيرها
• تتبع سلسلة المستندات: الحفاظ على العلاقات لتتبع الكميات
• توارث الكميات: نسخ الكميات والمحددات من المستندات المصدر

سلوك مستندات المخزون (Stock Document Behavior)

هام: لمستندات الصرف المخزني، الاستلام المخزني، والتحويل المخزني سلوك خاص:

• لا حجوزات مباشرة: لا تنشئ كميات Pre-In أو Pre-Out
• تأثيرات الكميات الفعلية: تعدّل الكميات الفعلية الداخلة والخارجة فقط
• إلغاء الحجز: يمكنها إلغاء حجوزات المستندات الأعلى

تكامل نظام التوصيل (Delivery System Integration)

الحجوزات القائمة على التوصيل (Delivery-Based Reservations)

• تكامل DeliverySysEntry: استخدام كميات نظام التوصيل بدلاً من كميات المستند
• معالجة المدخل الجذر: إنشاء سطور الحجز من مدخلات التوصيل
• إدارة الكمية المتبقية: الحجز بناءً على الكميات المتبقية في نظام التوصيل

مرجع الكود: InvSystemFilesUtils.createInvReqLinesFromEntries

واجهة المستخدم والعمليات (User Interface and Operations)

تخطيط شاشة التحرير الرئيسية (Main Edit Screen Layout)

شبكة التفاصيل (Details Grid)

توفر شبكة التفاصيل إدارة شاملة للأصناف:

تعريف الصنف:

• رمز الصنف والوصف
• كميات التشكيلة والقياس
• المحددات (الطول، العرض، الارتفاع)

إدارة الكميات:

• الكمية الأولى بوحدة القياس
• تتبع الكمية الثانية
• عرض الكمية المحجوزة
• تتبع الكميات المنفذة/غير المنفذة

محددات الأبعاد:

• المخزن والموقع (يمكن أن يختلفا عن الرأسية)
• الأرقام التسلسلية والمعرّفات
• محددات الصنف (الصندوق، المراجعة، المقاس، اللون، الشحنة)
• نسب الفاعلة/غير الفاعلة
• تواريخ الإنتاج، الانتهاء، وإعادة الاختبار

معلومات التتبع:

• حالة الحجز على مستوى السطر
• تاريخ الحجز وتعيين المخزن

الإجراءات المتاحة (Available Actions)

إجراءات الحجز الأساسية:

1. تطبيق الحجز (Apply Reservation) - تنفيذ تأثيرات الحجز على المخزون
2. إلغاء الحجز (Cancel Reservation) - إلغاء تأثيرات الحجز للمستندات المرتبطة

دليل استكشاف الأخطاء وإصلاحها (Troubleshooting Guide)

المشكلات الشائعة والحلول (Common Issues and Solutions)

مشكلة: أخطاء نقص الكمية (Issue: Insufficient Quantity Errors)

رسالة الخطأ: "Insufficient quantity for item [ItemCode], Available Quantity is [X], Reserved quantity is [Y]"

الأسباب الجذرية:

1. نقص فعلي: الصنف لا يملك كمية كافية متاحة
2. حجب الكميات المحجوزة: حجوزات سابقة تستهلك التوفر
3. مشكلة إعداد: إعداد includeReservedInBalance للصنف يؤثر على الحسابات
4. عدم تطابق المحددات: المخزن/الموقع/الشحنة المحددة لا تحتوي على الصنف
5. سياسة السحب على المكشوف: إعدادات الصنف أو النظام تمنع السحب على المكشوف

خطوات التشخيص:

1. فحص كميات المخزون الفعلية في المخزن/الموقع المحدد
2. مراجعة إعداد الصنف لـ includeReservedInBalance
3. التحقق من إعداد allowOverdraftInReservation للصنف
4. فحص مطابقة محددات الأبعاد مع المخزون المتاح
5. مراجعة سياسات السحب على المكشوف على مستوى النظام

الحلول:

1. نقل المخزون: نقل الأصناف من مواقع أخرى
2. تعديل إعداد الصنف: تعديل includeReservedInBalance عند الاقتضاء
3. إلغاء الحجوزات المنافسة: مراجعة وإلغاء الحجوزات غير الضرورية
4. تعديل المحددات: تعديل المخزن، الموقع، أو متطلبات المحددات الأخرى

مشكلة: انتهاكات تسلسل الحجز (Issue: Reservation Sequentiality Violations)

المشكلة: رفض النظام للحجز بسبب قواعد التسلسل

الأسباب:

1. إعداد التوجيه: تفعيل checkReservationSequentiality
2. ترتيب المستندات: لم تُنشأ المستندات بالتسلسل المطلوب
3. انقطاع السلسلة: مستندات وسيطة مفقودة في سير العمل

الحلول:

1. مراجعة إعدادات التسلسل: فحص إمكانية استخدام checkReservationSequentialityInFirstSaveOnly
2. ترتيب المستندات: التأكد من إنشاء المستندات بالتسلسل الصحيح
3. تعديل الإعداد: النظر في تخفيف متطلبات التسلسل إذا سمح العمل بذلك
4. مراجعة سير العمل: التأكد من اكتمال سلسلة المستندات

مشكلة: عدم عمل تحديثات المستندات المرتبطة (Issue: Related Document Updates Not Working)

المشكلة: التغييرات في سند الحجز لا تُحدّث المستندات المصدر

قائمة التشخيص:

1. علاقات المستندات: التحقق من الربط الصحيح في حقل "بناءاً على"
2. إعداد التوجيه: فحص إعداد updateReservationOfRelatedDocs
3. تتبع الكميات: التحقق من إعداد reservationSatisfiedFields
4. تحديثات الحالة: تأكيد تفعيل updateReservationStatusInFromDoc

الحلول:

1. تهيئة العلاقات: ضمان إعداد سلسلة المستندات الصحيح
2. تفعيل التحديثات: تشغيل إعدادات تحديث المستندات المرتبطة
3. تعيين الحقول: إعداد حقول كمية الوفاء المناسبة
4. اختبار السلسلة: التحقق من تدفق التحديثات عبر التسلسل الهرمي للمستندات

مشكلة: أخطاء تتبع الكميات المنفذة (Issue: Satisfied Quantity Tracking Errors)

المشكلة: الكميات المنفذة لا تُحدَّث بشكل صحيح بين المستندات

الأسباب الشائعة:

1. إعداد مفقود: forceTrackQtyOfRelatedDocs غير مفعّل
2. تعيين الحقول: إعداد خاطئ لـ relatedDocQtyFields أو reservationSatisfiedFields
3. تحويل الوحدات: فشل في تحويل وحدات القياس بين المستندات
4. انقطاع السلسلة: مشكلات في علاقة المستندات

الحلول:

1. تفعيل التتبع: تشغيل تتبع الكميات في إعداد التوجيه
2. إعداد الحقول: التحقق من تعيينات حقول الكميات الصحيحة
3. إعداد وحدات القياس: ضمان وجود تحويلات وحدات القياس الصحيحة
4. التحقق من العلاقة: فحص سلامة سلسلة المستندات

مرجع الإعداد الشامل (Complete Configuration Reference)

يوفر هذا القسم قائمة شاملة بجميع خيارات الإعداد المرتبطة بنظام الحجوزات، مرتبةً حسب موقعها في النظام.

إعداد توجيه المستند (InvDocTermConfig)

الموقع: توجيه المستند > تبويب إعداد التوجيه

إعدادات الحجز الأساسية (Basic Reservation Settings)

حقل الإعداد	الترجمة العربية	الوصف
reserve	حجز	تفعيل/تعطيل وظيفة الحجز لهذا النوع من المستندات
reserveFromReservationQty	حجز من كميات الحجز وليس من كمية المستند	الحجز من كميات الحجز الموجودة بدلاً من كميات المستند
preventCancelReservation	منع إلغاء الحجز	تعطيل إلغاء الحجز لهذا النوع من المستندات

التحكم في تسلسل الحجز (Reservation Sequentiality Control)

حقل الإعداد	الترجمة العربية	الوصف
checkReservationSequentiality	التاكد من تسلسل الحجز	فرض ترتيب الحجز الصحيح عبر سلسلة المستندات
checkReservationSequentialityInFirstSaveOnly	التاكد من التسلسل في الحفظ اول مرة فقط	تطبيق فحص التسلسل عند حفظ المستند لأول مرة فقط

إدارة المخزن والموقع (Warehouse and Location Management)

حقل الإعداد	الترجمة العربية	الوصف
reservationWarehouseSource	مصدر مخزن الحجز	تحديد قواعد اختيار المخزن للحجوزات
reservationLocatorSource	مصدر موقع الحجز	تحديد قواعد اختيار الموقع للحجوزات

قيم مصدر المخزن:

• NormalWarehouse: استخدام المخزن المعتاد للمستند
• ReservationWarehouse: استخدام مخزن الحجز المتخصص

قيم مصدر الموقع:

• NormalLocator: استخدام الموقع المعتاد للمستند
• ReservationLocator: استخدام موقع الحجز المتخصص

تتبع الكميات والوفاء (Quantity Tracking and Satisfaction)

حقل الإعداد	الترجمة العربية	الوصف
reservationSatisfiedFields	حقول الكمية الملغي حجزها	تهيئة الحقول التي تتبع كميات الحجز المنفذة
reservationCriteria	فلتر سطور الحجز	المعايير لتصفية السطور القابلة للحجز

قيم حقول الوفاء:

• TrackInFirst: تتبع الكميات المنفذة في حقل الكمية الأول
• TrackInSecond: تتبع الكميات المنفذة في حقل الكمية الثاني

معالجة المستندات المرتبطة (Related Document Processing)

حقل الإعداد	الترجمة العربية	الوصف
cancelReservationOfRelatedDocs	إلغاء حجز المستندات المرتبطة	إلغاء تلقائي لحجوزات المستندات المرتبطة
updateReservationOfRelatedDocs	تحديث حجز المستندات المرتبطة	تحديث الحجوزات المرتبطة عند تغيير الكميات
updateReservationStatusInFromDoc	تحديث حالة الحجز في المستند المرتبط	مزامنة حالة الحجز مع المستندات المصدر

إعداد تتبع الكميات (Quantity Tracking Configuration)

حقل الإعداد	الترجمة العربية	الوصف
forceTrackQtyOfRelatedDocs	متابعة كمية المستند المرتبط إجبارياً	تفعيل تتبع الكميات الإجباري بين المستندات
updateTrackQtyInRelatedDoc	تحديث متابعة الكميات في السند المرتبط	تحديث كميات التتبع في المستندات المصدر
relatedDocQtyPolicy	متابعة كمية المستند المرتبط	سياسة التعامل مع فوارق الكميات
relatedDocQtyFields	حقول متابعة الكميات في السند المرتبط	الحقول المستخدمة للتتبع (الكمية الأولى أو الثانية)

الفحص وضبط الجودة (Validation and Quality Control)

حقل الإعداد	الترجمة العربية	الوصف
checkAvailableQties	التاكد من الكميات المتاحة قبل الحفظ	فحص الكميات المتاحة قبل الحفظ
forceDoNotIncludeReserved	عدم اعتبار المحجوز عند التأكد من الكميات	استبعاد الكميات المحجوزة من الفحص

تكامل نظام التوصيل (Delivery System Integration)

حقل الإعداد	الترجمة العربية	الوصف
useDelivSysEntriesForReserv	الحجز بأستخدام جدول التوصيل النظامي	استخدام مدخلات نظام التوصيل للحجوزات
reserveFromDeliveryEntryQty	حجز من كمية جدول التوصيل النظامي	الحجز بناءً على كميات نظام التوصيل
rootDeliveryDocument	مستند توصيل رئيسي	ربط بمستند التوصيل الرئيسي

إعداد الصنف (ItemConfigurations)

الموقع: الصنف الرئيسي > تبويب إعداد الصنف

حقل الإعداد	الترجمة العربية	الوصف
includeReservedInBalance	اعتبار المحجوز في الرصيد	هل تؤثر الكميات المحجوزة على حسابات الرصيد المتاح
allowOverdraftInReservation	السماح بالسحب على المكشوف في الحجز	السماح بالحجوزات حتى عند نقص الكميات
overDraftPolicy	سياسة السحب على المكشوف	سياسة السحب على المكشوف على مستوى الصنف (Yes/No/Inherited)

إعداد سلسلة التوريد (SupplyChainConfigurations)

الموقع: إعداد النظام > إعدادات سلسلة التوريد

إعدادات الحجز الأساسية (Core Reservation Settings)

حقل الإعداد	الترجمة العربية	الوصف
reservationType	نوع الحجز	نوع الحجز العام (تلقائي/يدوي)
checkQtiesInReservationDocs	فحص الكميات في سندات الحجز	فحص الكميات في سندات الحجز
cancelReservationOfDirectParentsOnly	إلغاء حجز الوالدين المباشرين فقط	إلغاء حجز المستندات الأعلى المباشرة فقط

التحكم في السحب على المكشوف (Overdraft Control)

حقل الإعداد	الترجمة العربية	الوصف
overDraftPolicy	سياسة السحب على المكشوف	سياسة السحب على المكشوف على مستوى النظام
dimensionsWithAllowedOverdraft	الأبعاد المسموح بها السحب على المكشوف	المحددات التي يُسمح فيها بالسحب على المكشوف
checkOverdraftByDate	فحص السحب على المكشوف بالتاريخ	فحص السحب على المكشوف بالتاريخ
includeReservationInCheckOverdraftByDate	تضمين الحجز في فحص السحب على المكشوف بالتاريخ	تضمين الحجز في فحص السحب على المكشوف بالتاريخ
doNotCheckOverdraftByDateForReservation	عدم فحص السحب على المكشوف بالتاريخ للحجز	عدم فحص السحب على المكشوف بالتاريخ للحجوزات

إعداد فحص الكميات (Quantity Check Configuration)

حقل الإعداد	الترجمة العربية	الوصف
checkQtyByDateOnly	فحص الكمية بالتاريخ فقط	فحص الكمية بالتاريخ فقط
checkQtyByDateOnlyWithReservation	فحص الكمية بالتاريخ فقط مع الحجز	فحص الكمية بالتاريخ فقط مع الحجز
reservationSettings	إعدادات الحجز	إعدادات خاصة بالحجز لتجاهل فحوصات معينة
doNotConsiderDimensionsInOverdraftByDate	عدم اعتبار الأبعاد في السحب على المكشوف بالتاريخ	عدم اعتبار المحددات في السحب على المكشوف بالتاريخ
doNotConsiderDimensionsInOverdraftByDateWithReservation	عدم اعتبار الأبعاد في السحب على المكشوف بالتاريخ مع الحجز	عدم اعتبار المحددات في السحب على المكشوف بالتاريخ مع الحجز

نظام تتبع الكميات (Quantity Tracking System)

حقل الإعداد	الترجمة العربية	الوصف
useEntriesForTrackQuantities	استخدام المدخلات لتتبع الكميات	استخدام مدخلات النظام لتتبع الكميات
ignoreQtyTrackingWhithDocumentDelete	تجاهل تتبع الكميات مع حذف المستند	تجاهل تتبع الكميات عند حذف المستندات
updateReservationQtyWithPrimeQtyChange	تحديث كمية الحجز مع تغيير الكمية الرئيسية	تحديث كمية الحجز عند تغيير الكمية الرئيسية

إعدادات مستندات التحويل والمخزون (Transfer and Stock Document Settings)

حقل الإعداد	الترجمة العربية	الوصف
transReqReserveQtyOutOnly	طلب التحويل يحجز الكمية الخارجة فقط	طلب التحويل يحجز الكمية الخارجة فقط
showToItemDimensionsInTransfer	إظهار أبعاد الصنف المستقبل في التحويل	إظهار محددات الصنف الوجهة في التحويلات
doNotUpdateItemLotAndBoxFromIssueAndSales	عدم تحديث شحنة وصندوق الصنف من الصرف والمبيعات	عدم تحديث شحنة وصندوق الصنف من الصرف والمبيعات

الأداء والمعالجة (Performance and Processing)

حقل الإعداد	الترجمة العربية	الوصف
checkOverdraftNextTransCount	عدد المعاملات التالية لفحص السحب على المكشوف	عدد المعاملات التالية لفحص السحب على المكشوف
doNotCheckOverdraftWithRecommit	عدم فحص السحب على المكشوف مع إعادة الحفظ	عدم فحص السحب على المكشوف مع عمليات إعادة الحفظ

إعداد مجموعة الأصناف (Item Section Configuration)

الموقع: الصنف الرئيسي > مجموعة الأصناف > الإعداد

حقل الإعداد	الترجمة العربية	الوصف
overDraftPolicy	سياسة السحب على المكشوف	سياسة السحب على المكشوف على مستوى المجموعة (Yes/No/Inherited)

قيم Enum وقيم الحجز على مستوى النظام (System-Wide Reservation Enums and Values)

التسلسل الهرمي للإعداد والتوارث (Configuration Hierarchy and Inheritance)

يستخدم نظام الحجوزات نهجاً هرمياً للإعداد:

1. مستوى النظام: يوفر SupplyChainConfigurations الإعدادات الافتراضية العامة
2. مستوى مجموعة الأصناف: سياسات السحب على المكشوف والتتبع لمجموعة الأصناف
3. مستوى الصنف: تجاوزات إعداد الصنف المنفرد
4. مستوى توجيه المستند: سلوك الحجز الخاص بالمستند
5. مستوى سطر المستند: إعدادات الحجز الخاصة بالسطر

ترتيب الأولوية (من الأعلى إلى الأدنى):

1. إعدادات سطر المستند
2. إعداد توجيه المستند
3. إعداد الصنف
4. إعداد مجموعة الأصناف
5. إعداد النظام

قواعد التحقق من الإعداد (Configuration Validation Rules)

الإعدادات المطلوبة للحجز الأساسي (Required Configurations for Basic Reservation)

• توجيه المستند: reserve = true
• إعداد الصنف: إعداد overDraftPolicy صالح
• إعداد النظام: إعداد reservationType صالح

الإعدادات المطلوبة لتتبع الكميات (Required Configurations for Quantity Tracking)

• توجيه المستند: forceTrackQtyOfRelatedDocs = true
• توجيه المستند: يجب تحديد relatedDocQtyFields
• إعداد النظام: useEntriesForTrackQuantities (اختياري)

الإعدادات المطلوبة لتحديثات الحجز (Required Configurations for Reservation Updates)

• توجيه المستند: updateReservationOfRelatedDocs = true
• توجيه المستند: يجب تحديد reservationSatisfiedFields
• توجيه المستند المصدر: reserve = true