توثيق استيراد كشف الحساب البنكي لأودو 19 Community
دليل استيراد كشف الحساب البنكي: الملف وأعمدته والفحص والمكررات وقواعد الاستيراد والكشوف والأرصدة وصلاحيات الوصول.
يشرح الإصدار 1.0.0حُدّث في 23 أكتوبر 2026
ابدأ من هنا
ببساطة: يعطيك المصرف ملفًا وتكتب أسطره في أودو. يُدخل استيراد كشف الحساب البنكي حركات ملف CSV أو إكسل أو OFX إلى يومية بنك في أودو Community: تُوجَد الأعمدة بعناوينها، وتُفحص كل حركة قبل إنشاء أي شيء، وتُتجاهل المستوردة سابقًا، ويُطابَق الشريك بالاسم، وتختار القواعد الحساب المقابل من البيان.
نصيحة: استورد الملف نفسه مرتين فلا يُضاف شيء مرتين: تعرف الوحدة ما استوردته من قبل.
ماذا تحصل عليه
| الميزة | ما تفعله |
|---|---|
| CSV وإكسل وOFX | ملفات .csv (فاصلة أو فاصلة منقوطة أو tab) و.xlsx و.xls و.ofx (و.qfx أيضًا). |
| أعمدة تُوجَد لك | بعناوينها، بالإنجليزية والعربية: التاريخ والبيان والمرجع والشريك والمبلغ، أو المدين والدائن. وتُهمل الأسطر قبل العناوين (رقم الحساب، الفترة). |
| أي صيغة تاريخ ورقم | 31/12/2026 و12/31/2026 و2026-12-31 و31 Dec 2026 وتواريخ إكسل؛ و1,250.50 و1.250,50 و(45.00) و45.00-. |
| فحص أولًا | كل حركة جديدة أو مكررة أو بخطأ، مع السبب؛ ومجاميع المال الداخل والخارج. |
| بلا تكرار | تُتجاهل الحركات الموجودة في اليومية، ولو استوردت ملفًا متداخلًا أو كانت مكتوبة يدويًا. |
| كشف حساب بنكي | اختياري: بالرصيد الافتتاحي والختامي، من ملف OFX أو من آخر كشف في اليومية. |
| الشركاء | يُطابَقون بالاسم حين يكون فريدًا. |
| قواعد الاستيراد | إذا احتوى البيان نصًا أو طابق تعبيرًا، حدد الشريك والحساب المقابل: فتُرحَّل الحركة إلى الحساب الصحيح فورًا. |
| الحركات البنكية | قائمة بحركات يوميات البنك مع الحساب المقابل (ليس في أودو Community مثلها). |
| العربية | كل شيء مترجم ويعمل من اليمين إلى اليسار. |
المتطلبات
| البند | التفاصيل |
|---|---|
| أودو | 19.0 (Community أو Enterprise) |
| التطبيقات المطلوبة | الفوترة (account) |
| الرخصة | OPL-1 (رخصة أودو الخاصة v1.0) |
التثبيت
- فُكّ ضغط الحزمة. بداخلها
taqnix_bank_statement_import.zip؛ فُكّه لتحصل على المجلدtaqnix_bank_statement_import. - انسخ المجلد إلى أحد مجلدات
addons_pathفي خادم أودو وأعد تشغيل أودو. - سجّل الدخول كمدير وفعّل وضع المطوّر ثم افتح التطبيقات واضغط تحديث قائمة التطبيقات.
- أزل مرشح «التطبيقات» وابحث عن Bank Statement Import (CSV, Excel, OFX) واضغط تثبيت.
# or from the command line ./odoo-bin -c odoo.conf -d YOUR_DATABASE -i taqnix_bank_statement_import --stop-after-init
استورد ملفًا
ببساطة: افتح يومية البنك (الفوترة ← الإعدادات ← اليوميات) وانقر استيراد، أو استخدم المحاسبة ← الحركات ← استيراد كشف حساب بنكي. اختر الملف ثم انقر اقرأ الملف.
| الخيار | المعنى |
|---|---|
| التواريخ | اكتشاف تلقائي، أو اليوم أولًا أو الشهر أولًا أو السنة أولًا لملف لا يمكن فيه التمييز. |
| اعكس إشارة المبالغ | لملف يكون فيه المال الخارج موجبًا. |
| تجاهل الحركات المستوردة سابقًا | مفعّل افتراضيًا. |
| طبّق قواعد الاستيراد | يحدد الشريك والحساب من قواعدك. |
| ابحث عن الشريك بالاسم | يبحث في جهات الاتصال عن الاسم الموجود في الملف. |
| أنشئ كشف حساب بنكي | يجمع الحركات في كشف بأرصدته. |
افحص ثم استورد
ببساطة: تظهر الأعمدة التي وُجدت: غيّر اسمًا إن لم يُعثر على عمود، وانقر اقرأ مجددًا. وتُعلَّم كل حركة جديدة أو مكررة (موجودة في اليومية) أو خطأ (تاريخ ليس تاريخًا، ومبلغ ليس رقمًا: ويُذكر صف الملف).
ببساطة: إذا صحّ كل شيء انقر استيراد. فتُفتح قائمة الحركات المستوردة.
أعمدة الملف
| العمود | العناوين المعروفة | ملاحظات |
|---|---|---|
| التاريخ | التاريخ، Date، Booking date، Value date | مطلوب. |
| المبلغ | المبلغ، Amount، Value | موجب للمال الداخل وسالب للخارج. |
| مدين، دائن | سحب، مدين، Withdrawal / إيداع، دائن، Deposit | تُستخدم إن لم يوجد عمود مبلغ: الدائن ناقص المدين. |
| البيان | البيان، الوصف، Description، Narrative، Memo | بيان الحركة. |
| المرجع | المرجع، Reference، Ref، رقم الشيك | يذهب إلى مرجع القيد. |
| الشريك | الاسم، المستفيد، Name، Payee | يُطابَق مع جهات الاتصال. |
نصيحة: إذا كانت عناوينك مختلفة، اكتب أسماءها في منطقة «أعمدة الملف» واقرأ الملف مجددًا.
قواعد الاستيراد
ببساطة: الفوترة ← الإعدادات ← المحاسبة ← قواعد استيراد البنك. تقول القاعدة: عندما يحتوي البيان (أو الشريك أو المرجع) / يبدأ بـ / يساوي / يطابق التعبير، حدد الشريك أو الحساب أو كليهما. وأول قاعدة تنطبق تفوز، حسب التسلسل.
| الحقل | المعنى |
|---|---|
| ابحث في | البيان، أو اسم الشريك، أو المرجع، أو أي منها. |
| حين | تحتوي، تبدأ بـ، تساوي، أو تطابق تعبيرًا نمطيًا. |
| الاتجاه | الداخل فقط، أو الخارج فقط، أو كلاهما. |
| اليوميات | حصر القاعدة في بعض يوميات البنك. |
| حدد الحساب | الطرف المقابل للحركة، بدل الحساب المعلّق. والحساب المدين أو الدائن يحتاج شريكًا. |
كيف تُعرف المكررات
| الملف | كيف |
|---|---|
| OFX | بمعرّف الحركة عند المصرف (FITID): فلا تُستورد حركة مرتين. |
| CSV وإكسل | بالتاريخ والمبلغ والبيان، بالعدّ: إن كان في الملف قهوتان بـ4.50 في اليوم نفسه وفي اليومية واحدة، فواحدة جديدة. وتُقارَن الحركات المكتوبة يدويًا أيضًا. |
نصيحة: لاستيراد كل شيء على أي حال، ألغِ «تجاهل الحركات المستوردة سابقًا».
الكشف وأرصدته
ببساطة: مع أنشئ كشف حساب بنكي تدخل الحركات في كشف يحمل اسم الملف. والرصيد الختامي هو رصيد ملف OFX، أو الرصيد الافتتاحي زائد الحركات؛ والرصيد الافتتاحي هو الرصيد الختامي لآخر كشف في اليومية. ويمكن تغييرهما قبل الاستيراد.
من يفعل ماذا
| من | يستطيع |
|---|---|
| المحاسبون | استيراد كشوف الحساب البنكية ورؤية القواعد. |
| مديرو الحسابات | وأيضًا إنشاء قواعد الاستيراد وتغييرها. |
| المستخدمون الآخرون | لا وصول. |
العربية ومن اليمين إلى اليسار
الحدود
| الحد | التفصيل |
|---|---|
| التسوية | ليس في أودو Community شاشة تسوية بنكية. تُرحَّل الحركات إلى الحساب المعلّق، أو إلى حساب قاعدة: وسوِّها بإجراءاتك. |
| عملة واحدة | المبالغ بعملة اليومية؛ ولا تُقرأ أعمدة العملات الأجنبية. |
| الصيغ | CSV وإكسل وOFX. ولا تُقرأ الصيغ الأخرى (MT940 وCAMT وQIF). |
| حتى 20000 صف | في الملف الواحد. |
| الورقة الأولى | تُقرأ الورقة الأولى فقط من ملف إكسل. |
للمطورين
ببساطة: تخطَّ هذا الفصل إن كنت تستخدم الوحدة فقط.
wizard = env['taqnix.bank.import'].create({'journal_id': journal.id, 'file': base64_content, 'filename': 'bank.csv'})
wizard.action_read()
wizard.line_ids.mapped('state')
wizard.action_import()استكشاف الأخطاء
| المشكلة | ما العمل |
|---|---|
| لم تُوجَد أعمدة الملف | يحتاج الصف الأول عمود «التاريخ» وعمود «المبلغ» (أو «مدين» و«دائن»): غيّر العناوين، أو اكتب أسماء الأعمدة. |
| التواريخ خاطئة (اليوم والشهر معكوسان) | اختر ترتيب التواريخ بدل «اكتشاف تلقائي». |
| إشارة المبالغ خاطئة | فعّل «اعكس إشارة المبالغ». |
| كل شيء مكرر | استُورد الملف من قبل؛ ألغِ «تجاهل الحركات المستوردة سابقًا» لاستيراده مجددًا. |
| لا أرى القائمة | تحتاج صلاحية المحاسب. |
التحديث والإزالة
استبدل المجلد بالإصدار الجديد وأعد تشغيل أودو ونفّذ -u taqnix_bank_statement_import.
الدعم
المساعدة في التثبيت وإصلاح الأخطاء مشمولان لمدة 6 أشهر مع تحديثات مدى الحياة. تواصل معنا عبر صفحة السوق التي اشتريت منها الوحدة أو راسل support@taqnix.com مع إصدار أودو ولقطة شاشة.