تشخيص أخطاء فاتورة العملاء

⚡ الحل السريع

1. تسجيل الدخول: تأكد من تسجيل الدخول ورتط المستخدم بشركة
2. السنة المالية: أنشئ سنة مالية وفترة محاسبية نشطة
3. الحسابات: أنشئ حساب مبيعات (4100) وحساب ضريبة (217001)
4. العملاء: ربط العملاء بحسابات محاسبية
5. البنود: أضف بند واحد على الأقل قبل الحفظ

👤

الخطأ #1: مشاكل المستخدم والشركة

أخطاء متعلقة بتسجيل الدخول وتعيين الشركة

▼

❌ خطأ: المستخدم غير مسجل الدخول. يرجى تسجيل الدخول أولاً.

السبب: لم يتم تسجيل الدخول أو انتهت جلسة المستخدم

✅ الحل:

سجل خروج من النظام
سجل دخول مرة أخرى بحسابك
تأكد من صحة بيانات تسجيل الدخول

❌ خطأ: لم يتم تعيين الشركة للمستخدم

السبب: المستخدم لا ينتمي إلى أي شركة

✅ الحل:

اطلب من مسؤول النظام ربط المستخدم بشركة
اذهب إلى: إدارة المستخدمين → حرر المستخدم
اختر شركة من القائمة المنسدلة
احفظ البيانات وسجل خروج ثم دخول مجدداً

🔒

الخطأ #2: مشاكل الصلاحيات

المستخدم لا يملك صلاحيات الإنشاء أو التعديل

▼

❌ أنت لا تملك صلاحية إنشاء فواتير عملاء (customer-invoices.create)

السبب: صلاحية الإنشاء غير موجودة للمستخدم

✅ الحل:

اطلب من مسؤول النظام منح صلاحية 'customer-invoices.create'
تأكد من أن المستخدم لديه دور صحيح (Role)
يمكن لمسؤول النظام إضافة الصلاحية من لوحة الإدارة

❌ غير مصرح بإنشاء هذا العنصر (403 Forbidden)

السبب: السياسة (Policy) ترفض الإنشاء

✅ الحل:

اتصل بمسؤول النظام
ربما هناك قيود معينة على إنشاء فواتير جديدة

📋

الخطأ #3: بيانات الفاتورة غير صحيحة

أخطاء في التحقق من صحة البيانات (Validation)

▼

❌ العميل مطلوب / The customer_id field is required

السبب: لم يتم اختيار عميل

✅ الحل:

اختر عميل من قائمة "العميل" ▼
تأكد من وجود عملاء نشطين في النظام

❌ تاريخ الفاتورة مطلوب / The invoice_date field is required

السبب: حقل التاريخ فارغ

✅ الحل:

أدخل تاريخ الفاتورة في الحقل
الصيغة الصحيحة: YYYY-MM-DD

❌ يجب إضافة بند واحد على الأقل / items array must have at least 1 item

السبب: لا توجد بنود في الفاتورة

✅ الحل:

انقر زر "إضافة بند جديد"
ملء بيانات البند (الوصف، الكمية، السعر)
أضف بند واحد على الأقل

📦

الخطأ #4: بيانات البنود غير صحيحة

أخطاء في حقول البنود (Quantity, Price, Tax)

▼

❌ الوصف مطلوب / items.*.description is required

السبب: حقل الوصف فارغ

✅ الحل:

أدخل وصف واضح للبند
مثال: "مواد البناء - رمل وحصى"

❌ الكمية مطلوبة وتكون > 0 / items.*.quantity must be numeric and >= 0.01

السبب: الكمية فارغة أو قيمتها 0

✅ الحل:

أدخل كمية صحيحة (أكبر من 0)
يمكن استخدام أرقام عشرية: 0.5, 1.25, إلخ

❌ سعر الوحدة مطلوب / items.*.unit_price is required

السبب: حقل السعر فارغ

✅ الحل:

أدخل سعر الوحدة
تأكد من أن السعر > 0

❌ نسبة الضريبة يجب أن تكون 0-100 / items.*.tax_rate must be numeric and between 0-100

السبب: نسبة ضريبة خاطئة

✅ الحل:

أدخل نسبة بين 0 و 100
مثال: 15 للضريبة 15%

💾

الخطأ #5: مشاكل قاعدة البيانات

أخطاء في العلاقات والقيود في قاعدة البيانات

▼

❌ SQLSTATE[23000]: Integrity constraint violation: 1452

السبب: معرف عميل أو عقد غير موجود

✅ الحل:

تأكد من وجود العميل في النظام
تأكد من وجود العقد إذا تم اختياره
ربما تم حذف العميل أو العقد

❌ SQLSTATE[HY000]: General error: 1364 Field 'xxx' doesn't have a default value

السبب: حقل مطلوب لم يتم ملؤه

✅ الحل:

تحقق من جميع الحقول المطلوبة
اتصل بمسؤول النظام

📚

الخطأ #6: مشاكل القيود اليومية

مشاكل في إنشاء القيود المحاسبية تلقائياً

▼

❌ لا توجد سنة مالية أو فترة محاسبية نشطة

السبب: لا توجد سنة مالية أو فترة محاسبية مفتوحة

✅ الحل:

اذهب إلى: الإعدادات → الحسابات → السنوات المالية
أنشئ سنة مالية جديدة بحالة "نشطة"
أنشئ فترة محاسبية بحالة "مفتوحة"

❌ العميل غير مرتبط بحساب في دليل الحسابات

السبب: العميل لا يملك حساب محاسبي

✅ الحل:

اذهب إلى: إدارة العملاء
افتح تفاصيل العميل
اختر حساب من دليل الحسابات
احفظ التغييرات

❌ حساب المبيعات غير موجود في دليل الحسابات

السبب: لا يوجد حساب برمز 4100

✅ الحل:

اذهب إلى: الإعدادات → الحسابات → دليل الحسابات
أنشئ حساب جديد برمز "4100"
اسم الحساب: "المبيعات"
نوع الحساب: revenue (إيراد)

❌ حساب الضريبة غير موجود في دليل الحسابات

السبب: لا يوجد حساب برمز 217001 أو 2170

✅ الحل:

اذهب إلى: الإعدادات → الحسابات → دليل الحسابات
أنشئ حساب جديد برمز "217001"
اسم الحساب: "ضريبة القيمة المضافة المحصلة"
نوع الحساب: liability (التزام)

🔴 تشخيص أخطاء حفظ فاتورة العملاء

⚡ الحل السريع

الخطأ #1: مشاكل المستخدم والشركة

الخطأ #2: مشاكل الصلاحيات

الخطأ #3: بيانات الفاتورة غير صحيحة

الخطأ #4: بيانات البنود غير صحيحة

الخطأ #5: مشاكل قاعدة البيانات

الخطأ #6: مشاكل القيود اليومية