إعداد ترحيل قيود الرواتب إلى أودو: خطوة بخطوة

1. قبل أن تبدأ

2. في أودو: أنشئ مفتاح API واعرف اسم قاعدة البيانات

سجّل الدخول إلى أودو بالمستخدم الذي سيُستخدم في الربط. أسماء القوائم أدناه بالإنجليزية كما في توثيق أودو للإصدارات 17 و18 و19 (17، 18، 19).

1. افتح قائمة المستخدم (اسمك أو صورتك أعلى الشاشة) واختر Preferences (أو My Profile في بعض الإصدارات).
2. افتح تبويب Account Security واضغط New API Key، وسيطلب أودو كلمة المرور للتأكيد.
3. في خانة Description اكتب وصفًا تعرفه لاحقًا، مثل AhlanHamad payroll.
4. في أودو 18 و19 اختر أيضًا مدة المفتاح Duration، واختر أطول مدة يعرضها أودو عليك؛ ويستطيع مسؤول أودو اختيار مفتاح دائم Persistent Key لا تنتهي صلاحيته. أودو 17 لا يطلبها.
5. اضغط Generate Key وانسخ المفتاح فورًا، فأودو يعرضه مرة واحدة فقط. إن ضاع منك فاحذفه وأنشئ مفتاحًا جديدًا.
6. دوّن اسم الدخول (Login) للمستخدم، وهو غالبًا بريد إلكتروني، ويظهر في Settings ← Users.

اسم قاعدة البيانات

• على odoo.com: هو الجزء الأول من عنوان أودو لديكم. فإذا كان العنوان https://mycompany.odoo.com فاسم قاعدة البيانات mycompany (توثيق أودو).
• على Odoo.sh: قاعدة بيانات الفرع الذي تمسكون عليه الدفاتر (عادةً فرع الإنتاج)، وتظهر في مشروعكم على Odoo.sh. اسألوا شريك أودو إن لم تكونوا متأكدين.
• على خادمكم الخاص: قاعدة البيانات التي تسجّلون الدخول إليها. اسألوا المسؤول عن الخادم.

3. في أهلاً حمد: اربط أودو

1. افتح التكاملات ثم أودو لتخطيط الموارد، وابقَ على تبويب الاتصال.
2. رابط نظام أودو: العنوان الذي تفتحون به أودو، مثل https://mycompany.odoo.com. إن لم تكتبوا https:// يُضاف تلقائيًا، وإن لصقتم عنوان صفحة داخل أودو (مثل …/odoo/action-123) يُختصر إلى عنوان الخادم. أما عنوان http://، أو عنوان لا يعمل إلا داخل شبكة المكتب، فيُرفض مع رسالة توضّح السبب (القسم 7).
3. اسم قاعدة البيانات: الاسم من القسم 2.
4. اسم الدخول إلى أودو (البريد الإلكتروني): البريد الذي تسجّلون به الدخول إلى أودو، وهو المستخدم نفسه الذي أُنشئ له مفتاح API. يحتاجه أودو 17 و18.
5. مفتاح API: الصقوا المفتاح من القسم 2 (وليس كلمة مرور أودو). وتذكّركم الملاحظة تحت هذه الخانة بأن مفاتيح أودو قد تنتهي صلاحيتها.
6. الواجهة: اتركها على اكتشاف تلقائي، ولا تغيّرها إلا إذا فشل الاتصال لأن الخادم يخفي إصداره.
7. اضغط الاتصال بأودو. إن نقصت خانة أو كان العنوان خاطئًا تُذكر لكم الخانة. وإلا يظهر على الزر التحقق من الاتصال بينما نقرأ إصدار أودو ونختبر المفتاح.

عند النجاح تظهر رسالة تم الاتصال بنجاح مع اسم شركتكم في أودو، وتعرض البطاقة متصل بنظام أودو ورابط النظام واسم قاعدة البيانات والواجهة المستخدمة: JSON-2 · أودو 19.0 في أودو 19 وما بعده، أو JSON-RPC (قديمة) · أودو 18.0 (أو 17.0) في الإصدارات الأقدم. يُحفظ المفتاح مشفّرًا ولا يُعرض مرة أخرى، وتكرر البطاقة ملاحظة انتهاء صلاحية المفتاح.

4. اختر الشركة ودفتر اليومية، ثم اربط الحسابات

1. افتح تبويب ربط الحقول، وعنوان البطاقة ترحيل قيود الرواتب إلى أودو.
2. اضغط تحميل حساباتي لقراءة دليل الحسابات والشركات ودفاتر اليومية من أودو.
3. إذا كان مستخدم أودو يصل إلى أكثر من شركة، فاختر الشركة من اختر الشركة. بعدها تعرض البطاقة الترحيل إلى تلك الشركة والعملة الأساسية.
4. من دفتر يومية أودو اختر دفتر اليومية المتنوعة الذي تُرحَّل فيه القيود. لا تظهر إلا دفاتر النوع Miscellaneous. ولإضافة دفتر «الرواتب» أنشئه في أودو أولًا (Accounting ← Configuration ← Journals ← New، والنوع Miscellaneous)، ثم اضغط إعادة تحميل الحسابات.
5. اربط كل حساب أهلاً حمد بـحساب أودو (الجدول أدناه). بعض الحسابات تُختار مسبقًا وتظهر عليها كلمة مقترح حين تكون المطابقة واضحة، فراجعوها كلها مع محاسبكم.
6. اضغط حفظ الربط. حين لا ينقص شيء تقول البطاقة اكتمل الربط، وقبل ذلك تقول: «الترحيل متوقف حتى تُربط كل الحسابات المطلوبة.»
7. إذا كنتم تصرفون أي رواتب بعملة غير عملة شركتكم في أودو، فقرّروا بشأن ترحيل المسيرات بعملات أخرى (القسم 5).

أي حساب في أودو لكل حساب رواتب

• التكاليف إلى حسابات المصروفات (النوع Expenses في أودو).
• المبالغ المستحقة عليكم إلى الالتزامات المتداولة (النوع Current Liabilities). ومخصص نهاية الخدمة هو الالتزام طويل الأجل الوحيد.
• لا يمكن اختيار حسابات الذمم المدينة والدائنة (النوعان Receivable وPayable)، فهي تظهر باهتة: يتطلب أودو عميلًا أو موردًا في كل سطر يُرحَّل إليها، وقيود الرواتب تُرحِّل الإجماليات فقط. استخدموا بدلًا منها حساب التزامات متداولة مثل «رواتب مستحقة».
• قيد الدفع إلى الحساب البنكي أو إلى حساب وسيط. إذا كنتم تستوردون كشوف البنك إلى أودو، فاربطوا 1101 بحساب وسيط (مثل حساب Outstanding Payments في أودو، أو حساب جديد «وسيط الرواتب» مع تفعيل Allow Reconciliation) وطابقوا سطر كشف البنك معه، حتى لا يُخصم رصيد البنك مرتين. وإن كنتم لا تستوردون الكشوف فالحساب البنكي نفسه مناسب.

5. ماذا يُرحَّل، ومتى

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

6. راجع أول مسيّر رواتب في أودو

1. في أهلاً حمد افتح مسيّر الرواتب. تعرض بطاقة قيود أودو كل قيد (استحقاق الرواتب، دفع الرواتب، …) وحالته. مُرحَّل تعني أن القيد وصل إلى أودو، وتعرض البطاقة رقم القيد في أودو، مثل MISC/2026/10/0001.
2. في أودو اذهب إلى Accounting ← Accounting ← Journal Entries (قوائم أودو).
3. اكتب رقم القيد، أو AH، في خانة البحث واختر Search Journal Entry for: …، فهو يبحث في أرقام القيود ومراجعها.
4. افتح القيد وتأكد من: دفتر اليومية الذي اخترتموه، والتاريخ (آخر يوم في شهر الرواتب لقيد الاستحقاق)، والحالة Posted، وسطر لكل حساب مربوط، وأن المجاميع تطابق مسيّر الرواتب في أهلاً حمد.
5. بعد دفع المسيّر راجعوا قيد دفع الرواتب بالطريقة نفسها، وطابقوه مع البنك كما في القسم 4.

7. حل المشكلات

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

عند الربط (تبويب الاتصال)

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

في مسيّر الرواتب: متوقف

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

في مسيّر الرواتب: فشل

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

نظاما محاسبة

إذا ظهر في صفحة أودو أو في المسيّر «تُرحَّل قيود الرواتب إلى …» مع أكثر من نظام، فكل مسيّر يُسجَّل في كل نظام منها. إن كنتم تمسكون دفاتركم في أودو فقط، فافصلوا الأنظمة الأخرى حتى لا تُحتسب تكاليف الرواتب مرتين.

8. فصل الربط

1. في أهلاً حمد افتح التكاملات ← أودو لتخطيط الموارد ← الاتصال واضغط قطع اتصال أودو، فيُحذف المفتاح المحفوظ.
2. في أودو احذف المفتاح أيضًا: Preferences ← Account Security، ثم أزل مفتاح أهلاً حمد.

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

مصادر أودو المستخدمة في هذا الدليل

• الواجهة الخارجية لأودو 17 ولأودو 18: مفاتيح API والباقات واسم قاعدة البيانات.
• واجهة JSON-2 لأودو 19: مدة المفاتيح والمستخدمون المخصصون.
• شيفرة أودو 18: مدة مفاتيح API، وقوائم المحاسبة، وأنواع الحسابات.
• أودو (Odoo) علامة تجارية لمالكها، ولا ترتبط أهلاً حمد بشركة أودو.