@extends('layouts.app') @section('title', 'استيراد فواتير العملاء') @section('content')
{{-- Header --}}

استيراد فواتير العملاء

استيراد فواتير متعددة من ملف Excel بسهولة وأمان

العودة
{{-- Main Card --}}
{{-- Steps Section --}}

خطوات الاستيراد

{{-- Step 1 --}}
1

تنزيل القالب

انقر على الزر أدناه لتنزيل قالب Excel الجاهز

{{-- Step 2 --}}
2

ملء البيانات

أضف بيانات الفواتير والعملاء في الملف

{{-- Step 3 --}}
3

الاستيراد

احمّل الملف وتأكد من النتائج

{{-- Content --}}
{{-- Download Template Button --}}

الخطوة الأولى: تنزيل القالب

انقر على الزر التالي لتنزيل قالب Excel بصيغة صحيحة مع رؤوس الأعمدة المطلوبة:

تنزيل قالب الاستيراد
{{-- Upload Form --}}

الخطوة الثانية: رفع الملف

{{-- Import Errors (Data Validation Errors) --}} @if (session('import_has_errors') || session('import_partial_success'))

@if (session('import_partial_success')) ⚠️ تم استيراد بعض الفواتير بنجاح، لكن بعضها فشل @else ❌ فشل الاستيراد - توجد أخطاء في البيانات @endif

@if (session('import_partial_success'))

✅ تم استيراد {{ session('import_success_count') }} فاتورة بنجاح

@endif

الأخطاء المكتشفة:

@foreach (session('import_errors') ?? [] as $error)
{{ $error }}
@endforeach

💡 الحل:

  • تحقق من الأخطاء المذكورة أعلاه
  • صحح البيانات في ملف Excel
  • حاول الاستيراد مرة أخرى
@endif {{-- Validation Errors (File Upload Errors) --}} @if ($errors->any())

❌ خطأ في رفع الملف

    @foreach ($errors->all() as $error)
  • {{ $error }}
  • @endforeach
@endif {{-- Session Error --}} @if (session('error') && !session('import_has_errors') && !session('import_partial_success'))

حدث خطأ

{!! session('error') !!}

@endif {{-- Success Message --}} @if (session('success') && !session('import_partial_success'))

{!! session('success') !!}

@endif
@csrf {{-- File Input --}}
@error('file')

{{ $message }}

@enderror
{{-- Important Notes --}}

⚠️ ملاحظات مهمة:

  • تأكد من أن معرّفات العملاء والأصناف موجودة في النظام
  • الحقول المشار إليها بـ (*) إلزامية
  • صيغة التاريخ يجب أن تكون YYYY-MM-DD (مثال: 2025-12-25)
  • الكميات والأسعار يجب أن تكون أرقام موجبة
  • سيتم إنشاء قيود محاسبية تلقائية للفواتير المستوردة
  • جميع الفواتير المستوردة ستكون بحالة "مسودة" في البداية
{{-- Submit Button --}}
إلغاء
{{-- Template Preview --}}

معلومات عن صيغة الملف

اسم العمود نوع البيانات مثال ملاحظات
معرف العميل* رقم 1 المعرف الفريد للعميل في النظام
اسم العميل* نص شركة الرياض للمرجعية فقط
تاريخ الفاتورة* تاريخ 2025-12-25 YYYY-MM-DD
معرف الصنف* رقم 5 المعرف الفريد للصنف
اسم الصنف نص الخدمة الاستشارية للمرجعية فقط
الكمية* رقم 10 موجب فقط
سعر الوحدة* رقم عشري 100.50 موجب فقط
الخصم رقم عشري 50 اختياري - الخصم بالقيمة
الملاحظات نص ملاحظات مهمة اختياري
{{-- Tips Section --}}

نصائح لنجاح الاستيراد

  • ✓ استخدم القالب المرفق للتأكد من الصيغة الصحيحة
  • ✓ تحقق من وجود جميع معرّفات العملاء والأصناف قبل الاستيراد
  • ✓ لا تعدّل أسماء الأعمدة في القالب
  • ✓ تأكد من عدم وجود صفوف فارغة في الملف
  • ✓ يمكنك استيراد عدة فواتير لنفس العميل في ملف واحد
  • ✓ في حالة الخطأ، سيتم إظهار رسائل واضحة توضح السبب
@endsection