توثيق قارئ الفواتير بالذكاء الاصطناعي لأودو 19 Community
دليل قارئ الفواتير بالذكاء الاصطناعي: وصل الذكاء الاصطناعي، وقراءة فاتورة واحدة، ورفع عدة فواتير، وسجل القراءات، والخصوصية، والصلاحيات.
يشرح الإصدار 1.0.0حُدّث في 24 أكتوبر 2026
ابدأ من هنا
ببساطة: إدخال فواتير الموردين بطيء ومليء بالأخطاء الصغيرة. مع قارئ الفواتير بالذكاء الاصطناعي ترفق ملف PDF أو صورة الفاتورة وتضغط اقرأ بالذكاء الاصطناعي، فيُملأ المورد والرقم والتواريخ والعملة والبنود والضرائب عنك. أو أسقط عدة ملفات معًا: تُنشأ فاتورة مسودة وتُقرأ لكل ملف. تراجع الفاتورة ثم تعتمدها.
نصيحة: تبقى الفاتورة مسودة. الذكاء الاصطناعي يملأ، وأنت تراجع وتعتمد.
ماذا تحصل عليه
| الميزة | ما تفعله |
|---|---|
| اقرأ بالذكاء الاصطناعي | زر على فاتورة المورد المسودة يقرأ ملف PDF المرفق (نصه) أو الصورة ويملأ الفاتورة. |
| المورد | يُعثر عليه بالرقم الضريبي ثم بالاسم؛ وإن لم يوجد تُخبَر ويبقى الحقل فارغًا. |
| البنود والضرائب | وصف كل بند وكميته وسعره؛ والضريبة الشرائية المطابقة للنسبة في المستند. |
| التواريخ والعملة | تاريخ الفاتورة وتاريخ الاستحقاق والمرجع والعملة (إن كانت مفعّلة). |
| فحص الإجمالي | يُقارن إجمالي المستند بالفاتورة: ويُشار إلى أي فرق. |
| عدة فواتير معًا | المحاسبة ← الموردون ← اقرأ الفواتير بالذكاء الاصطناعي: اختر دفترًا وأضف الملفات؛ تُنشأ فاتورة مسودة لكل ملف. |
| لا شيء يُكتب فوقه | الفاتورة التي فيها بنود تحتفظ بها؛ والذكاء الاصطناعي يملأ ما هو فارغ فقط. |
| السجل | تُحفظ كل قراءة مع ما أعاده الذكاء الاصطناعي وما تعذّر ملؤه. |
| العربية | كل شيء مترجم ويعمل من اليمين إلى اليسار. |
المتطلبات
| البند | التفاصيل |
|---|---|
| أودو | 19.0 (Community أو Enterprise) |
| التطبيقات المطلوبة | الفوترة / المحاسبة (account) |
| موصّل الذكاء الاصطناعي | taqnix_ai_connector، مشمول في الحزمة |
| مزوّد ذكاء اصطناعي | حساب ومفتاح واجهة لدى خدمة متوافقة مع OpenAI أو لدى أنثروبيك، أو نموذج على خادمك. تدفع لمزوّدك مقابل ما تستخدمه. |
| الرخصة | OPL-1 (رخصة أودو الخاصة v1.0) |
التثبيت
- فُكّ ضغط الحزمة. بداخلها
taqnix_ai_connector.zipوtaqnix_ai_invoice_reader.zip؛ فُكّهما لتحصل على المجلدين. - انسخ المجلدين إلى أحد مجلدات
addons_pathفي خادم أودو وأعد تشغيله. - سجّل الدخول كمدير وفعّل وضع المطوّر ثم افتح التطبيقات واضغط تحديث قائمة التطبيقات.
- أزل مرشح «التطبيقات» وابحث عن AI Invoice Reader واضغط تثبيت. يُثبَّت موصّل الذكاء الاصطناعي معه.
# or from the command line ./odoo-bin -c odoo.conf -d YOUR_DATABASE -i taqnix_ai_invoice_reader --stop-after-init
صِل مزوّد الذكاء الاصطناعي
ببساطة: قبل أول استخدام يصل المسؤول أودو بنموذج ذكاء اصطناعي: الإعدادات ← الذكاء الاصطناعي ← المزوّدون ← جديد. اختر النوع (خدمة متوافقة مع OpenAI أو أنثروبيك) وعنوان الواجهة ومفتاح الواجهة واسم النموذج كما يكتبه مزوّدك، ثم اضغط اختبر الاتصال. ويعمل نموذج على خادمك أيضًا: اترك المفتاح فارغًا.
| الحقل | المعنى |
|---|---|
| النوع | متوافق مع OpenAI (إكمال المحادثة) أو أنثروبيك (واجهة الرسائل). |
| عنوان الواجهة | للخدمات المتوافقة مع OpenAI العنوان حتى /v1؛ ولأنثروبيك https://api.anthropic.com. |
| مفتاح الواجهة | يُحفظ في قاعدة البيانات؛ ولا يقرؤه إلا المسؤولون. |
| النموذج | اسم النموذج، مثلًا الذي يوصي به مزوّدك للنصوص. |
نصيحة: يرى أعضاء مجموعة يستطيع استخدام ميزات الذكاء الاصطناعي أزرار الذكاء الاصطناعي: ينالها كل المستخدمين الداخليين عند تثبيت الموصّل، ويستطيع المسؤول سحبها.
اقرأ فاتورة واحدة
ببساطة: أنشئ فاتورة مورد (أو افتح مسودة) وأرفق ملف PDF أو صورة مستند المورد في سجل المراسلات، واضغط اقرأ بالذكاء الاصطناعي في الشريط العلوي.
ببساطة: يُملأ المورد والمرجع والتواريخ والبنود والضرائب. وتخبرك رسالة هل وُجد كل شيء، أم ما لم يوجد (مورد غير موجود، أو ضريبة بلا نسبة مطابقة، أو إجمالي مختلف).
مهم: ملف PDF الذي هو مجرد مسح ضوئي لا نص فيه: أرفق بدلًا منه صورة الفاتورة. وتقرأ الصورةَ النموذجُ نفسه، فاختر نموذجًا يقرأ الصور.
اقرأ عدة فواتير معًا
ببساطة: افتح المحاسبة ← الموردون ← اقرأ الفواتير بالذكاء الاصطناعي واختر الدفتر وأضف الملفات (PDF وصور) واضغط أنشئ الفواتير واقرأها. تُنشأ فاتورة مسودة لكل ملف وتُقرأ. وإن تعذّرت قراءة ملف قُرئت الأخرى، وتُخبَر بأيها.
سجل القراءات
ببساطة: المحاسبة ← الموردون ← قراءات الذكاء الاصطناعي (لمديري المحاسبة) يسرد كل قراءة: المورد والرقم اللذين رآهما الذكاء الاصطناعي والإجمالي والفرق مع الفاتورة (مميّز حين يوجد) ومن أجراها. وتعرض الفاتورة المقروءة زر قراءات الذكاء الاصطناعي.
الخصوصية
ببساطة: استخدام نموذج ذكاء اصطناعي يعني إرسال نص إلى مزوّدك. تُرسل قراءة الفاتورة نص ملف PDF أو الصورة إلى مزوّدك: وفيه بيانات موردك. وقبل أن يغادر أي نص أودو تُخفى البريد الإلكتروني وأرقام الهاتف والآيبان والأرقام الطويلة (خيار على الشركة، مفعّل افتراضيًا). ويحتفظ سجل الاستخدام بالأرقام فقط (من، وأي ميزة، وكم رمزًا، والتكلفة التقديرية)، ولا يحتفظ بمحتوى الطلبات إلا إن فعّلت ذلك. وميزانية الرموز الشهرية توقف الميزات حين تُستنفد.
مهم: قد يخطئ الذكاء الاصطناعي. عامل ما يكتبه كمسودة: اقرأه قبل أن ترسله أو تحفظه أو تتصرف بناءً عليه.
من يفعل ماذا
| من | يستطيع |
|---|---|
| المحاسبون (الفوترة) في يستطيع استخدام ميزات الذكاء الاصطناعي | قراءة الفواتير بالذكاء الاصطناعي، ورفع عدة فواتير. |
| مديرو المحاسبة | رؤية قراءات الذكاء الاصطناعي. |
| مسؤولو الذكاء الاصطناعي | وصل الذكاء الاصطناعي ورؤية الاستخدام. |
| المستخدمون الآخرون | لا يرون أزرار الذكاء الاصطناعي. |
العربية ومن اليمين إلى اليسار
الحدود
| الحد | التفصيل |
|---|---|
| راجع قبل الاعتماد | قد يخطئ الذكاء الاصطناعي في قراءة رقم. يساعد فحص الإجمالي، لكن عليك النظر في الفاتورة. |
| المسح الضوئي | لا يُقرأ ملف PDF بلا نص: استخدم صورة. |
| المسودات فقط | لا تُغيَّر فاتورة معتمدة أبدًا. |
| البنود الموجودة | لا تُعدَّل فاتورة فيها بنود. |
| الضرائب | تُوجد الضريبة بنسبتها بين ضرائب الشراء لديك: وإن لم تطابق أي واحدة فلا ضريبة على البند. |
للمطورين
ببساطة: تخطَّ هذا الفصل إن كنت تستخدم الوحدة فقط.
bill = env['account.move'].browse(bill_id) # a draft vendor bill with a PDF or an image attached
bill.action_ai_read()
reading = env['taqnix.ai.invoice.reading'].search([('move_id', '=', bill.id)], limit=1)
reading.vendor_name, reading.invoice_number, reading.total, reading.differenceاستكشاف الأخطاء
| المشكلة | ما العمل |
|---|---|
| لا يوجد زر اقرأ بالذكاء الاصطناعي | الفاتورة ليست فاتورة مورد مسودة، أو لست في مجموعة يستطيع استخدام ميزات الذكاء الاصطناعي. |
| أرفق ملف PDF أو صورة الفاتورة أولًا | لا مرفق على الفاتورة. |
| ملف PDF بلا نص | هو مسح ضوئي: أرفق صورة. |
| المورد غير موجود | أنشئ المورد برقمه الضريبي؛ وستجده القراءة التالية. |
| الإجمالي مختلف | قارن البنود بالمستند وصحّحها. |
التحديث والإزالة
استبدل المجلد بالإصدار الجديد وأعد تشغيل أودو ونفّذ -u taqnix_ai_invoice_reader.
الدعم
المساعدة في التثبيت وإصلاح الأخطاء مشمولان لمدة 6 أشهر مع تحديثات مدى الحياة. تواصل معنا عبر صفحة السوق التي اشتريت منها الوحدة أو راسل support@taqnix.com مع إصدار أودو ولقطة شاشة.