معاملات العملاء

أي شيء يكلف المال في النظام يتم تسجيله كمعاملة تحت العميل.

تحتوي كل معاملة على مبلغ مالي لتكلفة الجملة وتكلفة التجزئة، ووصف لما تتعلق به المعاملة.

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

يمكن أيضًا إنشاء المعاملات يدويًا، على سبيل المثال، إذا تم منح العميل ائتمانًا، يتم إنشاء معاملة لمبلغ الائتمان، أو إذا تم فرض رسوم تركيب، يتم إنشاء معاملة لرسوم التركيب.

تُجمع المعاملات معًا لتشكيل الفواتير، والتي تُرسل إلى العميل للدفع.

الوصول إلى المعاملات

يمكن عرض المعاملات على مستوى النظام أو لكل عميل:

عرض لكل عميل:

1. انتقل إلى العملاء → [اختر عميلًا]
2. انقر على علامة التبويب الفوترة
3. عرض قائمة المعاملات في البطاقة الأولى

عرض على مستوى النظام:

1. انتقل إلى الفوترة → المعاملات (من القائمة الرئيسية)
2. عرض جميع المعاملات عبر جميع العملاء

أدوات إحصائيات المعاملات

في أعلى صفحة المعاملات، تعرض أربع بطاقات إحصائية ملخصات مالية:

{.align-center width="800px"}

وصف الأدوات:

• إجمالي المعاملات - مجموع جميع تكاليف المعاملات بالتجزئة (على مر الزمن)
• إجمالي المعاملات غير المفوترة - مجموع المعاملات التي لم يتم تضمينها بعد في فاتورة
• إجمالي المعاملات هذا الشهر - مجموع المعاملات التي تم إنشاؤها هذا الشهر الميلادي
• إجمالي المعاملات الشهر الماضي - مجموع المعاملات التي تم إنشاؤها الشهر الماضي

تنسيق القيم:

• القيم التي تزيد عن 1,000: تُعرض مع لاحقة "k" (مثل، $1.5k)
• القيم التي تزيد عن 1,000,000: تُعرض مع لاحقة "M" (مثل، $2.3M)
• القيم التي تزيد عن 1,000,000,000: تُعرض مع لاحقة "B" (مثل، $1.1B)

قائمة المعاملات

تعرض جدول المعاملات جميع المعاملات مع الأعمدة التالية:

وصف الأعمدة:

• ID - معرف المعاملة الفريد
• التاريخ - تاريخ إنشاء المعاملة
• العنوان - اسم المعاملة القصير
• الوصف - وصف مفصل لما تتعلق به المعاملة
• المبلغ - تكلفة التجزئة (إيجابي للرسوم، سلبي للاعتمادات)
• الفاتورة - معرف الفاتورة إذا تم فوتره المعاملة (رابط قابل للنقر)
• الحالة - علامة تحقق إذا تم فوترتها، شرطة إذا لم يتم فوترتها بعد

الإجراءات لكل صف:

كل صف يحتوي على قائمة إجراءات (⋮) مع الخيارات:

• عرض التفاصيل - يفتح نافذة تفاصيل المعاملة
• تنزيل فاتورة PDF - تنزيل PDF (فقط إذا تم فوترتها)
• إلغاء المعاملة - وضع علامة على المعاملة كملغاة (فقط إذا لم يتم فوترتها)

أنواع المعاملات

تنقسم المعاملات إلى فئتين رئيسيتين:

معاملات الخصم (الرسوم)

مبالغ إيجابية تزيد من رصيد العميل المستحق:

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

معاملات الائتمان (المدفوعات/المبالغ المستردة)

مبالغ سلبية تقلل من رصيد العميل المستحق:

• المدفوعات النقدية - دفع العميل نقدًا
• مدفوعات البطاقة - دفع العميل بواسطة بطاقة الائتمان/الخصم
• مدفوعات التحويل البنكي - دفع العميل عبر التحويل البنكي
• اعتمادات الحساب - اعتمادات حسن النية، تعويض
• المبالغ المستردة - الأموال المعادة للعميل
• الخصومات - خصومات ترويجية أو ولاء

إضافة معاملة يدويًا

انقر على "+ إضافة معاملة" لفتح نافذة إضافة المعاملة.

معاملة خصم (رسوم):

{.align-center width="800px"}

معاملة ائتمان (مدفوعات/مبالغ مستردة):

{.align-center width="800px"}

وصف الحقول:

• نوع المعاملة - اختر خصم (رسوم) أو ائتمان (مدفوعات/مبالغ مستردة)
• نوع الائتمان - إذا تم اختيار ائتمان، اختر طريقة الدفع (نقدي، بطاقة، تحويل بنكي)
• العنوان - اسم قصير للمعاملة (مطلوب)
• الوصف - شرح مفصل (اختياري)
• تكلفة التجزئة - المبلغ الذي يدفعه العميل (مطلوب، رقم إيجابي)
• تكلفة الجملة - تكلفتك (اختياري، لتتبع الهامش)
• نسبة الضريبة - معدل الضريبة المطبق على هذه المعاملة (اختياري، الافتراضي هو ضريبة المنتج أو 0%)
• الخدمة - ربط المعاملة بخدمة معينة (اختياري)
• الموقع - ربط المعاملة بموقع معين (اختياري)
• تاريخ المعاملة - تاريخ المعاملة (الافتراضي هو اليوم)

التحقق:

• العنوان وتكلفة التجزئة مطلوبان
• يجب أن تكون تكلفة التجزئة رقمًا إيجابيًا
• إذا تم اختيار نوع الائتمان، يجب اختيار نوع الائتمان

ماذا يحدث:

1. يتم إنشاء المعاملة في قاعدة البيانات
2. تظهر في قائمة معاملات العميل
3. تُدرج في عدد "المعاملات غير المفوترة"
4. متاحة للتضمين في إنشاء الفاتورة التالية
5. يتم إنشاء إدخال في سجل النشاط

البحث و��صفية المعاملات

البحث

استخدم شريط البحث للعثور على المعاملات. يتم البحث عبر:

• معرف المعاملة
• العنوان
• الوصف
• معرف الفاتورة

الفلاتر

تطبيق الفلاتر لتضييق قائمة المعاملات:

الفلاتر المتاحة:

• حالة الإلغاء - الكل، ملغاة، غير ملغاة
• حالة الفاتورة - الكل، مفوترة، غير مفوترة

إجراءات الفلترة:

• تطبيق الفلاتر - تطبيق الفلاتر المحددة على القائمة
• إعادة تعيين الفلاتر - مسح جميع الفلاتر وعرض جميع المعاملات

الفرز

انقر على أي رأس عمود للفرز:

• ID - فرز حسب معرف المعاملة (الأحدث/الأقدم)
• التاريخ - فرز حسب تاريخ المعاملة
• العنوان - فرز أبجديًا
• المبلغ - فرز حسب تكلفة التجزئة (الأعلى/الأدنى)
• الفاتورة - فرز حسب معرف الفاتورة

انقر مرة أخرى لعكس اتجاه الفرز (تصاعدي ↔ تنازلي).

إلغاء المعاملات

يمكن إلغاء المعاملات المضافة عن طريق الخطأ (تحديدها كملغاة).

المتطلبات:

• يجب ألا تكون المعاملة مفوترة
• بمجرد فوترتها، لا يمكن إلغاء المعاملات (يجب ردها بدلاً من ذلك)

كيفية الإلغاء:

1. ابحث عن المعاملة في القائمة
2. انقر على قائمة الإجراءات (⋮)
3. اختر "إلغاء المعاملة"
4. أكد في النافذة

{.align-center width="600px"}

ماذا يحدث:

• يتم وضع علامة على المعاملة كـ void = true
• لم تعد تظهر في قائمة المعاملات الافتراضية
• مستبعدة من إنشاء الفواتير
• يمكن رؤيتها عن طريق تصفية "المعاملات الملغاة"
• يتم خصمها من إجمالي "المعاملات غير المفوترة"

ملاحظة: الإلغاء ليس هو نفسه الاسترداد. الإلغاء يعني "يجب ألا تكون هذه المعاملة موجودة أبدًا." الاسترداد يعني "عكس معاملة صالحة."

الضريبة على المعا��لات

يمكن أن تتضمن المعاملات ضريبة، والتي يتم حسابها تلقائيًا بناءً على تكوين ضريبة المنتج أو يتم تحديدها يدويًا لكل معاملة.

{.align-center width="800px"}

سلوك الضريبة:

• معاملات الخصم (الرسوم) - تُطبق الضريبة على الرسوم بناءً على:
  • نسبة ضريبة المنتج - إذا كانت المعاملة مرتبطة بمنتج، يتم تطبيق نسبة ضريبة المنتج تلقائيًا
  • تجاوز يدوي - يمكن للموظفين تجاوز نسبة الضريبة عند إنشاء معاملة
  • مبلغ الضريبة - يتم حسابه كـ: retail_cost × (tax_percentage / 100)
  • تنسيق العرض - يظهر كـ: $10.00 (10%) في قوائم المعاملات
• معاملات الائتمان (المدفوعات/المبالغ المستردة) - لا تُطبق ضريبة على الاعتمادات
  • يتم إخفاء حقل نسبة الضريبة لمعاملات الائتمان
  • يتم تعيين الضريبة تلقائيًا إلى 0% لجميع المدفوعات والمب��لغ المستردة
  • تقلل الاعتمادات من الرصيد المستحق للعميل دون آثار ضريبية

مثال على حساب الضريبة:

• المنتج: خطة موبايل مع ضريبة 10%، $50.00 تكلفة التجزئة
• حساب الضريبة التلقائي: $50.00 × 0.10 = $5.00
• العرض: $5.00 (10%)

الضريبة صفر (NIL/معفاة):

• يمكن أن تكون المنتجات معفاة من الضريبة عن طريق تعيين نسبة الضريبة إلى 0
• تكون الضريبة افتراضيًا 0% إذا لم يتم تحديدها
• تظهر المعاملات المعفاة من الضريبة "-" في عمود الضريبة

{.align-center width="800px"}

عرض تفاصيل المعاملة

انقر على معاملة لعرض التفاصيل الكاملة:

المعاملات المفوترة مقابل غير المفوترة

المعاملات غير المفوترة:

• لم يتم تضمينها بعد في أي فاتورة
• متاحة لإنشاء الفاتورة التالية
• يمكن إلغاؤها
• تُحسب ضمن إجمالي "المعاملات غير المفوترة"
• الحال�� تظهر شرطة (-)

المعاملات المفوترة:

• تم تضمينها في فاتورة
• لا يمكن إلغاؤها (يجب ردها إذا لزم الأمر)
• معرف الفاتورة قابل للنقر (يرتبط بتفاصيل الفاتورة)
• الحالة تظهر علامة تحقق (✓)
• لا يمكن تعديلها

إنشاء الفاتورة:

عند إنشاء فاتورة لعميل:

1. يجد النظام جميع المعاملات غير المفوترة لذلك العميل
2. يمكن تصفية حسب نطاق التاريخ
3. تُدرج المعاملات في الفاتورة الجديدة
4. يتم ملء حقل invoice_id للمعاملة
5. تُحدد المعاملة الآن كـ "مفوترة"

انظر payments_invoices لتفاصيل إنشاء الفاتورة.

سير العمل الشائعة

سير العمل 1: ائتمان يدوي لعدم توفر الخدمة

1. يتصل العميل: "كانت الخدمة متوقفة لمدة يومين"
2. يقرر الموظف منح ائتمان قدره £10
3. انتقل إلى علامة تبويب الفوترة للعميل
4. انقر على "+ إضافة معاملة"
5. اختر نوع المعاملة ائتمان
6. اختر نوع ائت��ان دفع نقدي
7. أدخل العنوان: "ائتمان عدم توفر الخدمة"
8. أدخل الوصف: "تعويض عن انقطاع لمدة يومين 8-9 يناير"
9. أدخل تكلفة التجزئة: 10.00
10. اختر الخدمة المتأثرة من القائمة المنسدلة
11. انقر على "إضافة معاملة"
12. تظهر المعاملة بمبلغ -£10.00
13. ستدرج في الفاتورة التالية كائتمان

سير العمل 2: رسوم تركيب يدوي

1. يقوم الفني الميداني بتركيب الخدمة
2. يحتاج الموظف إلى فرض رسوم تركيب قدرها £75
3. انتقل إلى علامة تبويب الفوترة للعميل
4. انقر على "+ إضافة معاملة"
5. اختر نوع المعاملة خصم
6. أدخل العنوان: "رسوم التركيب"
7. أدخل الوصف: "زيارة فني ميداني لتركيب الألياف"
8. أدخل تكلفة التجزئة: 75.00
9. أدخل تكلفة الجملة: 45.00 (اختياري، لتتبع الهامش)
10. اختر الخدمة التي تم تركيبها
11. اختر الموقع الذي تم التركيب فيه
12. انقر على "إضافة معاملة"
13. تظهر المعاملة في قائمة غير المفوترة
14. ستدرج في الفاتورة التالية

سير العمل 3: إلغاء معاملة مكررة

1. يلاحظ الموظف وجود معاملة مكررة
2. تحقق من أن المعاملة لم تُفوتر بعد
3. انقر على قائمة الإجراءات (⋮) على المعاملة المكررة
4. اختر "إلغاء المعاملة"
5. أكد في النافذة
6. تتم إزالة المعاملة من القائمة
7. ينخفض إجمالي غير المفوترين وفقًا لذلك

سير العمل 4: العثور على معاملات لفاتورة

1. تحتاج إلى إنشاء فاتورة شهرية
2. انقر على فلتر الفاتورة: "غير مفوترة"
3. انقر على تطبيق الفلاتر
4. عرض جميع المعاملات غير المفوترة
5. لاحظ المبلغ الإجمالي من الأدوات
6. انتقل لإنشاء الفاتورة
7. اختر نطاق التاريخ (مثل، 1-31 يناير)
8. المعاملات في النطاق مدرجة في الفاتورة

استكشاف الأخطاء وإصلاحها

لا يمكن إلغاء المعاملة

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

ظهور معاملات مكررة

• السبب: تم فرض رسوم على الخدمة عدة مرات أو خطأ في التوفير
• الإصلاح: قم بإلغاء المعاملة المكررة إذا لم تُفوتر. إذا تم فوترتها، قم بإصدار ائتمان.

لا تظهر المعاملة في القائمة

• السبب: تم تطبيق الفلاتر أو تم إلغاء المعاملة
• الإصلاح: انقر على "إعادة تعيين الفلاتر" لعرض جميع المعاملات. لرؤية المعاملات الملغاة، قم بتصفية "ملغاة: ملغاة".

إجمالي غير المفوترين لا يتطابق مع المتوقع

• السبب: بعض المعاملات تم فوترتها بالفعل، أو تم استبعاد المعاملات الملغاة
• الإصلاح: تطبيق فلتر "فاتورة: غير مفوترة" لرؤية غير المفوترين فقط. تحقق من المعاملات الملغاة بشكل منفصل.

لا يمكن إضافة معاملة (حقل العمي�� معطل)

• السبب: عرض صفحة المعاملات الخاصة بالعميل
• الإصلاح: تم اختيار العميل مسبقًا. إذا كنت بحاجة إلى إضافة معاملة لعميل مختلف، انتقل إلى صفحة المعاملات على مستوى النظام.

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

• payments_invoices - إنشاء الفواتير وإدارتها
• payments_process - معالجة المدفوعات مقابل الفواتير
• basics_payment - نظرة عامة على طرق الدفع
• csa_activity_log - عرض تاريخ المعاملات في سجل النشاط