توثيق خاصية الشروط والأحكام القياسية (Standard Terms and Conditions Feature Documentation)

TIP

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

نظرة عامة (Overview)

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

المكونات الرئيسية (Key Components)

1. الشرط القياسي للمبيعات - ملف رئيسي (Sales Standard Term - Master File)

الكيان: SalesStandardTerm
الجدول: SalesStandardTerm
النوع: ملف رئيسي

هذا هو التعريف الرئيسي للشروط القياسية التي يمكن إرفاقها بوثائق المبيعات.

حقول الإعداد (Configuration Fields):

• الكود (code): معرّف فريد للشرط
• الاسم 1 (name1): الاسم/الوصف الرئيسي للشرط
• يتطلب وثيقة إتمام الشرط القياسي (requiresTermFulfillment): علامة منطقية تشير إلى ما إذا كان هذا الشرط يحتاج إلى تتبع رسمي للوفاء به
• يُستخدم مع وثيقة تمديد الشرط القياسي (useWithTermExtension): علامة منطقية تشير إلى إمكانية تمديد هذا الشرط
• فترة العمل الأولية للشرط (initialTermWorkPeriod): المدة الافتراضية للشرط (تشمل القيمة ووحدة القياس)
• ملاحظات 2 (remarks2): ملاحظات إضافية أو وصف تفصيلي للشرط

2. وثيقة إتمام الشرط القياسي (Standard Term Fulfillment Document)

الكيان: StandardTermFulfillment
الجدول: StandardTermFulfillment
النوع: ملف وثيقة

وثيقة تُستخدم لتسجيل الوفاء بشروط محددة رسميًا.

الحقول الرئيسية (Key Fields):

• من وثيقة (fromDoc): مرجع عام للوثيقة المصدر (مثل فاتورة المبيعات)
• التفاصيل (details): مجموعة من سطور الوفاء

حقول سطر الوفاء (Fulfillment Line Fields):

• الشرط القياسي (standardTerm): حقل مرجع للشرط القياسي للمبيعات الذي تم الوفاء به
• تاريخ الوفاء (fulfillmentDate): التاريخ الذي تم فيه الوفاء بالشرط

3. وثيقة تمديد الشرط القياسي (Standard Term Extension Document)

الكيان: StandardTermExtension
الجدول: StandardTermExtension
النوع: ملف وثيقة

وثيقة تُستخدم لتمديد الموعد النهائي للشروط القياسية التي تسمح بالتمديد.

الحقول الرئيسية (Key Fields):

• من وثيقة (fromDoc): مرجع عام للوثيقة المصدر
• التفاصيل (details): مجموعة من سطور التمديد

حقول سطر التمديد (Extension Line Fields):

• الشرط القياسي (standardTerm): حقل مرجع للشرط القياسي للمبيعات المراد تمديده
• فترة التمديد (extensionPeriod): مدة إضافية للتمديد
• غرامة التمديد (extensionFine): غرامة مالية مقابل التمديد

التطبيق في وثائق المبيعات (Implementation in Sales Documents)

سطر الشروط القياسية في فاتورة المبيعات (Sales Invoice Standard Terms Line)

يمكن للوثائق كفواتير المبيعات تضمين الشروط القياسية من خلال سطور التفاصيل.

حقول السطر (Line Fields):

• الشرط القياسي (standardTerm): حقل مرجع للشرط القياسي للمبيعات
• ملاحظات (remarks): ملاحظات إضافية خاصة بهذه الحالة
• تاريخ انتهاء الشرط القياسي المخطط (termPlannedEndDate): الموعد النهائي الأصلي للشرط
• تاريخ انتهاء الشرط القياسي بعد التمديد (termExtendedEndDate): الموعد النهائي المحدث بعد التمديدات (يحسبه النظام)
• تاريخ الوفاء (fulfillmentDate): تاريخ الوفاء (يحدّثه النظام)
• إجمالي غرامات التمديد (extensionFines): الغرامات المتراكمة من جميع التمديدات (يحسبها النظام)
• وثيقة الوفاء (fulfillmentDoc): حقل مرجع لوثيقة إتمام الشرط القياسي (يحدّثه النظام)

حقول مخصصة إضافية (Additional Custom Fields):

يوفر النظام حقولًا مرنة للبيانات المخصصة:

• حقول مرجع (ref1 إلى ref5): مراجع عامة للربط بكيانات أخرى
• حقول رقمية (n1 إلى n5): قيم عشرية للحسابات المخصصة
• حقول نصية (text1 إلى text5): قيم نصية للمعلومات الإضافية
• حقول التاريخ (date1 إلى date5): قيم تاريخ لتتبع المعالم
• المرفقات (attachment1 إلى attachment3): بيانات ثنائية للوثائق الداعمة

مسار العمل التجاري (Business Process Flow)

1. مرحلة الإعداد (Setup Phase)

1. أنشئ الشروط القياسية للمبيعات في الملف الرئيسي
2. قم بتهيئة كل شرط بما يلي:
   • هل يتطلب تتبع الوفاء
   • هل يمكن تمديده
   • مدة العمل الافتراضية

2. إنشاء الوثيقة (Document Creation)

1. أضف الشروط القياسية إلى وثائق المبيعات (الفواتير والعروض وما إليها)
2. يحسب النظام تلقائيًا termPlannedEndDate بناءً على:
   • تاريخ قيمة الوثيقة
   • الفترة الأولية للشرط
3. بالنسبة للشروط القابلة للتمديد، يحسب النظام termExtendedEndDate مع مراعاة أي تمديدات قائمة

3. عملية تمديد الشرط (Term Extension Process)

1. أنشئ وثيقة تمديد الشرط القياسي
2. أشر إلى الوثيقة المصدر
3. أضف سطور تمديد محددةً:
   • أي الشروط يُراد تمديدها
   • فترة التمديد
   • غرامات التمديد
4. يقوم النظام بتحديث:
   • termExtendedEndDate في الوثيقة الأصلية
   • تراكم extensionFines

4. عملية الوفاء بالشرط (Term Fulfillment Process)

1. أنشئ وثيقة إتمام الشرط القياسي
2. أشر إلى الوثيقة المصدر
3. أضف سطور وفاء محددةً:
   • أي الشروط تم الوفاء بها
   • تواريخ الوفاء
4. يتحقق النظام ويحدّث:
   • fulfillmentDate في الوثيقة الأصلية
   • حقل مرجع fulfillmentDoc

قواعد التحقق (Validation Rules)

تفرد الشروط (Term Uniqueness)

• يمكن أن يظهر كل شرط قياسي مرة واحدة فقط لكل وثيقة (للشروط التي تتطلب وفاءً أو تمديدًا)
• يتحقق النظام من ذلك عند حفظ الوثيقة

التحقق من التمديد (Extension Validation)

• لا يمكن تطبيق التمديدات بعد الوفاء بالشرط
• تتم معالجة التمديدات بالترتيب الزمني بناءً على تاريخ الإنشاء
• يمنع النظام التمديدات المتعارضة

التحقق من الوفاء (Fulfillment Validation)

• لا يمكن الوفاء بالشرط إلا مرة واحدة
• إذا كانت وثيقة وفاء موجودة بالفعل لشرط ما، فلا يمكن لوثيقة أخرى الوفاء به
• يتحقق النظام من تواريخ الوفاء مقارنةً بفترات التمديد

التطبيق التقني (Technical Implementation)

الواجهات الرئيسية (Key Interfaces)

IHasStandardTerms

تُطبَّق في الوثائق التي تدعم الشروط القياسية:

• fetchTerms(): يُرجع مجموعة سطور الشروط القياسية
• termLineClassType(): يُرجع نوع فئة السطر المحددة
• calcStandardTermEndDateAfterExtension(): يحسب التواريخ مع مراعاة التمديدات
• validateStandardTerms(): يتحقق من تفرد الشروط وقواعدها

IStandardTermLine

تُطبَّق في فئات سطر الشروط القياسية:

• أدوات الوصول والتعيين لجميع الحقول المتعلقة بالشروط
• تُدار الحقول الخاصة بالنظام تلقائيًا

فئة الأداة المساعدة: StandardTermUtils

توفر المنطق التجاري الأساسي:

• markStandardTermAsFulfilled(): يعالج وثائق الوفاء
• extendStandardTerm(): يعالج وثائق التمديد
• unFilFullStandardTerms(): يعكس الوفاء
• cancelExtendStandardTerm(): يعكس التمديد
• calcTermEndDatesAfterExtension(): يعيد حساب التواريخ

أمثلة الإعداد (Configuration Examples)

مثال 1: شروط الدفع (Payment Terms)

إعداد الشرط:

• الكود: PAY30
• الاسم: "السداد خلال 30 يومًا"
• يتطلب وفاء: نعم
• يسمح بالتمديد: نعم
• الفترة الأولية: 30 يومًا

الاستخدام: يُرفق بفواتير المبيعات لتتبع مواعيد الدفع النهائية والتمديدات.

مثال 2: شروط التسليم (Delivery Terms)

إعداد الشرط:

• الكود: DEL7
• الاسم: "التسليم خلال 7 أيام"
• يتطلب وفاء: نعم
• يسمح بالتمديد: لا
• الفترة الأولية: 7 أيام

الاستخدام: يُرفق بأوامر المبيعات لتتبع التزامات التسليم.

مثال 3: شروط الضمان (Warranty Terms)

إعداد الشرط:

• الكود: WAR365
• الاسم: "ضمان لمدة سنة"
• يتطلب وفاء: لا
• يسمح بالتمديد: نعم
• الفترة الأولية: 365 يومًا

الاستخدام: يُرفق بفواتير المبيعات لتتبع الضمان.

ملخص (Summary)

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