> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ofatoura.com/llms.txt
> Use this file to discover all available pages before exploring further.

# استيراد عناصر القائمة بشكل مجمّع

> استورد عدداً كبيراً من عناصر القائمة دفعةً واحدة من ملف CSV أو Excel عبر لوحة الإدارة في oFatoura، مع إنشاء تلقائي للتصنيفات والقوائم، ومعاينة أولية، والتحقق من صحة كل صف.

عند إعداد فرع جديد أو إضافة دفعة كبيرة من الأطباق، يمكنك استيراد عناصر القائمة دفعةً واحدة من ملف CSV أو Excel بدلاً من إضافتها يداً واحدةً. تُنشئ oFatoura أي تصنيفات وقوائم غير موجودة بشكل تلقائي، وتتحقق من الملف قبل حفظ أي شيء، وتُظهر لك بدقة أي الصفوف نجح استيرادها وأيها لم ينجح.

يتم ذلك عبر لوحة الإدارة على المتصفح.

<Note>
  **الصلاحيات:** تحتاج إلى صلاحية **Create Menu Item** (إنشاء عنصر قائمة) لتشغيل الاستيراد المجمّع.
</Note>

## قبل أن تبدأ

* تأكد من جاهزية بياناتك في ملف **CSV أو XLSX أو XLS**.
* يجب ألا يتجاوز حجم الملف **10 ميغابايت**.
* يمكنك إجراء **عملية استيراد واحدة في الدقيقة** — إذا حاولت مرة أخرى قبل مرور الوقت الكافي، انتظر لحظة قبل إعادة المحاولة.

<Tip>
  نزّل النموذج التجريبي أولاً (انظر أدناه) واملأه ببياناتك. فهو يحتوي مسبقاً على عناوين الأعمدة الصحيحة، مما يتيح لك تجنب أخطاء التعيين.
</Tip>

## الأعمدة الإلزامية والاختيارية

يحتاج ملفك إلى هذه الأعمدة الأربعة لكل عنصر:

| العمود          | ما يحتويه                                          |
| --------------- | -------------------------------------------------- |
| `item_name`     | اسم الطبق أو المنتج                                |
| `category_name` | التصنيف الذي ينتمي إليه (مثل: المقبلات، المشروبات) |
| `menu_name`     | القائمة التي ينتمي إليها                           |
| `price`         | سعر العنصر                                         |

هذه الأعمدة اختيارية ويمكن تركها فارغة:

| العمود                  | ما يحتويه                                                   |
| ----------------------- | ----------------------------------------------------------- |
| `description`           | وصف مختصر للعنصر                                            |
| `type`                  | `veg` (نباتي) أو `non-veg` (غير نباتي) أو `egg` (يحتوي بيض) |
| `show_on_customer_site` | ما إذا كان العنصر يظهر على موقع الطلب الإلكتروني            |

<Info>
  إذا كان `category_name` أو `menu_name` في ملفك غير موجود بعد، فإن oFatoura **تُنشئه تلقائياً** أثناء الاستيراد. لا تحتاج إلى إعداد التصنيفات والقوائم مسبقاً.
</Info>

## استيراد عناصرك

<Steps>
  <Step title="فتح Bulk Upload (الاستيراد المجمّع)">
    في الشريط الجانبي، انتقل إلى **Menu > Menu Items** (القائمة > عناصر القائمة)، ثم افتح **Bulk Upload**.
  </Step>

  <Step title="تنزيل النموذج التجريبي">
    استخدم خيار **Download sample template** (تنزيل النموذج التجريبي) للحصول على ملف بدء بتنسيق صحيح، ثم أدخل بياناتك فيه.
  </Step>

  <Step title="اختيار ملفك">
    اختر ملف CSV أو Excel الذي أعددته (لا يتجاوز 10 ميغابايت). ستظهر لك نسبة تقدم الرفع أثناء قراءة الملف.
  </Step>

  <Step title="اختيار مطبخ">
    إذا كان فرعك يضم **أكثر من محطة مطبخ واحدة**، فاختر المطبخ الذي ينبغي إرسال هذه العناصر إليه. إذا كان هناك مطبخ واحد فقط، فلن تظهر هذه الخطوة.
  </Step>

  <Step title="المعاينة والمراجعة">
    تعرض oFatoura **معاينة** لملفك وتتحقق من البيانات. تُدرج أي مشكلات على شكل **أخطاء لكل صف** حتى تتمكن من معرفة السطور التي تحتاج إلى تصحيح بدقة.
  </Step>

  <Step title="بدء الاستيراد">
    بمجرد أن تبدو البيانات صحيحة، ابدأ الاستيراد. ستُنشئ oFatoura العناصر، إلى جانب أي تصنيفات وقوائم مفقودة.
  </Step>

  <Step title="تنزيل النتائج">
    بعد اكتمال الاستيراد، نزّل **تقرير النتائج** للتأكد مما تم استيراده ومراجعة أي عناصر تم تخطيها.
  </Step>
</Steps>

## تصحيح أخطاء التحقق

قبل الحفظ، تتحقق oFatoura من أمان الملف وصحة بيانات كل صف واكتمالها. إذا كان صف يفتقر إلى قيمة إلزامية أو يحتوي على قيمة غير صالحة (مثلاً قيمة `type` ليست `veg` أو `non-veg` أو `egg`)، يُوضَع عليه علامة خطأ خاصة بذلك الصف.

<Warning>
  صحّح الصفوف التي تحمل علامات الخطأ في ملفك المصدري ثم ارفعه مجدداً. تذكر حد **عملية استيراد واحدة في الدقيقة** — إذا كنت قد أجريت استيراداً للتو، انتظر قبل إعادة المحاولة.
</Warning>

## ذات صلة

<Columns cols={2}>
  <Card title="إضافة عناصر القائمة وتعديلها" icon="utensils" href="/ar/menu/menu-items">
    أضف أو اضبط العناصر الفردية بعد الاستيراد.
  </Card>

  <Card title="إنشاء القوائم وتصنيفات العناصر" icon="folder-tree" href="/ar/menu/menus-and-categories">
    راجع القوائم والتصنيفات التي تم إنشاؤها أثناء الاستيراد.
  </Card>

  <Card title="تعيين عناصر القائمة إلى المطابخ" icon="chef-hat" href="/ar/kitchen/routing-items">
    تحكم في محطة المطبخ التي تُعدّ كل عنصر.
  </Card>

  <Card title="ترتيب عناصر القائمة والتصنيفات" icon="arrow-down-up" href="/ar/menu/sorting-items">
    رتّب الترتيب الذي تظهر به العناصر.
  </Card>
</Columns>