توثيق استيراد أسطر الطلبات من إكسل / CSV لأودو 19
دليل استيراد أسطر الطلبات: الملف وعناوينه والفحص والخيارات وأوامر البيع والشراء وصلاحيات الوصول.
يشرح الإصدار 1.0.0حُدّث في 23 أكتوبر 2026
ابدأ من هنا
ببساطة: يرسل عميل جدولًا بـ150 صنفًا فتكتبها واحدًا واحدًا. يضيف استيراد أسطر الطلبات من إكسل / CSV أسطر عرض سعر أو أمر بيع أو أمر شراء من ملف: المنتجات بالمرجع أو الباركود أو الاسم، والكمية، والسعر والخصم والوصف والوحدة إن وُجدت في الملف. ويُفحص كل صف قبل إضافة أي شيء، فترى الأخطاء أولًا.
نصيحة: بخلاف الاستيراد القياسي في أودو، لا تربط أعمدة ولا تنشئ الطلب بالملف: تفتح الطلب الذي عندك وتضيف إليه أسطرًا، بأسعار أودو وضرائبه.
ماذا تحصل عليه
| الميزة | ما تفعله |
|---|---|
| إكسل وCSV | ملفات .xlsx و.xls و.csv (فاصلة أو فاصلة منقوطة أو tab؛ UTF-8). |
| المبيعات والمشتريات | زر على عروض الأسعار وعلى أوامر الشراء المسودة. |
| يُعثر على المنتجات بـ | المرجع الداخلي أو الباركود أو الاسم؛ وفي أمر الشراء رمز منتج المورّد أيضًا. |
| العناوين المعروفة | بالإنجليزية والعربية، بأي ترتيب للأعمدة: المرجع الداخلي، الباركود، المنتج، الكمية، سعر الوحدة، الخصم، الوصف، الوحدة. |
| سعر أودو | إن لم يكن في الملف سعر، يأخذ السطر سعر قائمة الأسعار (المبيعات) أو سعر المورّد (المشتريات). |
| فحص أولًا | كل صف جاهز أو تحذير أو خطأ، مع السبب: المنتج غير موجود أو ملتبس، كمية أو سعر أو خصم أو وحدة غير صالحة. |
| اختيارك | استورد الصفوف الصحيحة فقط، أو لا شيء إذا كان في صف خطأ. ومنتج موجود على الطلب: سطر جديد، أو كمية أكثر، أو تجاهل. |
| قالب | نزّل ملف إكسل بالعناوين الصحيحة. |
| السجل | يُسجَّل الاستيراد على الطلب: كم سطرًا ومن أي ملف. |
| العربية | كل شيء مترجم ويعمل من اليمين إلى اليسار. |
المتطلبات
| البند | التفاصيل |
|---|---|
| أودو | 19.0 (Community أو Enterprise) |
| التطبيقات المطلوبة | المبيعات (sale) والمشتريات (purchase) |
| الرخصة | OPL-1 (رخصة أودو الخاصة v1.0) |
التثبيت
- فُكّ ضغط الحزمة. بداخلها
taqnix_import_order_lines.zip؛ فُكّه لتحصل على المجلدtaqnix_import_order_lines. - انسخ المجلد إلى أحد مجلدات
addons_pathفي خادم أودو وأعد تشغيل أودو. - سجّل الدخول كمدير وفعّل وضع المطوّر ثم افتح التطبيقات واضغط تحديث قائمة التطبيقات.
- أزل مرشح «التطبيقات» وابحث عن Import Order Lines from Excel / CSV واضغط تثبيت.
# or from the command line ./odoo-bin -c odoo.conf -d YOUR_DATABASE -i taqnix_import_order_lines --stop-after-init
جهّز الملف
ببساطة: الصف الأول للعناوين؛ وكل صف بعده سطر. ويكفي المنتج والكمية.
| العمود | العناوين المقبولة | المحتوى |
|---|---|---|
| المنتج | المرجع الداخلي، المرجع، SKU، الكود / الباركود، EAN / المنتج، الصنف | مرجع المنتج أو باركوده أو اسمه. لا يهم حجم الأحرف، وتُهمل المسافات حوله. |
| الكمية | الكمية، Qty | رقم أكبر من صفر. ويُفهم 1,250.50 و3,5. |
| السعر | سعر الوحدة، السعر | اختياري. إذا ترك فارغًا: سعر أودو. |
| الخصم | الخصم، Disc | اختياري، من 0 إلى 100. |
| الوصف | الوصف، البيان، الاسم | اختياري. يحل محل وصف المنتج على السطر. |
| الوحدة | الوحدة، UoM | اختياري، اسم وحدة من عائلة وحدة المنتج (وحدات، دزينة...). |
نصيحة: انقر نزّل القالب في المعالج لملف جاهز. والعناوين العربية (الكمية، الباركود، السعر...) تعمل أيضًا.
استورد الأسطر
ببساطة: افتح عرض سعر (أو أمر شراء مسودة) وانقر استيراد الأسطر. اختر الملف ثم انقر افحص الملف.
| الخيار | المعنى |
|---|---|
| إذا كان المنتج على الطلب أصلًا | أضف سطرًا جديدًا، أو أضف إلى كمية السطر الموجود، أو تجاهل الصف. |
| إذا كان في صف خطأ | استورد الصفوف الصحيحة وتجاهل الباقي، أو لا تستورد شيئًا. |
ببساطة: إذا صحّت القائمة انقر استورد الأسطر. وصحّح الملف وافحص مجددًا إن شئت.
كيف يُفحص الصف
| النتيجة | متى |
|---|---|
| جاهز | المنتج موجود، والكمية والسعر والخصم والوحدة صالحة. |
| تحذير | المنتج موجود لكن لا يمكن بيعه (أو شراؤه): ويُستورد السطر مع ذلك. |
| خطأ | لا منتج يطابق؛ أو عدة منتجات تطابق (استخدم المرجع أو الباركود)؛ أو الكمية صفر أو سالبة أو ليست رقمًا؛ أو السعر أو الخصم غير صالح؛ أو الوحدة لا تناسب المنتج. |
ببساطة: أرقام الصفوف هي أرقام الملف، فتجد الصف في جدولك.
من يفعل ماذا
| من | يستطيع |
|---|---|
| موظفو المبيعات ومستخدمو المشتريات | استيراد أسطر إلى الطلبات التي يستطيعون تعديلها. |
| المستخدمون الآخرون | لا يظهر الزر على الطلب، وتمنع صلاحيات أودو إضافة الأسطر. |
العربية ومن اليمين إلى اليسار
الحدود
| الحد | التفصيل |
|---|---|
| الطلبات المسودة فقط | عروض الأسعار وأوامر الشراء المسودة: لا الطلبات المؤكدة. |
| حتى 5000 صف | في الملف الواحد. |
| الورقة الأولى | تُقرأ الورقة الأولى فقط من ملف إكسل. |
| الأسطر فقط | لا يُنشأ الطلب نفسه (العميل والتواريخ) من الملف. |
| بلا كومبو | لا تُستورد المنتجات المركّبة. |
للمطورين
ببساطة: تخطَّ هذا الفصل إن كنت تستخدم الوحدة فقط.
wizard = env['taqnix.order.import'].create({'res_model': 'sale.order', 'res_id': order.id, 'file': base64_content, 'filename': 'lines.xlsx', 'duplicates': 'add'})
wizard.action_check()
wizard.line_ids.mapped('message')
wizard.action_import()استكشاف الأخطاء
| المشكلة | ما العمل |
|---|---|
| يحتاج الملف عمودًا يحدد المنتج | سمِّ العمود المرجع الداخلي أو الباركود أو المنتج في الصف الأول. |
| لا منتج يطابق | تحقق من المرجع؛ لا يهم الفراغات والأحرف الكبيرة؛ وأمر الشراء يقبل رمز المورّد أيضًا. |
| عدة منتجات اسمها... | استخدم المرجع أو الباركود بدل الاسم. |
| الوحدة لا تناسب هذا المنتج | استخدم وحدة من عائلة وحدة المنتج، وأن تكون مفعّلة. |
| زر استيراد الأسطر غير موجود | يظهر على عروض الأسعار وأوامر الشراء المسودة فقط. |
التحديث والإزالة
استبدل المجلد بالإصدار الجديد وأعد تشغيل أودو ونفّذ -u taqnix_import_order_lines.
الدعم
المساعدة في التثبيت وإصلاح الأخطاء مشمولان لمدة 6 أشهر مع تحديثات مدى الحياة. تواصل معنا عبر صفحة السوق التي اشتريت منها الوحدة أو راسل support@taqnix.com مع إصدار أودو ولقطة شاشة.