تخطي للذهاب إلى المحتوى

Odoo 19: المبالغ غير المسددة في بوابة العملاء مع تاريخ مرجعي وتصدير بصيغة PDF – وحدة portal_open_items

5 نوفمبر 2026 | Odoo 19 Community | تطوير داخلي
5 نوفمبر 2026 بواسطة
Odoo 19: المبالغ غير المسددة في بوابة العملاء مع تاريخ مرجعي وتصدير بصيغة PDF – وحدة portal_open_items

وحدة portal_open_items في Odoo 19: قائمة البنود المفتوحة في بوابة العملاء مع تحديد تاريخ مرجعي والتصدير بصيغة PDF

«كم يتبقى مفتوحاً لدينا عندكم في الواقع؟» هذا السؤال يتكرر بانتظام لدى كل قاعدة عملاء، وغالباً قبيل نهاية الربع المالي، أو قبل تدقيق القوائم المالية السنوية، أو حين تُعدّ محاسبة العميل الدفعات. ومن لا يجيب عنه بنفسه يتلقاه عبر البريد الإلكتروني أو الهاتف، ويضطر شخصٌ ما إلى تصدير قائمة البنود المفتوحة (قائمة OP) من المحاسبة وإرسالها. أما مع Odoo 19 Community فلا يتحقق ذلك تلقائياً: فبوابة العملاء تعرض الفواتير فرادى، ولكنها لا تعرض قائمة بالبنود المفتوحة للشركة بأكملها، فضلاً عن عرضها في تاريخ يُختار بحرية.

كتبنا لهذا الغرض وحدة البنود المفتوحة في بوابة العملاء (portal_open_items) لنظام Odoo 19. يرى العملاء الذين فُعِّل لهم الوصول في البوابة قائمة بجميع الفواتير المفتوحة وإشعارات الدائن والدفعات التي لم تُربط بعد بفاتورة لشركتهم، ويمكنهم اختيار تاريخ مرجعي، وتنزيل القائمة بصيغة PDF، ومعرفة موقفهم من الالتزام بالسداد بنظرة واحدة. الوحدة برنامج حر بموجب ترخيص AGPL-3 وهي متاحة على GitHub:

github.com/Alex0176/odoo-portal-open-items

ثبّتنا الوحدة في 5 نوفمبر 2026 على نظام الإنتاج لدينا. الخيار هناك معطَّل افتراضياً ولا يُفعَّل إلا بالاتفاق مع كل عميل على حدة. فالخبرة التشغيلية إذن لا تزال قصيرة؛ وقد اختبرنا الوحدة بثلاثة عشر اختباراً آلياً وبقاعدة بيانات تجريبية بعملاء نموذجيين. وعلى من يعتمد الوحدة أن يقرأ الأقسام المتعلقة بـ الحساب حسب التاريخ المرجعي، وبـ الالتزام بالسداد وحول القيود .

المشكلة: إعداد قائمة البنود المفتوحة عند كل طلب

تُبيّن قائمة البنود المفتوحة فواتير العميل التي لم تُسدَّد بعد، وما تأخر سداده منها، وقيمة الرصيد. وهي أداة للمورّد لتخطيط السيولة ومتابعة تحصيل المستحقات. أما للعميل، فهي أساس لتخطيط الدفعات ومطابقة الفواتير مع سجلاته المحاسبية وتوضيح المسائل العالقة دون فتح كل فاتورة على حدة. ومن الحالات الشائعة التي تستدعيها:

  • الإقفال الفصلي والسنوي: تريد محاسبة العميل معرفة الالتزامات القائمة في 31.12. وهذا تاريخ مرجعي في الماضي.
  • المطابقة: يعتقد العميل أنه سدد فاتورة، بينما لا تزال تظهر لدينا غير مسددة. وتساعد قائمة مشتركة تتضمن التاريخ وتاريخ الاستحقاق والمبلغ على توضيح الأمر أسرع من سلسلة رسائل إلكترونية.
  • دفعات السداد الدورية: من يُعِدّ الدفعات أسبوعيًا أو شهريًا يحتاج إلى رؤية جميع فواتير المورّد المفتوحة بنظرة واحدة، مع ظهور الفواتير المتأخرة عن السداد في الأعلى.
  • تعدد جهات الاتصال: قد يتولى شخص في الشركة تقديم الطلبات، ويتولى آخر سدادها. فالبنود المفتوحة تخص الشركة، لا شخصًا بعينه.

كنا حتى الآن نستخرج هذه القوائم يدوياً من المحاسبة ونرسلها بالبريد. وهذا يستهلك الوقت، وهو في النهاية لقطة آنية تصبح قديمة في اليوم التالي. والأفضل قائمة يفتحها العميل بنفسه في البوابة في أي وقت، وتعكس دائماً أحدث وضع.

لمحة عامة عن الحل

تضيف الوحدة إلى بوابة عملاء Odoo صفحة البنود المفتوحة وبطاقة في حسابي. وتشمل وظائفها:

  • خيار لكل جهة اتصال: «عرض قائمة البنود المفتوحة في البوابة». لا يرى مستخدم البوابة البطاقة والصفحة إلا عند تفعيل هذا الخيار، وهو معطّل افتراضيًا.
  • الشركة بأكملها: تتضمن القائمة البنود المفتوحة لجميع جهات اتصال الشركة، وليس للمستخدم المسجّل دخوله وحده.
  • التاريخ المرجعي: يختار العميل تاريخًا ليعرف البنود التي كانت مفتوحة في ذلك اليوم.
  • التصدير بصيغة PDF: القائمة بصيغة PDF وبتنسيق مستندات شركتكم، مع ترويسة الشركة والرصيد وإجمالي البنود المتأخرة عن السداد.
  • الالتزام بالسداد: نسبة الفواتير المسدَّدة في موعدها أو بتأخر طفيف أو بتأخر كبير، وأطول فاتورة مفتوحة، وتقييم جيد أو سيئ، في البوابة وفي ملف PDF.
  • تُميَّز البنود المتأخرة عن السداد بالألوان، مع عرض عدد أيام التأخر عن تاريخ الاستحقاق.
  • تظهر الإشعارات الدائنة والأرصدة الدائنة في القائمة بمبالغ سالبة وتُخفِّض الرصيد.
  • الروابط: تفتح كل فاتورة في القائمة صفحة عرض الفاتورة في البوابة.
  • تعدد اللغات: تتبع الواجهة وملفات PDF لغة المستخدم، وتُرفق بالوحدة ترجمة ألمانية.

بوابة العملاء في Odoo 19 مع بطاقة البنود المفتوحة بجوار الطلبات والفواتير

تظهر البطاقة في الصفحة الرئيسية حسابي بجوار الطلبات والفواتير. ولا تظهر لمن لم يُفعَّل له هذا الخيار.

إتاحة الوصول لكل جهة اتصال: الخيار

تعرض قائمة البنود المفتوحة بيانات الأعمال لشركة بأكملها. لذلك لا تتيحها الوحدة لجميع مستخدمي البوابة، بل لمن تختارونهم صراحةً فقط. يتضمن نموذج جهة الاتصال، ضمن الموقع الإلكتروني، مربع الاختيار «عرض قائمة البنود المفتوحة في البوابة». ويظهر للمستخدمين الذين لديهم صلاحيات الفوترة (المجموعة account.group_account_invoice)، ويسري على جهة الاتصال هذه وحدها.

نموذج جهة الاتصال في Odoo مع خيار عرض قائمة البنود المفتوحة في البوابة

يتوافق ذلك مع الواقع العملي: ينبغي أن تتمكن إدارة الشركة أو قسم المحاسبة من الاطلاع على القائمة، بخلاف موظف لا يحتاج إلا إلى الاطلاع على التذاكر. يسري الخيار على جهة الاتصال، لكن البنود المعروضة تخص الشركة بأكملها. لذا فعّلوا الخيار للشخص الذي ينبغي أن تكون لديه رؤية شاملة لوضع الشركة.

القائمة في بوابة العملاء

يؤدي النقر على البطاقة إلى فتح /my/open-items. وتعرض الصفحة اسم الشركة وحقل اختيار التاريخ المرجعي وجدول البنود المفتوحة:

قائمة البنود المفتوحة في بوابة عملاء Odoo مع فواتير متأخرة عن السداد وإشعار دائن والرصيد وإجمالي البنود المتأخرة عن السداد

العمودالمحتوى
المستندرقم مستند الفاتورة أو الإشعار الدائن، مع رابط إلى صفحة عرض الفاتورة في البوابة؛ ويظهر المرجع تحته إن وُجد
التاريختاريخ الفاتورة أو تاريخ القيد المحاسبي، بحسب الحالة
تاريخ الاستحقاقتاريخ الاستحقاق؛ وتظهر تحته عبارة «متأخر عن السداد منذ n يومًا» باللون الأحمر للبنود المتأخرة
المبلغالمبلغ الأصلي للبند
المتبقيالمبلغ المتبقي غير المسدد (بعد الدفعات الجزئية)

يظهر أسفل الجدول الرصيد، أي مجموع جميع المبالغ المفتوحة، وإجمالي البنود المتأخرة عن السداد. وتُميَّز صفوف البنود المتأخرة بخلفية ملونة لتظهر فورًا عند تصفح القائمة سريعًا. وتظهر الإشعارات الدائنة والدفعات التي لم تُخصَّص بعد لأي فاتورة بإشارة سالبة وتُخفِّض الرصيد؛ وتوضح ملاحظة أسفل الجدول ذلك للعميل. وإذا كانت شركتكم تتعامل بعدة عملات، يُعرض الرصيد لكل عملة على حدة.

البنود المفتوحة حسب التاريخ المرجعي

فوق الجدول يوجد «البنود المفتوحة حتى التاريخ المرجعي»، وبجانبه حقل تاريخ وزر عرض. وعند اختيار تاريخ مرجعي في الماضي تُظهر القائمة ما لم يكن مسدَّداً في ذلك اليوم. وهذا هو التقرير المطلوب تماماً لعمليات الإقفال والتدقيق والمطابقة: «ما الالتزامات التي كانت علينا تجاه هذا المورّد في 31.12.؟»

البنود المفتوحة حسب التاريخ المرجعي 02.11.2026 في بوابة عملاء Odoo

كيف تُحسب البنود حسب التاريخ المرجعي

تُطبَّق على كل بند القاعدة التالية: المبلغ المفتوح في التاريخ المرجعي = مبلغ الفاتورة ناقص جميع الدفعات التي تمت مطابقتها حتى التاريخ المرجعي شاملًا. ويظهر البند في القائمة إذا كان قد رُحِّل محاسبيًا بحلول التاريخ المرجعي وظل له مبلغ متبقٍّ في ذلك التاريخ. فمثلًا، فاتورة بتاريخ 7 سبتمبر بقيمة 1.250,50 €، سُدِّد منها 500,00 € في 20 أكتوبر وسُدِّد باقيها في 5 نوفمبر، تظهر في القائمة بمبلغ 750,50 € عند اختيار 2 نوفمبر تاريخًا مرجعيًا، ولا تظهر إطلاقًا عند اختيار 5 نوفمبر.

خط زمني يوضح الفاتورة والدفعة الجزئية والتاريخ المرجعي والدفعة المتبقية، وحساب المبلغ المفتوح في التاريخ المرجعي

يُقيَّم التأخر عن السداد أيضًا وفق التاريخ المرجعي: يُعدّ البند متأخرًا إذا كان تاريخ استحقاقه يسبق التاريخ المرجعي وكان المبلغ المتبقي موجبًا. وتُحتسب أيام التأخر حتى التاريخ المرجعي، لا حتى اليوم. ويُعامَل التاريخ المرجعي المستقبلي على أنه تاريخ اليوم، وكذلك التاريخ الفارغ أو غير الصالح في شريط العنوان. وبذلك لا تعرض القائمة ما قد يُفهم خطأً على أنه توقع مستقبلي.

المقصود بـ«تاريخ الدفع» هنا

المعتمد هو التاريخ الذي جرت فيه مطابقة الفاتورة والدفعة في Odoo (الأحدث من تاريخَي القيد)، وليس تاريخ الفاتورة. وفي الحالة المعتادة، تُسجَّل الدفعة يوم استلامها وتُخصَّص للفاتورة. أما إذا تأخر تخصيص الدفعات عدة أيام، فستظل الفاتورة تظهر مفتوحة مدة أطول تبعًا لذلك. ويتناول قسم القيود ذلك بمزيد من التفصيل.

التصدير بصيغة PDF

عبر تنزيل PDF، تنشئ الوحدة القائمة في ملف PDF للتاريخ المرجعي المحدد. ويفتح زر طباعة القائمة نفسها في مربع حوار الطباعة بالمتصفح. ويستخدم ملف PDF تنسيق مستندات شركتكم في Odoo (الشعار والعنوان والتذييل المحددة في الإعدادات) ومقاس الورق الأوروبي:

ملف PDF للبنود المفتوحة حسب التاريخ المرجعي، مع ترويسة الشركة والجدول والرصيد وإجمالي البنود المتأخرة عن السداد

  • عنوان يتضمن التاريخ المرجعي: «البنود المفتوحة حسب التاريخ المرجعي 02.11.2026»، حتى إن كان التاريخ المرجعي هو اليوم. وإذا لم توجد بنود مفتوحة، تظهر عبارة «لا توجد بنود مفتوحة.»
  • عنوان العميل في حقل العنوان ضمن تنسيق مستندات الشركة، لتظل القائمة مناسبة للاستخدام عند طباعتها أيضًا.
  • طباعة البنود المتأخرة عن السداد بخط عريض لتبرز حتى عند الطباعة بالأبيض والأسود.
  • الرصيد وإجمالي البنود المتأخرة عن السداد في نهاية الجدول، ولكل عملة على حدة عند تعدد العملات.
  • اسم ملف يتضمن الشركة والتاريخ، مثل Open_items_Muster_Handels_GmbH_2026-11-02.pdf.

الالتزام بالسداد: تقييم بنظرة واحدة

بدءاً من الإصدار 19.0.1.1.0 يظهر فوق الجدول تقييم موجز لمدى انتظام الشركة في سداد فواتيرها. ويظهر التقييم نفسه في ملف PDF. وهكذا يرى العميل بنفسه موقفه، ولا تحتاجون إلى شرحه له على حدة.

صفحة البنود المفتوحة في بوابة عملاء Odoo مع تقييم الالتزام بالسداد بالأخضر والبرتقالي والأحمر والتقييم «سيئ»

  • أخضر: «سُدِّد 47 % خلال مهلة السداد.» والمقصود الفواتير التي سُدِّدت في تاريخ الاستحقاق أو قبله.
  • برتقالي: «سُدِّد 29 % في الأسبوع التالي لانتهاء مهلة السداد.» وهي دفعات بعد الاستحقاق بيوم إلى سبعة أيام.
  • أحمر: «سُدِّد 24 % لاحقاً، بمتوسط 39 يوماً (25 يوماً بعد انتهاء مهلة السداد).» يُحتسب الرقم الأول من تاريخ الفاتورة، والرقم بين القوسين من تاريخ الاستحقاق. ولا يظهر هذا السطر إلا إذا وُجدت فواتير من هذا النوع.
  • «الفواتير مفتوحة حتى 60 يوماً.» هذا هو عمر أقدم فاتورة لا تزال مفتوحة في التاريخ المرجعي، محسوباً من تاريخ الفاتورة.

يلي ذلك تقييم الالتزام بالسداد: جيد أو سيئ، وفي نهاية الصفحة، وفي ملف PDF عند نهاية الصفحة، التنبيه «يُحوَّل العملاء ذوو الالتزام السيئ بالسداد إلى الدفع المسبق.» ويعرض ملف PDF السطور نفسها بتخطيط الترويسة:

ملف PDF للبنود المفتوحة في التاريخ المرجعي 05.10.2026 مع الالتزام بالسداد والتقييم «جيد» والتنبيه المتعلق بالدفع المسبق

ما الذي يُحتسب

  • تُقيَّم الفواتير الصادرة إلى العميل والمقيَّدة. أما إشعارات الدائن والمسودات فلا تُحتسب. وعند السداد بالأقساط يُحتسب كل قسط على حدة.
  • الفترة: فواتير الأشهر الاثني عشر الأخيرة وجميع الفواتير التي لا تزال مفتوحة، حتى لو كانت أقدم.
  • يوم الدفع هو تاريخ آخر تسوية مع دفعة، تماماً كما في التاريخ المرجعي.
  • الفواتير المفتوحة: إذا كانت الفاتورة متأخرة في التاريخ المرجعي، فإنها تُحتسب كما لو سُدِّدت في التاريخ المرجعي، أي برتقالية أو حمراء. أما الفاتورة المفتوحة التي لم يحن استحقاقها بعد فلا تُقيَّم.
  • عند اختيار تاريخ مرجعي في الماضي يُعتمد وضع ذلك اليوم: الدفعات اللاحقة للتاريخ المرجعي لا تُحتسب بعد.
  • إذا لم يكن هناك ما يُقيَّم، يظهر هناك «لا توجد فواتير في الأشهر الـ 12 الأخيرة لتقييمها.» ولا يوجد تقييم.

متى يكون الالتزام بالسداد «جيداً»؟

يكون التقييم جيداً إذا كانت 70 % على الأقل من الفواتير خضراء أو برتقالية (في موعدها أو متأخرة أسبوعاً على الأكثر) ولم تكن أي فاتورة مفتوحة متأخرة أكثر من 30 يوماً. وإلا فهو سيئ. أما العتبات (7 أيام، 70 %، 30 يوماً، 12 شهراً) فهي ثوابت في مطلع الملف models/res_partner.py ويمكن تعديلها هناك.

مهم: الوحدة لا تحوّل أحداً إلى الدفع المسبق. فالتنبيه في التذييل نص ثابت يُظهر للعملاء ذوي التقييم السيئ ما قد يترتب على ذلك. وأمر اتخاذ هذا القرار ومتى يكون راجع إليكم. وإن لم تناسبكم العبارة، فعدّلوها في القالبين (صفحة البوابة والتقرير) أو في الترجمة.

من يمكنه الاطلاع على ماذا؟ نموذج صلاحيات الوصول

تتضمن البنود المفتوحة بيانات حساسة، لذلك أعطينا ضبط الوصول أولوية على أي وظيفة إضافية. وقد تعمّدنا إبقاء نموذج الصلاحيات بسيطًا:

نموذج صلاحيات الوصول: جهة اتصال مع تفعيل الخيار، وأخرى دون تفعيله، وجهة اتصال تابعة لشركة أخرى، وعنوان PDF، والموظفون

  • فقط عند تفعيل الخيار. إذا لم يكن مربع الاختيار محددًا لدى جهة الاتصال، فلن تظهر البطاقة، وسيؤدي فتح /my/open-items إلى إعادة التوجيه إلى حسابي.
  • شركة المستخدم دائمًا. تُحدَّد الشركة انطلاقًا من المستخدم المسجّل دخوله، لا من معلمة في العنوان. ولا يمكن طلب بيانات شركة أخرى عبر شريط العنوان.
  • التحقق نفسه لملفات PDF. يتيح Odoo تقارير PDF أيضًا عبر عنوان عام. لذلك تتحقق الوحدة مجددًا من الصلاحيات داخل التقرير نفسه: لا يحصل على ملف PDF إلا المستخدمون الذين لديهم صلاحيات محاسبية أو مستخدمو البوابة الذين فُعِّل لهم الخيار لشركتهم، بينما يتلقى الآخرون رسالة خطأ في الوصول.
  • البنود المرحَّلة محاسبيًا فقط. لا تظهر المسودات والمستندات الملغاة مطلقًا.
  • النطاقات المحاسبية المصرَّح بها فقط: لا تُؤخَذ في الحسبان إلا قيود الشركات التي يحق للمستخدم الوصول إليها.

التنفيذ التقني

تعتمد الوحدة فقط على account وportal، وهما من مكوّنات Odoo Community. وتضيف حقلًا واحدًا إلى جهة الاتصال، وتتكون فيما عدا ذلك من متحكم وفئة تقرير وقوالب.

المكوّنالوظيفة
الحقل portal_open_items في res.partnerخيار منطقي بعنوان «عرض قائمة البنود المفتوحة في البوابة»، لا تُنسَخ قيمته عند تكرار السجل، وهو معطّل افتراضيًا.
_open_items_data()تبحث عن بنود الذمم المدينة المرحَّلة محاسبيًا للشركة والتي لم تتم مطابقتها بعد، وتحسب لكل بند المبلغ المتبقي وحالة التأخر وعدد أيامه. وتُرجع البنود والمجاميع حسب العملة والتاريخ المرجعي.
_payment_morale()تقيّم فواتير الأشهر الاثني عشر الأخيرة وجميع الفواتير المفتوحة حتى التاريخ المرجعي: نسب الدفع في الموعد وبتأخر حتى سبعة أيام وبتأخر أكبر، والمدة المتوسطة، وأطول فاتورة مفتوحة، والتقييم جيد أو سيئ.
_open_items_residual()المبلغ المتبقي للبند في التاريخ المرجعي: المبلغ ناقص جميع المطابقات الجزئية المؤرخة حتى التاريخ المرجعي، بعملة الفاتورة.
المتحكم /my/open-itemsيعرض الصفحة ويعالج التاريخ المرجعي (الفارغ أو غير الصالح أو المستقبلي = اليوم)، ويعيد التوجيه إلى حسابي إذا لم يكن الخيار مفعّلًا.
المتحكم /my/open-items/pdfينشئ ملف PDF بالتاريخ المرجعي نفسه ويقدّمه مع اسم الملف.
التقرير report_open_itemsقالب QWeb بتنسيق مستندات الشركة (web.external_layout)، مع تحقق مستقل من صلاحية الوصول.
قوالب البوابةبطاقة في حسابي، ومسار تنقّل، وصفحة تحتوي على نموذج للتاريخ وجدول.
نموذج جهة الاتصالخيار في قسم الموقع الإلكتروني، لا يظهر إلا لأعضاء المجموعة account.group_account_invoice.
الترجمةتُرفق ترجمة ألمانية (de.po) وقالب ترجمة (.pot).

تُستخرج المبالغ غير المسددة من بنود القيود المحاسبية، وليس من الفواتير. وهذا مهم، فهو السبيل لإظهار الإشعارات الدائنة والمدفوعات التي لم تُربط بفواتير بعد، ولإعادة احتساب الوضع في تاريخ سابق استنادًا إلى التسويات (account.partial.reconcile). يُنفَّذ الاستعلام للشركة بأكملها (commercial_partner_id) بصلاحيات مرتفعة، بعد التحقق مسبقًا من حق المستخدم في الاطلاع عليها.

الاختبارات

تتضمن الوحدة ثمانية اختبارات آلية اجتازتها جميعًا في بيئتنا:

  • لا يُسمح بالوصول إلا عند تفعيل الخيار، وإلا يُعاد التوجيه إلى حسابي،
  • تحتوي القائمة على مبالغ الشركة بأكملها، ولا تتضمن مطلقًا مبالغ تخص شركة أخرى،
  • يُطبَّق الخيار على كل جهة اتصال على حدة، وليس على جميع مستخدمي الشركة،
  • تظهر الإشعارات الدائنة في القائمة بمبالغ سالبة وتُخفِّض الرصيد،
  • التاريخ المرجعي: تظهر الفاتورة التي سُدّدت لاحقًا في القائمة قبل السداد، وتختفي بعدها،
  • عرض الصفحة بتاريخ مستقبلي وبتاريخ غير صالح،
  • يُرجع عنوان PDF ملفًا بصيغة PDF،
  • عرض التقرير بصيغة HTML والتحقق من صلاحية الوصول داخل التقرير.
  • المبلغ المفتوح في التاريخ المرجعي بعد دفعات جزئية قبل التاريخ المرجعي وبعده،
  • الالتزام بالسداد: التصنيف إلى في الموعد ومتأخر حتى أسبوع ومتأخر أكثر، مع المتوسطات، وكذلك لتاريخ مرجعي في الماضي،
  • الالتزام بالسداد مع الفواتير المفتوحة والتقييم جيد أو سيئ،
  • الالتزام بالسداد دون فواتير، ودون استخدام بيانات شركة أخرى إطلاقاً،
  • الالتزام بالسداد في صفحة البوابة وفي ملف PDF.

اختبرنا الصفحة أيضًا في المتصفح باستخدام قاعدة بيانات تجريبية وعملاء افتراضيين، ومنها أُخذت الصور الواردة في هذا المقال. جميع الأسماء وأرقام المستندات والمبالغ الظاهرة فيها وهمية.

التثبيت والإعداد

git clone https://github.com/Alex0176/odoo-portal-open-items.git
ln -s /pfad/odoo-portal-open-items/portal_open_items /pfad/addons/
odoo-bin -c odoo.conf -d <datenbank> -i portal_open_items --stop-after-init

تعتمد الوحدة على account وportal. بعد التثبيت، يجب إعادة تشغيل خدمة Odoo لأن الوحدة تحتوي على شيفرة Python. إذا كنت تشغّل نظامًا فعليًا، فثبّت الوحدة أولًا على نسخة من قاعدة البيانات. ثم:

  1. افتح جهة الاتصال التي تريد السماح لها برؤية القائمة (شخص لديه صلاحية دخول إلى البوابة)،
  2. فعِّل في النموذج مربع الاختيار عرض قائمة المبالغ غير المسددة في البوابة واحفظ التغييرات،
  3. سجّل الدخول إلى البوابة بحساب هذا المستخدم، أو تحقّق مع العميل من البطاقة والقائمة والتاريخ المرجعي وملف PDF.

قبل إتاحة الوحدة، تحقّق من إعدادات المرسِل وتخطيط المستندات الخاصة بشركتك، لأن ملف PDF يأخذ الشعار والعنوان والتذييل من تخطيط المستندات. لا ترسل الوحدة رسائل بريد إلكتروني بنفسها ولا تنشئ إشعارات.

القيود والملاحظات

  • الحالة الحالية للمستندات المُرحَّلة. يستند الاحتساب في التاريخ المرجعي إلى القيود كما هي الآن في النظام. إذا أُلغيت فاتورة بعد التاريخ المرجعي أو أُعيدت إلى حالة المسودة، فلن تظهر في القائمة. فالقائمة ليست لقطة ثابتة «كما طُبعت آنذاك».
  • تُحتسب الدفعات من يوم التسوية. إذا لم تُربط دفعة بفاتورة إلا بعد أيام من وصولها، تبقى الفاتورة في القائمة مفتوحةً حتى ذلك الحين. ومن يريد تقارير نظيفة بالتاريخ المرجعي فعليه ربط الدفعات في وقت قريب. والمطابقة المصرفية مع الفواتير غير متضمنة في Odoo Community؛ ونستخدم لهذا الغرض وحدة مطابقة كشوف الحساب المصرفي (Bank-Statement-Matcher) لدينا.
  • الالتزام بالسداد بقدر دقة تسوياتكم. المحتسَب هو وقت ربط الدفعة بالفاتورة. والدفعات التي لم تُسوَّ منذ مدة طويلة تجعل العميل يبدو أسوأ مما هو عليه. تحققوا من التقييم لدى عملائكم قبل أن تستنتجوا منه شيئاً.
  • التقييم مرئي للعميل. فمن فُعِّل له الخيار يرى النتيجة والتنبيه المتعلق بالدفع المسبق أيضاً. والوحدة لا تغيّر شيئاً من شروط الدفع.
  • المستحقات على العملاء فقط. تعرض الوحدة المبالغ التي يدين بها العميل لك، ولا تعرض التزاماتك تجاهه.
  • لا تتضمن القائمة مستويات تذكير بالسداد أو رابط دفع. يستطيع العميل فتح فاتورة من القائمة والدفع من خلالها، وفق إمكانات بوابتك المعتادة.
  • PDF والتشغيل بعمليات متعددة. يستدعي Odoo داخليًا عنوان الويب الخاص به لإنشاء تقارير PDF. إذا كان نظامك يعمل بعملية عاملة واحدة فقط، فقد يتوقف التنفيذ. وينطبق ذلك على جميع تقارير PDF في البوابة، وليس على هذه الوحدة وحدها. اختبر زر PDF مرة واحدة في ظروف تشغيل فعلية بعد التثبيت.
  • اختُبرت على Odoo 19.0 Community فقط. لم نختبرها على إصدارات أخرى.
  • ليست بديلًا عن إدارة تذكيرات السداد وكشف الحساب. لا تحل القائمة محل كشف حساب محاسبي أو إجراءات التذكير بالسداد لديك، وإنما توضح الوضع الحالي فحسب.

الأسئلة الشائعة

ما قائمة المبالغ غير المسددة (OP-Liste)؟

هي كشف بجميع الفواتير التي لم تُسدَّد أو سُدِّدت جزئيًا، يتضمن تاريخ الفاتورة وتاريخ الاستحقاق والمبلغ المتبقي. وتُسمى أيضًا «الفواتير غير المسددة» أو «حساب العميل» أو «قائمة الأرصدة»، مع أن قائمة الأرصدة تعني، بالمعنى الدقيق، أرصدة جميع الحسابات.

لماذا لا تعرض بوابة Odoo قائمة المبالغ غير المسددة افتراضيًا؟

تعرض البوابة الطلبات والفواتير والمدفوعات كلًّا على حدة، مع حالاتها وعوامل التصفية. وبحسب ما اطلعنا عليه، لا تتضمن نسخة Community قائمة شاملة للشركة مع الرصيد، ولا تقريرًا حسب تاريخ مرجعي. وهذا هو الغرض من الوحدة.

هل يرى جميع مستخدمي بوابة الشركة القائمة؟

لا. لا يراها إلا جهات الاتصال التي فُعِّل لها الخيار. لكن القائمة المعروضة تشمل الشركة بأكملها، ولا تقتصر على فواتير جهة الاتصال المعنية.

هل يمكنني اختيار تاريخ مرجعي في الماضي، مثل 31.12. من العام السابق؟

نعم، يمكنك اختيار أي تاريخ حتى اليوم. تعرض القائمة عندئذ المبالغ التي كانت مُرحَّلة وغير مسددة في ذلك اليوم. يُرجى الاطلاع على ملاحظات الاحتساب: العبرة بتاريخ تسوية الدفعة.

هل يمكن اختيار تاريخ مرجعي في المستقبل؟

لا. تُعامل التواريخ المستقبلية معاملة تاريخ اليوم، حتى لا تعرض القائمة وضعًا لم يتحقق بعد.

هل تظهر الإشعارات الدائنة والدفعات المقدمة في القائمة؟

نعم. تظهر الإشعارات الدائنة والمدفوعات التي لم تُربط بأي فاتورة بعد بمبالغ سالبة في القائمة، وتُخفِّض الرصيد. وتوضح ملاحظة أسفل الجدول ذلك للعميل.

كيف تُحدَّد المبالغ المتأخرة السداد؟

يُعدّ المبلغ متأخر السداد إذا كان تاريخ استحقاقه يسبق التاريخ المرجعي، وكان لا يزال منه مبلغ موجب غير مسدد. وتُحسب أيام التأخير حتى التاريخ المرجعي.

هل يتوفر ملف PDF بلغات أخرى أيضًا؟

نعم، تتبع الواجهة وملف PDF لغة المستخدم. تُرفق الترجمة الألمانية؛ ولإضافة لغات أخرى، يكفي توفير ملف .po أو الترجمة عبر واجهة Odoo.

هل يستطيع العميل رؤية قائمة شركة أخرى بتغيير العنوان؟

لا. تُحدَّد الشركة دائمًا بناءً على المستخدم المسجّل دخوله. ولا يتضمن العنوان سوى التاريخ المرجعي. كذلك تُعاد مراجعة صلاحية الوصول إلى عنوان تقرير PDF في Odoo داخل التقرير نفسه.

كيف يُحتسب الالتزام بالسداد؟

من فواتير العملاء المقيَّدة في الأشهر الاثني عشر الأخيرة ومن جميع الفواتير المفتوحة. وفي كل فاتورة يُنظر إلى عدد الأيام التي سُدِّدت بعد الاستحقاق: في يوم الاستحقاق أو قبله (أخضر)، أو خلال سبعة أيام بعده (برتقالي)، أو لاحقاً (أحمر). ويكون التقييم جيداً إذا كانت 70 % على الأقل خضراء أو برتقالية ولم توجد فاتورة مفتوحة متأخرة أكثر من 30 يوماً. وتجدون التفاصيل في قسم الالتزام بالسداد.

هل تحوّل الوحدة العملاء ذوي الالتزام السيئ بالسداد إلى الدفع المسبق؟

لا. فهي تعرض التقييم والتنبيه فقط. أما شروط الدفع والدفع المسبق والإيقاف فتبقى قراركم وعمليتكم في Odoo.

هل ترسل الوحدة رسائل بريد إلكتروني أو تذكيرات بالسداد؟

لا. تتيح الصفحة وملف PDF فقط، ولا تنشئ رسائل أو إشعارات أو أنشطة.

هل تعمل الوحدة مع Odoo Enterprise؟

تعتمد فقط على account وportal، وهما متاحتان في كلتا النسختين. لكننا اختبرناها فقط على نسخة Community من Odoo 19.

ما ترخيص الوحدة؟

تخضع لترخيص AGPL-3. يمكنك استخدامها وتعديلها وإعادة توزيعها شريطة الالتزام بشروط الترخيص. ونرحب ببلاغات الأخطاء ومقترحات التحسين كتذاكر Issue في مستودع GitHub موضع ترحيب.

الدعم من Biricon IT Services

نتولى دعم أنظمة Odoo للشركات الصغيرة والمتوسطة، بدءًا من التطبيق والتخصيص والترحيل وصولًا إلى التشغيل المستمر. إذا كنت ترغب في إتاحة المبالغ غير المسددة والفواتير والتذاكر لعملائك في البوابة، أو توسيع وظائف المحاسبة في Odoo Community، أو تثبيت وحدة بأمان في بيئة الإنتاج لديك، فيسعدنا مساعدتك. تطويرات داخلية أخرى: أرشفة الشركة مع مستخدمي بوابتها, السجل التجاري والتحقق من العناوين للعملاء النمساويين, تكوين أرقام المستندات من بادئة وسنة وعدّاد و مجموعات المنتجات كقسم في عرض السعر.

تواصل معنا الآن

الحالة: 6 نوفمبر 2026. إصدار الوحدة 19.0.1.1.1. التغييرات منذ الإصدار الأول في 5 نوفمبر: الالتزام بالسداد (19.0.1.1.0) وتصحيح المبلغ المفتوح في التاريخ المرجعي بعد الدفعات الجزئية (19.0.1.1.1). جميع الأسماء وأرقام المستندات والمبالغ في الصور من نسج الخيال.