يتناول هذا المقال:

• شكل صفحة تكامل Odoo داخل Darbpay

• كيفية عمل معالج الإعداد (الضرائب، الحسابات، اليومية البنكية)

• كيف تظهر عمليات التصدير داخل Odoo

• الأسئلة الشائعة حول رموز الضريبة، الحسابات، وسلوك المزامنة

كيف يبدو تكامل Odoo داخل Darbpay؟

ستجد تكامل Odoo ضمن:

الإعدادات → تكاملات المحاسبة → Odoo

في هذه الصفحة سترى:

حالة الاتصال (Connection status)

• متصل (Connected)

• غير متصل (Not connected)

• يتطلّب إجراء (Action required / reconnect)

بيئة Odoo المرتبطة (Linked Odoo environment)

• رابط الاستضافة (Host URL) واسم قاعدة البيانات التي يتصل بها Darbpay

• شركة Odoo واليومية (Journal) المحددتان لاستقبال عمليات التصدير

ملخص المزامنة (Sync summary)

• وقت آخر مزامنة

• عدد المصروفات التي تم تصديرها

• أي أخطاء حديثة (مثل رمز ضريبة غير صالح، أو حساب غير موجود)

من هنا يمكنك فتح معالج إعداد Odoo الذي يوجّهك عبر خمس خطوات بسيطة:

1. Connect

2. Tax codes

3. Expense accounts

4. Bank account

5. Finish

الخطوة 1: ربط Darbpay مع Odoo

عند الضغط على Connect with Odoo، يفتح Darbpay نموذج اتصال آمن لإدخال بيانات Odoo الخاصة بك:

• Host URL – رابط نسخة Odoo لديك (مثال: https://odoo.yourcompany.com)

• Database name – اسم قاعدة بيانات Odoo التي تريد أن يستخدمها Darbpay

• Email – المستخدم في Odoo الذي يملك مفتاح الـ API

• API key – مفتاح الـ API الذي تم إنشاؤه لهذا المستخدم في Odoo

بعد الضغط على Connect:

• يقوم Darbpay بالتحقق من صحة البيانات مع Odoo.

• إذا كان هناك خطأ (في الرابط، قاعدة البيانات، أو مفتاح الـ API) ستظهر رسالة خطأ واضحة لتعديل البيانات.

• في حال النجاح، يخزّن Darbpay بيانات الاتصال بشكل آمن ومشفّر ويضع حالة Odoo على Connected لهذه الشركة في Darbpay.

بعد اكتمال الاتصال، يستطيع Darbpay جلب الشركات (Companies)، اليوميات (Journals)، رموز الضريبة، ودليل الحسابات من Odoo في الخطوات التالية.

الخطوة 2: اختيار شركة Odoo واليومية

بعد نجاح الاتصال، ستظهر بطاقة Odoo بحالة Connected، وسيطلب منك معالج الإعداد اختيار:

• شركة Odoo (Odoo company): الكيان القانوني داخل Odoo الذي سيستقبل صادرات Darbpay

• يومية Odoo (Odoo journal): اليومية التي ستسجَّل عليها معاملات Darbpay (غالبًا يومية بنك أو يومية تسوية مخصّصة لـ Darbpay)

تختار الشركة واليومية من القوائم المنسدلة التي يتم جلبها مباشرةً من Odoo.
يخزّن Darbpay هذه الاختيارات ويستخدمها في جميع عمليات التصدير المستقبلية من هذا الحساب في Darbpay.

الخطوة 3: استيراد رموز الضريبة من Odoo إلى Darbpay

تتيح لك خطوة Tax codes جلب إعدادات ضريبة القيمة المضافة من Odoo إلى Darbpay لضمان تطبيق الضريبة بشكل صحيح على كل معاملة.

في هذه الشاشة سترى:

• شرحًا مختصرًا بأن Darbpay سيستورد رموز الضريبة من Odoo ويستخدمها عند ترحيل المصروفات.

• زر Import tax codes لاستيراد رموز الضريبة.

عند الضغط على Import tax codes:

• يستدعي Darbpay Odoo لجلب رموز الضريبة النشطة (مثل 15% VAT، صفرية، معفاة)، مع أسمائها ونِسَبها ومعرّفاتها الداخلية.

• يتم تحديث رموز الضريبة السابقة القادمة من Odoo في Darbpay لتجنّب التكرار.

• تصبح الرموز المستوردة متاحة لربطها بفئات المصروف وللاستخدام عند إنشاء القيود اليومية.

بهذا الشكل يبقى Odoo هو مصدر الحقيقة الوحيد لضريبة القيمة المضافة (VAT)، بينما يركّز Darbpay على دقة بيانات المعاملات والإيصالات.

الخطوة 4: استيراد وربط حسابات المصروفات

تتيح لك خطوة Expense accounts استيراد حسابات المصروف من دليل الحسابات في Odoo وربطها بفئات المصروف في Darbpay.

ستجد في هذه الشاشة:

• زر Import accounts from Odoo لاستيراد الحسابات.

• مساحة ربط (Mapping) يمكنك من خلالها ربط فئات المصروف في Darbpay بحسابات Odoo ورموز الضريبة الافتراضية.

عند الضغط على Import accounts:

• يجلب Darbpay دليل الحسابات (Chart of accounts) من Odoo ويصفّي النتائج على الحسابات ذات الصلة بالمصروفات (وأنواع أخرى إذا كانت إعداداتك تتطلّب ذلك).

لكل حساب، يخزّن Darbpay:

• معرّف حساب Odoo

• اسم الحساب ورمزه

• نوع الحساب

بعد ذلك يمكنك ربط كل فئة مصروف في Darbpay بـ:

• حساب مصروف محدد في Odoo

• رمز ضريبة افتراضي تم استيراده في الخطوة السابقة

تُستخدم هذه العلاقات في كل مرة ينشئ فيها Darbpay قيودًا يومية داخل Odoo.

الخطوة 5: ربط محافظ Darbpay بحساب بنكي في Odoo

في خطوة Bank account، تقوم بربط رصيد محفظة أو بطاقة Darbpay بالحساب البنكي/حساب التسوية المناسب داخل Odoo.

عادةً ستقوم بما يلي:

• اختيار الحساب البنكي أو حساب التسوية في Odoo الذي يمثّل رصيد Darbpay.

• تأكيد أي محافظ أو برامج بطاقات في Darbpay يجب أن تُرحَّل إلى هذا الحساب.

من منظور محاسبي، يضمن ذلك أن كل معاملة:

• تَدين حساب المصروف الصحيح

• تَدين عليه (Credit) حساب البنك/التسوية في Odoo الذي يمثل Darbpay

هذا يجعل عملية المطابقة مع كشوف Darbpay بسيطة، ويحافظ على اتساق دفتر Odoo مع الرصيد الفعلي.

كيف تظهر معاملات Darbpay داخل Odoo؟

بعد إكمال الإعداد وتصدير النشاط من Darbpay، يعرض Odoo قيود يومية (Journal Entries) في اليومية التي اخترتها (مثال: يومية بنك مخصّصة باسم "Darbpay").

كل دفعة أو معاملة مُصدَّرة تنشئ:

• قيد يومية بصيغة Draft داخل Odoo، في اليومية المكوّنة.

• التاريخ (Date) – عادةً تاريخ المعاملة أو تاريخ الترحيل.

• المرجع (Reference) – مرجع فريد يربط القيد بكشف Darbpay أو بالدفعة (Batch).

• المبلغ الإجمالي (Total amount) – إجمالي قيمة المعاملات في هذا القيد (مثال: ‎34.08 SAR).

داخل القيد سترى:

• سطر حساب بنك/تسوية لتمثيل حساب Darbpay البنكي أو حساب التسوية.

• سطرًا أو أكثر للمصروفات، يتم ترحيلها إلى حسابات المصروف في Odoo التي قمت بربطها مع كل فئة في Darbpay.

• ضريبة القيمة المضافة (VAT) محسوبة وفق رموز الضريبة المختارة، بحيث تعكس شبكة الضرائب في Odoo (Tax grid) مبالغ الأساس والضريبة بشكل صحيح.

يقوم Darbpay أيضًا برفع إيصال الدفع أو فاتورة الـ PDF كمرفق على القيد نفسه، حتى يتمكّن المحاسب من التحقق البصري من كل معاملة مباشرةً من داخل Odoo.

بعد أن يراجع فريق المالية القيد ويوافق عليه، يقوم بالنقر على Post في Odoo:

• ينتقل القيد من حالة Draft إلى Posted ويصبح جزءًا من الدفتر الرسمي.

• يتم تحديث بطاقة البنك/اليومية المعنية في لوحة تحكم المحاسبة في Odoo لتعكس حركات Darbpay في الرصيد وقسم "Misc. operations".

من هذه النقطة فصاعدًا، تتدفّق مصاريف Darbpay بشكل طبيعي إلى تقارير Odoo القياسية (دفتر الأستاذ، ميزان المراجعة، قائمة الدخل، وغيرها) دون خطوات إضافية.

الأسئلة الشائعة (FAQs)

هل يقوم Darbpay بمزامنة المورّدين من Odoo؟

لا. لا يقوم Darbpay بإنشاء أو تعديل أو مزامنة بيانات المورّدين الأساسية من Odoo.

بدلاً من ذلك، يرسل Darbpay بيانات على مستوى المعاملة مثل:

• اسم التاجر

• رقم ضريبة التاجر / رقم التسجيل الضريبي (VAT / TRN) عند توفره

• بيانات أخرى ذات صلة بالتاجر

تُخزَّن هذه البيانات على كل قيد يومية أو سجلات داعمة له، بحيث تحصل على رؤية كاملة للمعاملة دون أن يقوم Darbpay بتغيير قائمة المورّدين في Odoo.

يمكنك الاستمرار في:

• إدارة المورّدين مباشرةً داخل Odoo

• استيراد أو تحديث المورّدين باستخدام أدوات Odoo

• ربط المصروفات بالمورّدين داخل Odoo إذا كانت سياساتك المحاسبية تتطلّب ذلك

هل أحتاج إلى إعداد معدلات ضريبة القيمة المضافة يدويًا داخل Darbpay؟

لا. يقوم Darbpay باستيراد رموز الضريبة مباشرةً من Odoo أثناء معالج الإعداد.

باختصار:

1. اربط نسخة Odoo الخاصة بك (الرابط، قاعدة البيانات، البريد الإلكتروني، مفتاح الـ API).

2. اضغط Import tax codes من صفحة تكامل Odoo في Darbpay.

3. اختر رموز الضريبة في Odoo التي تسمح لـ Darbpay باستخدامها.

بعد ذلك يتم استخدام هذه الرموز تلقائيًا عندما يرحّل Darbpay المصروفات إلى Odoo، مع إبقاء Odoo المصدر الأساسي لضريبة القيمة المضافة.

هل يمكنني التحكّم في الحسابات التي يستخدمها Darbpay داخل Odoo؟

نعم.

من صفحة تكامل Odoo ومعالج الإعداد يمكنك:

• ربط محافظ/بطاقات Darbpay بالحساب البنكي أو حساب التسوية الصحيح في Odoo.

• اختيار حسابات المصروف (GL) التي يجب على Darbpay استخدامها لكل فئة مصروف.

أي تغييرات تقوم بها على هذه العلاقات تؤثّر على عمليات التصدير المستقبلية فقط.
أما قيود اليومية التي تم إنشاؤها سابقًا في Odoo فلن يتم تعديلها تلقائيًا.

كل متى تتم المزامنة بين Darbpay و Odoo؟

يمكنك:

• تفعيل المزامنة التلقائية وفق جدول زمني (مثلاً مرة يوميًا)، و/أو

• استخدام المزامنة اليدوية لدفع البيانات فورًا من صفحة تكامل Odoo.