Odoo 19 Community: سجل الشركات والتحقق من العناوين للعملاء النمساويين – وحدتنا مفتوحة المصدر partner_firmenbuch_at

كل من يمارس الأعمال في النمسا يعرف هذه الأسئلة: هل الاسم المسجّل لشركة عميلي الجديد وعنوانها صحيحان؟ هل ما زالت الشركة مقيّدة في السجل التجاري، أم أنها قيد التصفية؟ هل فُتحت إجراءات إعسار بحق العميل الذي أزوّده بالبضائع منذ عامين؟ الإجابات موجودة في السجل التجاري التابع لوزارة العدل، لكن قلّة من الناس تراجعه بانتظام. في Odoo، تُنشأ جهة الاتصال مرة واحدة، ثم تصبح بياناتها قديمة بمرور الوقت.

لهذا طوّرنا وحدة السجل التجاري للشركاء (partner_firmenbuch_at). وهي تربط جهات الاتصال في Odoo بالسجل التجاري وبسجل العناوين الرسمي لدى BEV. صُمّمت الوحدة لـ Odoo 19، وهي متاحة مجانًا على GitHub بوصفها برمجية حرة بموجب ترخيص LGPL-3:

github.com/Alex0176/odoo-partner-firmenbuch-at

المشكلة: بيانات أساسية لا يتولى أحد تحديثها

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

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

ما الذي تفعله الوحدة؟

1. البحث عن الشركات الجديدة. عندما ينشئ أحدهم جهة اتصال بوصفها شركة، ويكون البلد النمسا أو يُترك فارغًا، تبحث الوحدة عنها في السجل التجاري خلال دقائق قليلة. وإذا وُجدت نتيجة واحدة فقط، تُستكمل الحقول الفارغة: الشارع والرمز البريدي والمدينة والبلد ورقم السجل التجاري والمحكمة والشكل القانوني.
2. اقتراح التعديلات عند وجود اختلافات، دون استبدال البيانات مطلقًا. إذا اختلفت بيانات جهة الاتصال عن بيانات السجل، يُنشأ اقتراح تعديل يوافق عليه الموظف لكل حقل على حدة.
3. البحث في السجل التجاري من جهة الاتصال. في علامة التبويب السجل التجاري، يمكن البحث عن الشركات بالاسم، حتى إن لم تكن نتيجة البحث التلقائي حاسمة.
4. متابعة يومية. تستعلم الوحدة يوميًا عن الشركات والمستندات التي طرأت عليها تغييرات في السجل، وتتحقق من العملاء المعنيين. كما تُعيد التحقق من كل شركة بالكامل على فترات قابلة للضبط.
5. مستويات التنبيه. ترصد الوحدة إجراءات الإعسار وإعادة الهيكلة المفتوحة، استنادًا إلى الوقائع القانونية المقيّدة في السجل، وكذلك التصفية والشطب وحقوق الملكية السالبة وانخفاض نسبة حقوق الملكية، وتُظهر ذلك في جهة الاتصال.
6. التحقق من العناوين. يجري التحقق محليًا من العناوين النمساوية بمقارنتها بسجل العناوين الرسمي للمكتب الاتحادي للمقاييس والمساحة (BEV).
7. بيانات السجل في جهة الاتصال. تظهر المحكمة والشكل القانوني والمديرون والوقائع القانونية في علامة التبويب السجل التجاري. وهي تعكس بيانات السجل وتُحدَّث مباشرة.
8. إشعارات داخلية فقط. تُرسَل جميع الرسائل إلى قناة Discuss الداخلية السجل التجاري وإلى سجل المحادثات في جهة الاتصال. وينتج عن عملية تحقق تشمل شركات عديدة إشعار تجميعي واحد بدلًا من إشعار لكل شركة. ولا ترسل الوحدة أي شيء إلى العملاء مطلقًا.

اقتراحات بدلًا من استبدال البيانات

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

ضمن جهات الاتصال → السجل التجاري → اقتراحات السجل التجاري، ترى القيمة الحالية وقيمة السجل لكل حقل. اترك الحقول التي لا تريد اعتمادها دون تحديد. يؤدي النقر على اعتماد المحدد إلى حفظ الحقول المحددة فقط، ويؤدي النقر على رفض إلى إلغاء الاقتراح. ويحل أي اقتراح جديد محل الاقتراحات السابقة المفتوحة لجهة الاتصال نفسها، حتى لا تُطبَّق قيم قديمة.

التنبيهات: الإعسار والتصفية والميزانية العمومية

تميّز الوحدة بين ثلاثة مستويات:

• طبيعي: لا يوجد ما يستدعي الإبلاغ.
• تحذير (أصفر): يتضمن السجل قيودًا سارية بشأن التصفية أو الحل أو إنهاء الأعمال أو الشطب أو الاندماج، أو تكون الشركة معلَّمة على أنها مشطوبة، أو تكون إجراءات إعسار سابقة قد أُغلقت خلال السنوات الأخيرة (المدة الافتراضية ثلاث سنوات، ويمكن تعديلها). أو تُظهر القوائم المالية السنوية حقوق ملكية سالبة، أو نسبة حقوق ملكية تقل عن 8 % (القيمة الافتراضية استنادًا إلى المادة 23 من URG، ويمكن تعديلها)، أو خسارة سنوية، أو تراجعًا في الإيرادات بنسبة 25 % فأكثر.
• حالة حرجة (أحمر): فُتحت إجراءات إعسار أو إفلاس أو إعادة هيكلة ولم تُغلق بعد، أو رُفض طلب فتحها لعدم كفاية الأصول لتغطية التكاليف. وتُعد الحالة الأخيرة عجزًا عن السداد.

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

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

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

التحقق من العناوين باستخدام سجل عناوين BEV

تتيح BEV سجل العناوين في صورة بيانات مفتوحة (العناوين في جداول علائقية – بيانات بتاريخ مرجعي محدد، مع تاريخ مرجعي جديد مرتين سنويًا، ويمكن استخدامها مجانًا مع ذكر المصدر). تُنزّل الوحدة نسخة البيانات عبر خدمة INSPIRE-ATOM الرسمية، بحجم نحو 120 ميغابايت تضم قرابة 2.5 مليون عنوان، وتستوردها إلى جداول خاصة بها ذات بنية مبسطة.

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

• صحيح: العنوان موجود في السجل بهذه الصيغة.
• رقم المبنى غير معروف: الشارع والمدينة متطابقان، لكن رقم المبنى غير مطابق.
• تصحيح مقترح: خطأ كتابي في اسم الشارع أو المدينة، أو رمز بريدي غير صحيح. التصحيح متاح في صورة اقتراح.
• لم يُعثر عليه: هذا العنوان غير موجود في السجل.

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

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

الوصول إلى السجل

تتيح وزارة العدل سجل الشركات عبر FBW-WebServices (HVD) على JustizOnline من خلال واجهة SOAP. الوصول مجاني، لكنه يتطلب مفتاح API يُطلب باستخدام ID Austria ضمن إعادة استخدام المعلومات. ويُرسل المفتاح في ترويسة HTTP باسم X-API-KEY. تستخدم الوحدة الخدمة مباشرةً، دون استخلاص البيانات من صفحات الويب.

العميل models/firmenbuch_client.py مكتوب بالكامل بلغة Python ولا يعتمد على Odoo. وهو يدعم الاستعلامات SUCHEFIRMAREQUEST وAUSZUG_V2_REQUEST وSUCHEURKUNDEREQUEST وURKUNDEREQUEST، إضافةً إلى VERAENDERUNGENFIRMAREQUEST وVERAENDERUNGENURKUNDEREQUEST. لذلك يمكن اختباره باستخدام استجابات محفوظة. تُرسل الطلبات بفاصل 0.3 ثانية، وتُجرى استعلامات التغييرات على فترات يغطي كل منها سبعة أيام.

تحليل المستخرج

لا تُستخدم من المستخرج إلا القيود التي لا تزال سارية (أي التي لا تكون قيمة السمة AUFRECHT فيها false). يُؤخذ الاسم من معرّف البيانات FI_DKZ02، والعنوان من FI_DKZ03، والمقر من FI_DKZ06، والشكل القانوني من FI_DKZ07. وتُضاف إليها المحكمة وعنوان الموقع الإلكتروني والأشخاص المخوّلون بالتمثيل والوقائع القانونية. ولتحديد مستوى التحذير، يُبحث في نصوص جميع القيود السارية عن الكلمات المفتاحية القابلة للتعديل:

DEFAULT_CRITICAL = "Konkursverfahren, Insolvenzverfahren, Sanierungsverfahren, Konkurs eröffnet, ..."
DEFAULT_WARNING  = "Liquidation, aufgelöst, Auflösung, Abwicklung, Löschung, gelöscht, Verschmelzung, in Liqu."

ميزة التحقق بالكلمات المفتاحية أنه يعمل بصرف النظر عن الحقل الذي يسجل فيه السجل الإجراء المعني. أما عيبه فموضح في قسم القيود.

المراقبة

تُنشئ الوحدة ثلاثة إجراءات مجدولة:

• البحث عن الشركات الجديدة (كل 10 دقائق، بحد أقصى 20 جهة اتصال في كل تشغيل). وتُطلَق العملية أيضًا فور إنشاء جهة الاتصال.
• مراقبة الشركات (يوميًا عند 04:30). يستعلم عن الشركات والمستندات التي تغيرت منذ آخر تشغيل (بالرجوع إلى 30 يومًا كحد أقصى)، ويتحقق من العملاء المعنيين، ثم من 50 عميلًا كحد أقصى مضت على آخر تحقق منهم مدة تتجاوز المهلة المحددة. تُحفظ كل شركة في معاملة مستقلة، كي لا يؤدي أي خطأ إلى فقدان النتائج السابقة. وتُرسل نتيجة التشغيل في رسالة مجمّعة واحدة إلى القناة.
• تحديث سجل العناوين (أسبوعيًا عند 03:15).

في غياب مفتاح API، ينتهي الإجراءان الأولان فورًا. ويمنع مجموع تحقق خاص بكل شركة إعادة تحليل المستخرجات التي لم تتغير.

سجل العناوين

تُخزَّن بيانات BEV في ثلاثة جداول (bev.locality وbev.street وbev.address) مع فهرس للرمز البريدي ومعرّف الشارع ورقم المبنى. يجري الاستيراد باستخدام COPY ضمن معاملة واحدة، فتُستبدل الجداول دفعة واحدة. وتُوحَّد صيغة أرقام المباني وفق طريقة كتابتها في السجل (51-55، 12a). تشغل الجداول نحو 400 ميغابايت في قاعدة البيانات عند تضمين أرقام المباني. ويمكن لمن لا يرغب في ذلك تعطيل التحقق من أرقام المباني، والاكتفاء بنحو 150,000 صف.

ما تعلّمناه من التعامل مع الخدمة الفعلية

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

• المعلومات الموجزة فقط. لا يتيح هذا المفتاح جلب المستخرج إلا بنطاق المعلومات الموجزة. وترفض الخدمة طلبات المعلومات الكاملة. في الإصدار 1.0.0، كانت العملية اليومية لا تزال تطلب النطاق الخطأ، وقد صحح الإصدار 1.1.0 ذلك. ومن بيانات الأشخاص، لا تستورد الوحدة إلا أسماء المديرين المخوّلين بتمثيل الشركة؛ ولا تقرأ بيانات الشركاء أو عناوين الأشخاص.
• الشارع ورقم المبنى منفصلان. يَرِد العنوان في عنصرين منفصلين هما STRASSE وHAUSNUMMER، وليس في نص واحد. وتجمع الوحدة بينهما.
• المحكمة ضمن بيانات تنفيذ القيد. لا تَرِد المحكمة المختصة في قسم بيانات الشركة، بل في آخر كتلة VOLLZ من المستخرج.
• الشركات المشطوبة. يُتعرَّف على الشركة المشطوبة من سمة (MIT_FIRMA_GELOESCHT_DURCH_VNR)، وليس من نص. وتحوّل الوحدة هذه السمة إلى النتيجة الشركة مشطوبة، التي تُطلق تحذيرًا.
• اسم الشركة ليس هو عبارة البحث. يقارن البحث بداية الاسم. ولن يعثر البحث عن «Muster GmbH» على نتيجة إذا كان الاسم في السجل «Muster Gesellschaft m.b.H.»؛ كما تتضمن أسماء الشركات قيد التصفية عبارة «in Liqu.»، وقد يظل اسم جهة الاتصال محتويًا على &. لذلك تُعيد الوحدة البحث دون الشكل القانوني، وتقارن الأسماء بعد إزالة الصيغ المختلفة للشكل القانوني ورموز HTML وعبارة «in Liqu.». ولا تعتمد النتيجة الوحيدة إلا إذا كان اسمها يبدأ باسم جهة الاتصال.
• تغييرات المستندات دون رقم سجل الشركة. لا تتضمن قائمة المستندات المعدَّلة إلا مفتاحًا. ويَرِد رقم سجل الشركة (دون حرف التحقق) في بداية هذا المفتاح. وتستخدمه الوحدة لربط التغييرات بالعملاء.

أصبح لكل نقطة من هذه النقاط اختبار آلي يستخدم استجابة محاكاة.

الاختبار على قاعدة عملائنا

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

• جرى البحث عن 438 جهة اتصال لشركات مسجَّلة كعملاء في النمسا أو دون بلد محدد.
• أمكن ربط 138 منها بسجل الشركات بشكل قاطع. وكانت لدى 18 جهة أخرى نتيجة واحدة مطابقة للاسم، لكن بعنوان مختلف في السجل (بسبب انتقال الشركة أو وجود شركة أخرى بالاسم نفسه)، فبقيت دون تغيير. وكان هناك اسمان يحتمل كل منهما أكثر من تطابق.
• لم نعثر على نحو 280 جهة، أو عثرنا لها على تطابقات جزئية فقط. وتشمل أفرادًا ومنشآت فردية وشركات أجنبية وجهات اتصال لا تتضمن سوى اسم علامة تجارية أو مكان، وشركات يختلف اسمها في جهة الاتصال عن الاسم المسجل، كأن يتضمن شكلًا قانونيًا مختلفًا. ويظل خيار البحث في سجل الشركات اليدوي متاحًا لها.
• أُنشئ 63 اقتراح تعديل، معظمها يتعلق بصيغة كتابة الشارع ورقم المبنى، وبالبلد.
• 66 تحذيرًا، دون أي حالة حرجة. هناك 36 شركة معلَّمة في السجل على أنها مشطوبة (9 منها قيد التصفية أيضًا)، وشركتان كانت لديهما إجراءات إعسار أُغلقت لاحقًا، و42 شركة أظهرت قوائمها المالية السنوية مؤشرات تستدعي الانتباه: انخفاض نسبة حقوق الملكية أو خسارة أو تراجع الإيرادات. ولا يعني شطب الشركة تلقائيًا خسارة العميل، لكنه يستدعي مراجعة العنوان والجهة التي تُوجَّه إليها الفاتورة.

استخلصنا درسين: قاعدة عملاء من نشاط فعلي أفضل بكثير للاختبار من أي استجابة محاكاة. فقد اكتشفنا أخطاء في البحث عن الأسماء، عولجت في الإصدار 1.1.1 (انظر أعلاه). كما أن نسبة العثور على النتائج تعتمد بدرجة كبيرة على دقة تسمية جهات الاتصال: فكتابة الاسم القانوني للشركة كما يَرِد في السجل تتيح العثور عليها بموثوقية.

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

المتطلبات: Odoo 19.0 مع التطبيقين القياسيين جهات الاتصال وDiscuss، وحزمة Python المسماة requests (الموجودة في كل تثبيت لـ Odoo)، وإمكانية الاتصال الصادر عبر HTTPS بكل من justizonline.gv.at وdata.bev.gv.at. لا تعتمد الوحدة على أي مكونات خارج التطبيقات القياسية، لذا لا تستلزم تثبيت وحدات إضافية.

1. ضع المجلد partner_firmenbuch_at في addons_path، وحدّث قائمة التطبيقات ثم ثبّت الوحدة. وفي بيئات الإنتاج، يُفضَّل تجربتها أولًا على قاعدة بيانات اختبارية.
2. تُنشئ الوحدة قناة سجل الشركات في Discuss (للمستخدمين الداخليين)، وتُضيف إليها جميع المسؤولين الإداريين. كما تُنشئ الإجراءات المجدولة الثلاثة.
3. اطلب مفتاح API: عبر JustizOnline (باستخدام ID Austria)، ثم إعادة استخدام المعلومات، ثم واجهة API المسماة FBW.
4. الإعدادات → سجل الشركات: أدخل المفتاح ثم اختر اختبار الاتصال. وبعد ذلك حدّد القناة والخيارات والكلمات المفتاحية ورموز البنود.

odoo-bin -c /etc/odoo/odoo.conf -d <datenbank> -i partner_firmenbuch_at --stop-after-init

مهم في بيئات الإنتاج: يبدأ أول تشغيل لتحديث سجل العناوين تلقائيًا في الليلة التالية للتثبيت عند 03:15، ويُنزّل نحو 120 ميغابايت. وبعد ذلك يُتحقق من جميع جهات الاتصال النمساوية؛ وتظهر الحالات التي تستدعي الانتباه كاقتراحات وفي رسالة واحدة بالقناة. إذا لم ترغب في ذلك، فعطّل مسبقًا الإجراء المجدول سجل العناوين (BEV): تحديث، أو أوقف خيار التحقق من العناوين النمساوية في الإعدادات.

عمليات الاستيراد الجماعي: استخدم مفتاحَي السياق fb_no_lookup=True وbev_no_check=True عند الاستيراد. وإلا فستُدرَج كل شركة نمساوية مستوردة في قائمة انتظار الاستعلام من السجل (20 شركة كل عشر دقائق)، وسيُتحقق من كل عنوان عند إنشائه.

حماية البيانات: ما الذي ترسله الوحدة وإلى من؟

• البيانات الشخصية: أسماء المديرين بيانات شخصية، حتى لو كانت منشورة في السجل. ولا تخزّنها الوحدة إلا لإدارة العلاقة التجارية. ويمكن لمن لا يرغب في ذلك إفراغ الحقل أو عدم استخدامه.
• سجل الشركات: لا يُرسل إلى justizonline.gv.at سوى الاسم أو رقم سجل الشركة لجهات الاتصال المصنّفة كشركات (دون شركة أم، وبلدها النمسا أو غير محدد)، مع مفتاح API. ولا تُرسل مطلقًا بيانات الأفراد أو الأشخاص المسؤولين عن التواصل لدى الشركات.
• سجل العناوين: لا يُنزَّل سوى المستخرج المتاح للعامة. ولا تغادر عناوين العملاء النظام.
• لا رسائل بريد إلكتروني للعملاء: تُرسل الإشعارات إلى القناة الداخلية وإلى سجل المحادثات، وفي صورة أنشطة للموظفين.
• المفتاح: لا يظهر مفتاح API إلا للمسؤولين الإداريين.

سجل الشركات سجل عام. وتخضع إعادة استخدام بياناته لشروط إعادة استخدام المعلومات لدى JustizOnline.

الاختبارات

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

• توحيد صيغة رقم سجل الشركة
• تحليل المستخرج (الاسم والعنوان والمحكمة والمديرون والشركة المشطوبة، مع تجاهل القيود غير السارية)
• مقارنة الأسماء: الصيغ المختلفة للشكل القانوني، و«in Liqu.»، ورموز HTML، وعدم اعتماد تطابق مع شركة أخرى
• القوائم المالية السنوية: حقوق الملكية والنتيجة وإجمالي الميزانية
• العثور على شركة جديدة، وملء الحقول الفارغة، واقتراح القيم المختلفة، وتطبيق الاقتراح جزئيًا
• المراقبة: فتح إجراءات إعسار يغيّر المستوى إلى حرج ويُنشئ النشاط، وإغلاق الإجراءات ينتج عنه تحذير، ولا يُتحقق من الأشخاص المسؤولين عن التواصل بصورة منفصلة
• ربط تغييرات المستندات باستخدام المفتاح
• عدم إجراء أي استعلام في غياب مفتاح API
• التحقق من العناوين بمقارنتها بنسخة البيانات المصغّرة

odoo-bin -d <testdatenbank> -i partner_firmenbuch_at \
         --test-enable --test-tags=/partner_firmenbuch_at --stop-after-init

توجد الترجمة الألمانية في i18n/de.po.

القيود والتنويه القانوني

• نتيجة البحث مؤشر، وليست إفادة قانونية. تُستنتج الحالة من الكلمات المفتاحية في قيود السجل السارية. راجع السجل بنفسك قبل اتخاذ قرارات بشأن الائتمان أو شروط التوريد.
• لم يُختبر اكتشاف الإعسار إلا بحالات محاكاة. تتعرف الوحدة على الإجراءات من كلمات في النص الحر للوقائع القانونية (فتح الإجراءات، إغلاقها، خطة إعادة هيكلة معتمدة، عدم كفاية الأصول). وقد حاكينا تنسيقها استنادًا إلى مستخرج حقيقي من السجل، لكن لم تتوفر لدينا أثناء التطوير حالة إعسار حقيقية لفحصها. لذلك قد لا تكتشف الوحدة صياغة غير مألوفة. ولا تحل الوحدة محل قاعدة بيانات الإعلانات القضائية الرسمية.
• القوائم المالية السنوية بصيغة XML فقط. تُتجاوز الإيداعات المتاحة بصيغة PDF وحدها. وقد تقدم الشركات الصغيرة جدًا ميزانية مختصرة لا تتضمن الأرقام التي تقرؤها الوحدة.
• النمسا فقط. لا تُجرى استعلامات عن الشركات الأجنبية. ولا تَرِد المواقع الإلكترونية للشركات في السجل، لذا لا تُضاف.
• الربط التلقائي عند وجود تطابق واحد واضح فقط. إذا وُجدت عدة شركات بالاسم نفسه، تُرسل رسالة إلى القناة تطلب استخدام البحث في سجل الشركات يدويًا.
• قد تتغير الواجهات. تعتمد الوحدة على خدمات BMJ وBEV. وقد يلزم تحديثها إذا تغيرت نقطة الاتصال أو مخطط البيانات أو موجز ATOM.
• اختُبرت على Odoo 19. طُوّرت واختُبرت على Odoo 19.0 Community. ولم نختبرها على إصدارات أخرى. ولا يُعد هذا المقال استشارة قانونية.

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

هل الوصول إلى السجل مدفوع؟

بحسب معلوماتنا، لا: خدمات FBW-WebServices لإعادة استخدام المعلومات مجانية، لكنها تتطلب مفتاح API يُطلب عبر JustizOnline. ويُرجع في ذلك إلى الشروط الحالية لوزارة العدل.

هل تُستبدل بيانات جهات الاتصال الموجودة؟

لا. تملأ الوحدة الحقول الفارغة فقط. أما القيم المختلفة فتُنشأ كاقتراحات يوافق عليها الموظف لكل حقل على حدة.

هل سيعلم عملائي بإجراء التحقق؟

لا. تُرسل جميع الإشعارات إلى القناة الداخلية وسجل محادثات جهة الاتصال، وفي صورة أنشطة للموظفين. ولا ترسل الوحدة رسائل بريد إلكتروني إلى العملاء.

هل تُخزَّن بيانات المديرين أو الشركاء؟

تُخزَّن أسماء المديرين المخوّلين بتمثيل الشركة (في حقل المديرون ضمن تبويب سجل الشركات)، أما بيانات الشركاء وعناوين الأشخاص فلا تُخزَّن. تعامل مع الأسماء بوصفها بيانات شخصية.

على كم من عملائنا يمكن للوحدة العثور؟

يعتمد ذلك على قاعدة العملاء. في حالتنا، عثرت الوحدة على 138 من أصل 438 جهة اتصال لشركات (نحو الثلث). أما البقية فتشمل أفرادًا ومنشآت فردية وشركات أجنبية وجهات اتصال لا يطابق اسمها الاسم القانوني للشركة. وتَرِد الأرقام في قسم الاختبار على قاعدة عملائنا.

هل يمكنني العثور على عميل دون رقم سجل الشركة؟

نعم. يتضمن تبويب سجل الشركات زر البحث في سجل الشركات للبحث بالاسم. ولا تُدخل الوحدة البيانات تلقائيًا إلا عند تطابق شركة واحدة فقط. وفي غير ذلك، تختار النتيجة بنفسك.

ماذا عن الشركات في ألمانيا أو سويسرا؟

لا تُجرى استعلامات عنها. تقتصر الوحدة على جهات الاتصال التي يكون بلدها النمسا أو غير محدد.

ما مساحة التخزين التي يتطلبها التحقق من العناوين؟

نحو 400 ميغابايت في قاعدة البيانات عند تضمين أرقام المباني، ونحو 120 ميغابايت من مساحة القرص المؤقتة أثناء الاستيراد. ومن دون التحقق من أرقام المباني، يكفي نحو 150,000 صف.

ماذا لو أردت استخدام سجل الشركات فقط دون التحقق من العناوين؟

أوقف خيار التحقق من العناوين النمساوية في الإعدادات، وعطّل الإجراء المجدول الخاص بسجل العناوين. عندئذ لن تُنزَّل أي بيانات.

ما الترخيص الذي تُتاح بموجبه الوحدة؟

تحت LGPL-3. يحق لكم استخدامها وتعديلها ونشرها. والأخطاء ومقترحات التحسين مرحَّب بها كمسألة (Issue) في مستودع GitHub .

الدعم من Biricon IT Services

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

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

الحالة بتاريخ: 3 نوفمبر 2026. إصدار الوحدة 19.0.1.1.1. بيانات الأمثلة في الصور مختارة اعتباطياً وليست شركات حقيقية.