توثيق استيراد المخزون من Excel / CSV لأودو 19 Community
دليل الاستيراد: الملف والخيارات والفحص والتسويات والسجل والحدود.
يشرح الإصدار 1.0.0حُدّث في 23 أكتوبر 2026
ابدأ من هنا
ببساطة: جرد المستودع الرفوف وأرسل جدول بيانات. إدخال 400 كمية في الجرد الفعلي واحدة واحدة بطيء، وخطأ مطبعي يحرّك مخزونك. استيراد المخزون يحمّل الجدول في أودو Community: يجد كل منتج بالمرجع أو الباركود أو الاسم، ويفحص كل صف أولًا (مع الكمية المتوفرة والفرق)، ثم يطبّق التسويات، مع سجل لما فعله كل ملف.
نصيحة: لا يتحرك شيء حتى تنقر «استيراد»: الفحص يُظهر كل صف جاهزًا أو بتحذير أو بخطأ، مع السبب.
ماذا تحصل عليه
| الميزة | ما تفعله |
|---|---|
| Excel وCSV | ملفات .xlsx و.xls و.csv؛ العناوين بالإنجليزية أو العربية، وبأي ترتيب للأعمدة. |
| إيجاد المنتج | بالمرجع الداخلي أو الباركود أو الاسم؛ وتُبلَّغ عن التطابقات المتعددة ولا تُخمَّن. |
| المواقع | عمود الموقع (الاسم أو الاسم الكامل) مع موقع افتراضي للصفوف التي بلا موقع. |
| الدفعات والأرقام التسلسلية | تُستخدم الموجودة؛ ويمكن إنشاء الناقصة. والرقم التسلسلي يأخذ الكمية 0 أو 1. |
| وضعان | تحديد الكمية المعدودة (جرد فعلي) أو الإضافة إلى الكمية المتوفرة (استلام أو تصحيح). |
| الفحص | المتوفر وكمية الملف والكمية الجديدة والفرق لكل صف، مع رسالة لكل مشكلة. |
| طبّق أو سجّل الجرد فقط | طبّق التسويات الآن، أو سجّل الجرد فقط لتراجعه في الجرد الفعلي. |
| السجل | يُحفظ كل ملف بصفوفه ومن استورده وحركات المخزون التي أنشأها. |
| القالب | قالب Excel جاهز للتعبئة للتنزيل. |
| العربية | كل شيء مترجم ويعمل من اليمين إلى اليسار. |
المتطلبات
| البند | التفاصيل |
|---|---|
| أودو | 19.0 (Community أو Enterprise) |
| التطبيقات المطلوبة | المخزون (stock) |
| الرخصة | OPL-1 (رخصة أودو الخاصة v1.0) |
التثبيت
- فُكّ ضغط الحزمة. بداخلها
taqnix_inventory_import.zip؛ فُكّه لتحصل على المجلدtaqnix_inventory_import. - انسخ المجلد إلى أحد مجلدات
addons_pathفي خادم أودو وأعد تشغيل أودو. - سجّل الدخول كمدير وفعّل وضع المطوّر ثم افتح التطبيقات واضغط تحديث قائمة التطبيقات.
- أزل مرشح «التطبيقات» وابحث عن Inventory Import واضغط تثبيت.
# or from the command line ./odoo-bin -c odoo.conf -d YOUR_DATABASE -i taqnix_inventory_import --stop-after-init
جهّز الملف
ببساطة: صف عناوين وصف لكل منتج (وموقع، ودفعة). المطلوب شيئان فقط: عمود يحدد المنتج وعمود الكمية.
| العمود (أي من هذه الأسماء) | المعنى |
|---|---|
| المرجع الداخلي، SKU، الكود | مرجع المنتج. |
| الباركود، EAN | باركود المنتج. |
| المنتج، الصنف | اسم المنتج. |
| الكمية، الكمية المعدودة، Qty | الكمية (مطلوبة). |
| الموقع | اسم الموقع أو اسمه الكامل، مثل WH/Stock/Shelf A. اختياري. |
| الدفعة، الرقم التسلسلي | الدفعة أو الرقم التسلسلي، للمنتجات المتتبَّعة. |
نصيحة: انقر «نزّل القالب» في استيراد جديد للحصول على ملف بالعناوين الصحيحة.
الاستيراد
ببساطة: افتح المخزون ← العمليات ← التسويات ← استيراد المخزون وانقر جديد. اختر الملف والموقع الافتراضي والوضع، ثم افحص الملف.
| الخيار | المعنى |
|---|---|
| حدّد الكمية المعدودة | كمية الملف هي الكمية المتوفرة الجديدة (جرد فعلي). |
| أضف إلى الكمية المتوفرة | تُضاف الكمية إلى المخزون؛ والكمية السالبة تُخرج مخزونًا. |
| طبّق التسويات الآن | ألغِ تحديده لتسجيل الجرد فقط ومراجعته في الجرد الفعلي. |
| أنشئ الدفعات الناقصة | تُنشأ الدفعة أو الرقم التسلسلي غير الموجود. |
| إذا كان في صف خطأ | استورد الصفوف الصالحة وتخطَّ الباقي، أو لا تستورد شيئًا. |
اقرأ الفحص
| الحالة | المعنى |
|---|---|
| جاهز | الصف سليم. |
| تحذير | سيُستورد مع ملاحظة: دفعة ستُنشأ، أو دفعة تُتجاهل لمنتج بلا تتبع، أو منتج يتكرر (تُجمع الكميات). |
| خطأ | سيُتخطى: منتج أو موقع مجهول، أو كمية ليست رقمًا، أو جرد سالب، أو دفعة ناقصة، أو رقم تسلسلي بكمية غير 0 أو 1، أو منتج لا يتتبع مخزونه. |
ببساطة: المتوفر هو الكمية الحالية، والكمية الجديدة هي ما سيصير إليه المخزون، والفرق هو التسوية. صحّح الملف وانقر افحص ثانية كم تشاء.
التطبيق
ببساطة: استيراد ينشئ تسويات المخزون: كل منتج تغيّر تُنشأ له حركة مخزون باسم الاستيراد، وتُترك الصفوف المطابقة أصلًا. ثم يصير الاستيراد مستوردًا، ويسرد زر حركات المخزون ما فعله.
نصيحة: مع إلغاء «طبّق التسويات الآن» تُسجَّل الكميات كجرد فقط: افتح المخزون ← العمليات ← الجرد الفعلي لمراجعتها وتطبيقها.
السجل
ببساطة: يبقى كل استيراد في القائمة مع ملفه وعدد الصفوف والمنتجات التي تغيّرت ومن فعل ذلك. لا يُحذف استيراد مطبَّق: هو تاريخ مخزونك.
من يفعل ماذا
| من | يستطيع |
|---|---|
| مديرو المخزون | الاستيراد والفحص والتطبيق. |
| المستخدمون الآخرون | لا وصول: تغيير كميات المخزون بالجملة لمديري المخزون. |
العربية ومن اليمين إلى اليسار
الحدود
| الحد | التفصيل |
|---|---|
| ورقة واحدة | تُقرأ الورقة الأولى فقط من ملف Excel. |
| الحجم | حتى 10٬000 صف في الملف. |
| الطرود والمالكون | غير مدعومين: الكميات على المنتجات والمواقع والدفعات. |
| بقية منتجات الموقع | تُترك كما هي: تتغير صفوف الملف فقط. |
| التكلفة | تستخدم التسويات تكلفة المنتج. |
للمطورين
ببساطة: تخطَّ هذا الفصل إن كنت تستخدم الوحدة فقط.
imp = env['taqnix.inventory.import'].create({'file': base64.b64encode(csv_bytes), 'filename': 'count.csv',
'location_id': stock.id, 'mode': 'set', 'apply': True})
imp.action_check()
imp.action_import()
imp.state, imp.changed_countاستكشاف الأخطاء
| المشكلة | ما العمل |
|---|---|
| يحتاج الملف عمودًا يحدد المنتج | أضف عنوانًا مثل المرجع الداخلي أو الباركود أو المنتج. |
| هذا المنتج لا يتتبع مخزونه | فعّل «تتبع المخزون» على المنتج. |
| الصف يحتاج دفعة | المنتج يُتتبَّع بالدفعة أو الرقم التسلسلي: املأ عمود الدفعة. |
| لا يوجد موقع داخلي يطابق | اكتب الموقع كما هو في أودو، مثل WH/Stock/Shelf A. |
| لم يتحرك شيء | الصفوف تطابق الكمية المتوفرة أصلًا: دون تغيير. |
التحديث والإزالة
استبدل المجلد بالإصدار الجديد وأعد تشغيل أودو ونفّذ -u taqnix_inventory_import.
الدعم
المساعدة في التثبيت وإصلاح الأخطاء مشمولان لمدة 6 أشهر مع تحديثات مدى الحياة. تواصل معنا عبر صفحة السوق التي اشتريت منها الوحدة أو راسل support@taqnix.com مع إصدار أودو ولقطة شاشة.