توثيق استيراد قيود اليومية من Excel / CSV لأودو 19 Community
دليل الاستيراد: الملف والخيارات والفحص والقيود والتراجع والحدود.
يشرح الإصدار 1.0.0حُدّث في 23 أكتوبر 2026
ابدأ من هنا
ببساطة: إقفال نهاية الشهر في جدول بيانات: الرواتب والإيجار والإهلاك والمستحقات، أربعون قيدًا. إعادة كتابتها بطيء، ورقم خاطئ واحد يوازن الدفتر بشكل خاطئ. استيراد قيود اليومية يحمّلها في أودو Community: يجمع الصفوف في قيود، ويفحص توازن كل قيد (وكل حساب وشريك وتاريخ وفترة)، وينشئ السليمة مسودات للمراجعة أو مرحَّلة، مع سجل وتراجع.
نصيحة: القيد الذي فيه مشكلة يُترك كله، مع السبب على كل صف من صفوفه.
ماذا تحصل عليه
| الميزة | ما تفعله |
|---|---|
| Excel وCSV | .xlsx و.xls و.csv؛ العناوين بالإنجليزية أو العربية، وبأي ترتيب للأعمدة. |
| قيود من صفوف | الصفوف ذات رقم القيد نفسه تصنع قيدًا (أو التاريخ والمرجع نفسهما إن لم يوجد عمود القيد). |
| الحسابات والشركاء | الحسابات بالرمز أو الاسم، والشركاء بالاسم أو المرجع (ويمكن إنشاؤهم)، والحسابات التحليلية بالاسم. |
| فحص التوازن | يُنبَّه إلى القيد غير المتوازن أو ذي الصف الواحد أو المختلط التواريخ أو اليوميات أو الواقع في فترة مقفلة. |
| مسودة أو مرحَّل | أنشئ القيود مسودات للمراجعة، أو رحّلها فورًا. |
| التواريخ | تواريخ ISO أو تواريخ Excel أو تواريخ بدءًا باليوم أو الشهر مثل 03/04/2026 (تختار). |
| السجل والتراجع | يُحفظ كل استيراد مع قيوده؛ والتراجع يحذفها (وتُعاد المرحَّلة إلى مسودة أولًا). |
| القالب | قالب Excel جاهز للتعبئة للتنزيل. |
| العربية | كل شيء مترجم ويعمل من اليمين إلى اليسار. |
المتطلبات
| البند | التفاصيل |
|---|---|
| أودو | 19.0 (Community أو Enterprise) |
| التطبيقات المطلوبة | الفوترة (account) |
| الرخصة | OPL-1 (رخصة أودو الخاصة v1.0) |
التثبيت
- فُكّ ضغط الحزمة. بداخلها
taqnix_journal_import.zip؛ فُكّه لتحصل على المجلدtaqnix_journal_import. - انسخ المجلد إلى أحد مجلدات
addons_pathفي خادم أودو وأعد تشغيل أودو. - سجّل الدخول كمدير وفعّل وضع المطوّر ثم افتح التطبيقات واضغط تحديث قائمة التطبيقات.
- أزل مرشح «التطبيقات» وابحث عن Journal Entries Import واضغط تثبيت.
# or from the command line ./odoo-bin -c odoo.conf -d YOUR_DATABASE -i taqnix_journal_import --stop-after-init
جهّز الملف
ببساطة: صف عناوين وصف لكل سطر يومية. أربعة أشياء مطلوبة: التاريخ والحساب ومدين ودائن.
| العمود (أي من هذه الأسماء) | المعنى |
|---|---|
| التاريخ | تاريخ القيد المحاسبي. يجب أن يكون لكل صفوف القيد التاريخ نفسه. |
| القيد، الرقم، السند | يجمع الصفوف في قيود. وبدونه يجمعها التاريخ والمرجع. |
| المرجع | مرجع القيد. وإن غاب يُستخدم رقم القيد. |
| الحساب، رمز الحساب | رمز الحساب أو اسمه (مطلوب). |
| الشريك | اسم الشريك أو مرجعه. اختياري. |
| البيان، الوصف | بيان السطر. |
| مدين، دائن | المبالغ. للصف أحدهما. |
| الحساب التحليلي | اسم حساب تحليلي، 100% على السطر. اختياري. |
| اليومية | رمز اليومية أو اسمها، للقيود التي ليست في اليومية الافتراضية. اختياري. |
نصيحة: انقر «نزّل القالب» في استيراد جديد للحصول على ملف بالعناوين الصحيحة ومثال متوازن.
الاستيراد
ببساطة: افتح المحاسبة ← المحاسبة ← المعاملات ← استيراد القيود وانقر جديد. اختر الملف واليومية والخيارات، ثم افحص الملف.
| الخيار | المعنى |
|---|---|
| اليومية | تُستخدم للقيود التي بلا يومية في الملف. |
| التواريخ يومًا أولًا | لـ 03/04/2026: التحديد يقرؤها 3 أبريل، وعدمه 4 مارس. وتواريخ ISO واضحة دائمًا. |
| رحّل القيود | ألغِ التحديد لإنشاء مسودات تراجعها أولًا. |
| أنشئ الشركاء الناقصين | يُنشأ الشريك غير الموجود. |
| إذا كان في قيد خطأ | استورد القيود الصالحة وتخطَّ الباقي، أو لا تستورد شيئًا. |
اقرأ الفحص
| الرسالة | المعنى |
|---|---|
| القيد غير متوازن بمقدار X | يختلف مدين القيد ودائنه. |
| يحتاج القيد إلى صفين على الأقل | لا يكون الصف الواحد قيدًا. |
| يجب أن يكون لصفوف القيد التاريخ / اليومية نفسها | تختلف صفوف رقم القيد نفسه. |
| الفترة مقفلة حتى X | يقع التاريخ قبل تاريخ إقفال للشركة. |
| لا يوجد حساب / شريك / يومية تطابق | القيمة ليست في أودو: صحّح الملف. |
| في صف آخر من هذا القيد خطأ | يُتخطى القيد كله، فتُظهر صفوفه الأخرى ذلك أيضًا. |
ببساطة: صحّح الملف وانقر افحص ثانية كم تشاء: لا يُنشأ شيء حتى تنقر استيراد.
أنشئ القيود
ببساطة: استيراد ينشئ قيد يومية لكل قيد صالح في الملف، مرتبطًا بالاستيراد: افتح زر القيود، أو انظر حقل استورده في القيد نفسه.
التراجع
ببساطة: ألغِ الاستيراد يحذف قيوده: تُحذف المسودات، وتُعاد المرحَّلة إلى مسودة أولًا. إن كانت فترة مقفلة أو تعذّر تغيير قيد فلا يُحذف شيء ويظهر السبب.
من يفعل ماذا
| من | يستطيع |
|---|---|
| المحاسبون | الاستيراد والفحص والتطبيق والتراجع. |
| المستخدمون الآخرون | لا وصول. |
العربية ومن اليمين إلى اليسار
الحدود
| الحد | التفصيل |
|---|---|
| عملة الشركة | المبالغ بعملة الشركة. |
| الضرائب | تُستورد القيود كما هي، بلا أسطر ضريبة أو شبكات ضريبية. |
| الأرصدة الافتتاحية بالفاتورة | سوِّ البنود المفتوحة بعد ذلك؛ ينشئ الاستيراد قيود يومية عادية. |
| ورقة واحدة و10٬000 صف | تُقرأ الورقة الأولى فقط، حتى 10٬000 صف في الملف. |
للمطورين
ببساطة: تخطَّ هذا الفصل إن كنت تستخدم الوحدة فقط.
imp = env['taqnix.journal.import'].create({'file': base64.b64encode(csv_bytes), 'filename': 'closing.csv',
'journal_id': misc.id, 'post': False})
imp.action_check()
imp.action_import()
imp.move_ids
imp.action_undo()استكشاف الأخطاء
| المشكلة | ما العمل |
|---|---|
| يحتاج الملف عمود التاريخ | أضف العناوين الأربعة المطلوبة: التاريخ والحساب ومدين ودائن. |
| التاريخ غير صالح | استخدم 2026-03-31 أو تاريخ Excel، أو اختر اليوم أولًا أو الشهر أولًا. |
| القيد غير متوازن | اجمع مدين ودائن رقم القيد. |
| تعذّرت إزالة القيود | فترة مقفلة: افتحها، أو اعكس القيود يدويًا. |
التحديث والإزالة
استبدل المجلد بالإصدار الجديد وأعد تشغيل أودو ونفّذ -u taqnix_journal_import.
الدعم
المساعدة في التثبيت وإصلاح الأخطاء مشمولان لمدة 6 أشهر مع تحديثات مدى الحياة. تواصل معنا عبر صفحة السوق التي اشتريت منها الوحدة أو راسل support@taqnix.com مع إصدار أودو ولقطة شاشة.