دليل الإعداد · قيود الرواتب إلى زوهو بوكس · وصول مبكر
إعداد ترحيل قيود الرواتب إلى زوهو بوكس: خطوة بخطوة
هذا الدليل لشخصين يعملان معًا: مسؤول زوهو بوكس، الذي ينشئ عميل Zoho API ويعرف دليل الحسابات، والمسؤول عن الرواتب في أهلاً حمد، الذي يربط زوهو بوكس ويربط الحسابات. اتبعوا الخطوات بالترتيب، وكل اسم زر أو حقل من أهلاً حمد مذكور هنا هو نفسه الظاهر على الشاشة.
آخر تحديث: 12 أكتوبر 2026
1. قبل أن تبدأ
وصول مبكر. نفعّل ترحيل قيود الرواتب إلى زوهو بوكس لكل شركة على حدة عند طلبها، وهو غير متاح لكل الشركات بعد. وإلى أن يُفعَّل لشركتكم، يقول تبويب ربط الحقول: «ترحيل قيود الرواتب إلى زوهو بوكس غير مفعّل لمساحة عملك بعد.»
| البند | المطلوب |
|---|---|
| باقة زوهو بوكس | باقة فيها القيود اليومية والوصول إلى الواجهة البرمجية. تذكر صفحة أسعار Zoho خاصية API Access ابتداءً من باقة Standard (الباقة المجانية فيها القيود، لكن الوصول البرمجي غير مذكور لها هناك)، لذا استخدموا Standard أو أعلى (أسعار Zoho Books). وتحدّ Zoho عدد الطلبات اليومية بحسب الباقة (Standard ألفا طلب)، وقيود رواتب الشركة لا تستهلك إلا القليل. |
| أين وصلنا | جُرّب الربط من البداية إلى النهاية على منظمة زوهو بوكس فعلية واحدة في مركز بيانات zoho.ae (بالدرهم): استحقاق الرواتب، ودفع الرواتب، وقيد متوقف أُرسل بعد ربط حسابه، وعكس مسيّر محذوف. لم يُجرَّب بعد في zoho.sa ولا في مراكز البيانات الأخرى، ولا لدى عميل، ولم يُجرَّب الربط بنقرة واحدة (القسم 3) بعد على حساب زوهو فعلي، لذا راجعوا أول القيود بعناية وأبلغونا إن لاحظتم أي خلل. |
| مركز بيانات زوهو لديكم | النطاق الذي تسجّلون الدخول منه إلى زوهو: zoho.com أو zoho.sa أو zoho.ae أو zoho.eu أو zoho.in أو zoho.com.au أو zoho.jp أو zohocloud.ca. انظروا إلى شريط العنوان وأنتم داخل زوهو بوكس (واجهة Zoho Books). والحسابات المفتوحة في الكويت وقطر والبحرين وعُمان تكون عادة على zoho.com. |
| العملة والكسور العشرية | تُرحَّل القيود بـالعملة الأساسية للمنظمة. ويحتفظ زوهو بوكس لكل عملة بعدد خاناتها العشرية كما تضبطه منظمتكم (Settings ← Currencies، مساعدة Zoho)، فللدينار الكويتي والبحريني والريال العماني اضبطوها على 3، وإلا فقد تُقرَّب الخانة الثالثة. |
| مدير في زوهو بوكس | ينشئ عميل Zoho API ويسجّل الدخول ليوافق على الربط. |
| في أهلاً حمد | مدير للشركة يستطيع إدارة الإعدادات (لربط زوهو بوكس وحفظ ربط الحسابات)، والشخص الذي يعتمد الرواتب ويدفعها. ويُفضَّل أن يساعد محاسبكم في ربط الحسابات. |
لا يُرسل إلى زوهو بوكس إلا الإجماليات: سطر لكل حساب، ولا سطر لكل موظف أبدًا. تبقى الأسماء والأرقام الوظيفية والرواتب الفردية في أهلاً حمد (ولا يذكر وصف القيد إلا عدد الموظفين في المسيّر).
2. في زوهو: أنشئوا عميل Zoho API
يتصل أهلاً حمد بزوهو بوكس من خلال عميل تنشئه شركتكم في Zoho API Console ولا تستخدمه إلا لنفسها. (وحيث يكون الربط بنقرة واحدة عبر عميل أهلاً حمد مفعّلًا لمساحة عملكم، يمكنكم استخدامه بدلًا من ذلك وتخطّي هذا القسم؛ يشرح القسم 3 ذلك.) أنشئوا العميل في وحدة التحكم الخاصة بمركز بياناتكم أنتم، مثل api-console.zoho.com أو api-console.zoho.sa أو api-console.zoho.ae (Zoho: إعداد OAuth).
- سجّلوا الدخول إلى وحدة التحكم لمركز بياناتكم بحساب مدير زوهو بوكس.
- اضغطوا GET STARTED (أو ADD CLIENT إن كانت لديكم عملاء سابقون)، واختاروا Server-based Applications ← CREATE NOW.
- Client Name: مثل
AhlanHamad payroll. Homepage URL:https://ahlanhamad.com. Authorized Redirect URIs:https://ahlanhamad.com/auth/zoho-books/callbackكما هو تمامًا. ثم اضغطوا CREATE. - افتحوا تبويب Client Secret وانسخوا Client ID وClient Secret. تلصقونهما في القسم 3، ويحفظهما أهلاً حمد مشفّرين.
- إذا كان حسابكم في زوهو يصل إلى أكثر من منظمة في زوهو بوكس، فيمكنكم تدوين Organization ID للمنظمة التي تسجّلون فيها الرواتب (في زوهو بوكس اضغطوا اسم منظمتكم أعلى الشاشة ← Manage Organizations)، أو اختيارها في أهلاً حمد بعد تسجيل الدخول (القسم 3).
تريدون التجربة أولًا؟ العميل نفسه يعمل مع منظمة زوهو بوكس تجريبية أو مخصصة للاختبار في مركز البيانات نفسه. اربطوها أولًا، ثم أعيدوا الربط بمعرّف منظمتكم الفعلية.
3. في أهلاً حمد: اربط زوهو بوكس
اذهبوا إلى التكاملات وافتحوا زوهو بوكس، وابقوا على تبويب الاتصال. تبدأ البطاقة بـاربط عبر تطبيق زوهو الخاص بك، ومعها رابط إلى هذا الدليل.
بعميل زوهو الخاص بكم
- معرف العميل (Client ID) وسر العميل (Client Secret): الصقوا القيمتين من القسم 2.
- مركز بيانات زوهو: اختاروا النطاق الذي تسجّلون الدخول منه. يُختار مسبقًا بحسب دولة شركتكم (السعودية
zoho.sa، والإماراتzoho.ae، وغيرهماzoho.com)، فغيّروه إن كان مختلفًا. وتقول الملاحظة: «يتم تسجيل الدخول وكل اتصال بزوهو بوكس عبر مركز البيانات هذا.» - معرف المؤسسة: اتركوه فارغًا إن كانت لديكم منظمة واحدة في زوهو بوكس، فهو يُكتشف بعد تسجيل الدخول. وإن كانت لديكم عدة منظمات فأدخلوا المعرّف من القسم 2، أو اتركوه فارغًا واختاروا المنظمة بعد تسجيل الدخول.
- تأكدوا أن العنوان تحت عنوان إعادة التوجيه الذي تسجّله في تطبيقك هو نفسه الموجود في عميل زوهو.
- اضغطوا الاتصال بزوهو بوكس. يقول أهلاً حمد «تم بدء مصادقة زوهو — أكمل تسجيل الدخول في نافذة إعادة التوجيه» ويفتح زوهو.
- سجّلوا الدخول إلى زوهو ووافقوا على الوصول الذي يطلبه زوهو بوكس.
- تعودون إلى صفحة تقول تم الاتصال بـ Zoho Books، ثم إلى صفحة زوهو بوكس. وتعرض البطاقة متصل بزوهو بوكس، واسم المؤسسة، ومعرف المؤسسة، ومركز بيانات زوهو، و«مربوط عبر تطبيقك الخاص». وإن كان حسابكم يصل إلى عدة منظمات ولم تحددوا واحدة، تطلب البطاقة اختر منظمتك في Zoho Books («حسابك في Zoho يصل إلى أكثر من منظمة. اختر المنظمة التي تُرحَّل إليها قيود الرواتب. لن يُرحَّل شيء قبل أن تختار.»): اختاروها واضغطوا استخدم هذه المنظمة.
يبقى معرّف العميل والسر محفوظين. وإن ربطتم من جديد لاحقًا تقول البطاقة: «بيانات اعتماد تطبيقك محفوظة. اضغط «ربط» لتسجيل الدخول بها — لا حاجة لإدخالها مرة أخرى.» ولاستخدام عميل آخر اضغطوا استبدال بيانات الاعتماد.
أو بنقرة واحدة عبر تطبيق أهلاً حمد (حين يتوفر)
حيث يكون عميل أهلاً حمد الخاص بزوهو مفعّلًا لمساحة عملكم، يعرض تبويب الاتصال تحت النموذج أو اربط عبر تطبيق أهلاً حمد: «اربط بنقرة واحدة: تسجّل الدخول إلى Zoho، وتوافق على الوصول وتختار منظمتك في Zoho Books. لا حاجة إلى عميل Zoho API أو مفاتيح، ولا تحتاج إلى معرفة مركز بيانات Zoho الخاص بك — Zoho تخبرنا به.» مع ما سيصل إليه أهلاً حمد. اضغطوا اربط عبر تطبيق أهلاً حمد، وسجّلوا الدخول ووافقوا، واختاروا المنظمة إن طُلب منكم كما سبق. وبعدها تقول البطاقة «مربوط عبر تطبيق أهلاً حمد». ويبقى عميلكم الخاص الطريقة الأساسية للربط.
هل ترسلون الرواتب أصلًا إلى نظام محاسبة آخر؟ إذا كان نظام آخر مرتبطًا ويستقبل الرواتب، يسألكم أهلاً حمد أولًا: «ربط نظام محاسبة ثانٍ؟» فإن ربطتم زوهو بوكس أيضًا، يُرحَّل كل مسيّر إلى النظامين وتُسجَّل تكاليف الرواتب مرتين. وإن كنتم تنتقلون إلى زوهو بوكس، فاضغطوا إلغاء، وافصلوا النظام الآخر أولًا، ثم اربطوا زوهو بوكس.
4. اربط الحسابات
- افتحوا تبويب ربط الحقول، وعنوان البطاقة ترحيل قيود الرواتب إلى زوهو بوكس.
- يعرض مركز بيانات زوهو المركز الذي ربطتم فيه، مقفلًا: «محدّد من اتصالك بزوهو بوكس. لاستخدام مركز بيانات آخر، أعد ربط زوهو بوكس من تبويب الاتصال.»
- اضغطوا تحميل حساباتي لقراءة دليل الحسابات واسم المنظمة وعملتها الأساسية من زوهو بوكس. بعدها تعرض البطاقة الترحيل إلى منظمتكم والعملة الأساسية.
- اربطوا كل حساب أهلاً حمد بـحساب زوهو بوكس (الجدول أدناه). بعض الحسابات تُختار مسبقًا وتظهر عليها كلمة مقترح حين تكون المطابقة واضحة، فراجعوها كلها مع محاسبكم.
- اضغطوا حفظ الربط. حين لا ينقص شيء تقول البطاقة اكتمل الربط، وقبل ذلك تقول: «الترحيل متوقف حتى تُربط كل الحسابات المطلوبة.»
- إذا كنتم تصرفون أي رواتب بعملة غير العملة الأساسية لمنظمتكم في زوهو بوكس، فقرّروا بشأن ترحيل المسيرات بعملات أخرى (القسم 5).
أي حساب في زوهو بوكس لكل حساب رواتب
| الرمز | حساب أهلاً حمد | الحاجة | نوع الحساب المعتاد في زوهو بوكس |
|---|---|---|---|
| 5100 | الرواتب — الأساسي والبدلات الأخرى والعمل الإضافي والإضافات | مطلوب | Expense (مصروف) |
| 5400 | بدل السكن | مطلوب | Expense (مصروف) |
| 5500 | بدل النقل | مطلوب | Expense (مصروف) |
| 5200 | حصة صاحب العمل في التأمينات الاجتماعية | مطلوب | Expense (مصروف) |
| 5300 | مصروف مكافأة نهاية الخدمة | مطلوب | Expense (مصروف) |
| 2100 | صافي الرواتب المستحقة | مطلوب | Other Current Liability (التزام متداول آخر)، وليس Accounts Payable |
| 2200 | التأمينات الاجتماعية المستحقة (الموظف وصاحب العمل) | مطلوب | Other Current Liability (التزام متداول آخر) |
| 2300 | مخصص مكافأة نهاية الخدمة | مطلوب | Long Term Liability (التزام طويل الأجل) |
| 1101 | الحساب البنكي الذي تُدفع منه الرواتب | مطلوب | Bank، أو حساب وسيط (انظر النصيحة) |
| 2700 | الاستقطاعات المحتجزة (القروض والجزاءات والإجازات غير المدفوعة) | عند الاستخدام فقط | Other Current Liability (التزام متداول آخر) |
| 5810 | رسوم التحويل البنكي للرواتب | عند الاستخدام فقط | Expense (مصروف) |
| 5310 | اشتراك صاحب العمل في نظام DEWS (مركز دبي المالي العالمي) | عند الاستخدام فقط | Expense (مصروف) |
| 2310 | مستحقات نظام DEWS | عند الاستخدام فقط | Other Current Liability (التزام متداول آخر) |
| 5900 | أرباح/خسائر فروق العملة على الرواتب (فقط عند دفع مسير بعملة أخرى بسعر صرف مختلف) | عند الاستخدام فقط | حساب أرباح وخسائر الصرف لديكم |
- التكاليف إلى حسابات Expense.
- المبالغ المستحقة عليكم إلى حسابات Other Current Liability. ومخصص نهاية الخدمة هو الالتزام طويل الأجل الوحيد (Long Term Liability).
- لا يمكن اختيار حسابات الذمم الدائنة والذمم المدينة. ويوضح أهلاً حمد السبب: «لا يمكن اختيار حسابات الذمم الدائنة والذمم المدينة: يتطلب زوهو بوكس موردًا أو عميلًا في كل سطر يُرحَّل إليها، وقيود الرواتب تُرحِّل الإجماليات فقط. اختر حساب التزامات أو حسابًا وسيطًا بدلًا منها.»
- قيد الدفع إلى الحساب البنكي أو إلى حساب وسيط. إذا كانت حركات بنككم تصل إلى زوهو بوكس، فطابقوا دفعة الرواتب فيها مع القيد الذي رحّلناه بدل إضافتها من جديد، حتى لا يُخصم رصيد البنك مرتين. أو اربطوا 1101 بحساب «وسيط الرواتب» من نوع Other Current Liability، وصنّفوا دفعة البنك إليه.
مكافأة نهاية الخدمة ليست ضمن قيد الرواتب، بل لها قيد مستقل كل شهر (5300 مصروف مكافأة نهاية الخدمة / 2300 مخصص مكافأة نهاية الخدمة).
5. ماذا يُرحَّل، ومتى
| عندما يحدث هذا في أهلاً حمد | يصل إلى زوهو بوكس | بتاريخ |
|---|---|---|
| اعتماد مسيّر الرواتب (زر اعتماد) | استحقاق الرواتب: الرواتب والبدلات وحصة صاحب العمل في التأمينات والمبالغ المستحقة الناتجة عنها (مدين 5100–5500، ودائن 2100 و2200 و2700 عند الاستخدام) | آخر يوم في شهر الرواتب |
| دفع المسيّر (تأكيد الدفع أو اعتماد الرئيس التنفيذي والدفع) | دفع الرواتب: مدين 2100 صافي الرواتب المستحقة، ودائن 1101 | يوم اعتماد الدفع |
| تسجيل رسوم التحويل البنكي على مسيّر مدفوع | الرسوم البنكية: مدين 5810، ودائن 1101 | يوم الدفع |
| انتهاء الشهر | استحقاق مكافأة نهاية الخدمة: مدين 5300، ودائن 2300، ويُرسل تلقائيًا في اليوم الأول من الشهر التالي. ويمكن تشغيله يدويًا لشهر انتهى من صفحة المالية عبر تشغيل الاستحقاق الشهري. | آخر يوم في ذلك الشهر |
| حذف مسيّر، أو تصحيح قيد مُرحَّل | قيد عكسي: قيد جديد بالسطور نفسها مع تبديل المدين والدائن. لا يربط زوهو بوكس بين القيدين، لكن ملاحظات القيد العكسي تبدأ بعبارة Reversal of يليها المرجع الذي يعكسه. ثم يُرحَّل المسيّر المصحَّح من جديد كقيد جديد. | يوم التغيير |
- كل قيد هو قيد يدوي واحد (Manual journal) في زوهو بوكس، يُنشأ ثم يُنشر (Published، لا يبقى مسودة)، وفيه سطر لكل حساب (واجهة القيود في Zoho). وReference# هو علامتنا (
AHيليها 12 حرفًا ورقمًا)، وNotes تبدأ بالوصف وفيها عبارةPosted by Ahlan Hamad payroll.، ويعطيه زوهو رقمه الخاص Journal#. - لا نعدّل ولا نحذف أي قيد في زوهو بوكس، فالتصحيح دائمًا بقيود جديدة: القيد العكسي أولًا، ثم المسيّر المصحَّح كقيد جديد.
- كل قيد يُرسل مرة واحدة. وإذا انقطع الإرسال في منتصفه، تبحث المحاولة التالية عن القيد بعلامته بدلًا من إنشاء قيد ثانٍ.
- المبالغ بالعملة الأساسية لدفاتركم في زوهو بوكس. والمسيّر بعملة أخرى يبقى متوقفًا ما لم تفعّلوا ترحيل المسيرات بعملات أخرى، وعندها يُحوَّل بسعر الصرف اليومي في أهلاً حمد، ويُكتب السعر على القيد.
- المسيرات التي اعتُمدت أو دُفعت قبل حفظ ربط الحسابات لا تُرسل وحدها. افتحوا كل مسيّر واضغطوا إرسال قيود هذا المسير. وتعرضها بطاقة الربط تحت «مسيرات سابقة لم تُرسل إلى زوهو بوكس بعد».
- أشهر نهاية الخدمة المسجّلة قبل الربط تظهر في بطاقة الربط. اضغطوا إرسالها، وراجعوا قائمة الأشهر ومبالغها، ثم أكّدوا. تُرسل من الأقدم إلى الأحدث، وكل شهر بتاريخ نهايته.
يبدأ وصف كل قيد بنوعه وبمرجعه في أهلاً حمد: PAY-KW-2026-10 لاستحقاق رواتب الكويت لشهر أكتوبر 2026، وPAY-KW-2026-10-PMT لدفع تلك الرواتب، وPAY-KW-2026-10-FEES لرسومها البنكية، وIND-KW-2026-10 لاستحقاق نهاية الخدمة لذلك الشهر (ورمز الدولة هو رمز دولة المسيّر). ويبدأ وصف القيد العكسي بعبارة Reversal of يليها المرجع الذي يعكسه. ولكل قيد أيضًا علامة: AH يليها 12 حرفًا ورقمًا.
6. راجع أول مسيّر رواتب في زوهو بوكس
- في أهلاً حمد افتحوا مسيّر الرواتب. تعرض بطاقة قيود زوهو بوكس كل قيد (استحقاق الرواتب، دفع الرواتب، …) وحالته. مُرحَّل تعني أن القيد وصل إلى زوهو بوكس، وتعرض البطاقة رقم القيد في زوهو، مثل
25. - في زوهو بوكس افتحوا Accountant ← Manual Journals (مساعدة Zoho).
- ابحثوا عن القيد بذلك الرقم Journal#، أو بمرجعه Reference# (
AH…) وتاريخه. - افتحوه وتأكدوا من: الحالة Published، والتاريخ (آخر يوم في شهر الرواتب لقيد الاستحقاق)، وسطر لكل حساب مربوط، وأن المجاميع تطابق مسيّر الرواتب في أهلاً حمد، والملاحظات.
- بعد دفع المسيّر راجعوا قيد دفع الرواتب بالطريقة نفسها، وطابقوه مع البنك كما في القسم 4.
حالات القيد في بطاقة المسيّر: في الانتظار وجارٍ الإرسال (في الطريق)، بانتظار (يجب أن يصل قيد آخر إلى زوهو بوكس أولًا)، إعادة المحاولة (زوهو بوكس أو الشبكة مشغولة، ونعيد المحاولة تلقائيًا)، مُرحَّل، متوقف (يحتاج إليكم، ويظهر السبب)، فشل (رفضه زوهو بوكس، ويظهر السبب)، غير مطلوب (لا شيء يُرسل، ويظهر السبب).
7. حل المشكلات
يصل مديرو الشركة الذين يديرون الإعدادات، والمديرون الماليون، تنبيه داخل التطبيق وبريد إلكتروني حين تتوقف قيود زوهو بوكس أو تفشل: تنبيه واحد لكل مشكلة، وتذكير بعد ثلاثة أيام، وملاحظة قصيرة حين تُحل. لا يتضمن البريد مبالغ أو أسماء أو رسائل زوهو بوكس؛ افتحوا مسيّر الرواتب لمعرفة السبب.
عند الربط (تبويب الاتصال وصفحة العودة)
| ما يظهر لكم | ما العمل |
|---|---|
| أدخل معرّف العميل والسر الخاصين بتطبيقك للربط. | الصقوا القيمتين من تطبيقكم (في الربط بتطبيقكم الخاص فقط)، ثم اضغطوا زر الاتصال. |
| أدخل معرّف العميل والسر معًا لاستبدال بيانات الاعتماد المحفوظة. | بدأتم استبدال البيانات المحفوظة: املؤوا الحقلين معًا، أو اضغطوا الإبقاء على البيانات المحفوظة. |
| الربط غير متاح بعد: عنوان التطبيق لمساحة العمل هذه غير مُعدّ. تواصل مع الدعم وسنقوم بإعداده. | تواصلوا معنا، فلا خطأ من جهتكم. |
| تعذّر الاتصال بـ Zoho Books — مع «لم يتم إرجاع رمز تفويض. تم إلغاء الاتصال أو أن الرابط غير صالح.» | ألغيتم أو رفضتم في شاشة زوهو بوكس، أو فُتح الرابط مرتين. ابدؤوا من جديد من تبويب الاتصال. |
| تم تسجيل خروجك قبل اكتمال الاتصال. سجّل الدخول مرة أخرى، ثم أعد الربط من إعدادات التكامل. | سجّلوا الدخول إلى أهلاً حمد، ثم اضغطوا زر الاتصال من جديد، واستخدموا المتصفح نفسه طوال الخطوات. |
| This connection link is invalid, expired or already used. Start the connection again from the integration's settings page. | كل رابط ربط يعمل مرة واحدة ولوقت قصير. اضغطوا زر الاتصال من جديد في تبويب الاتصال. |
| Token exchange failed: … | رفض زوهو بوكس تسليم الربط: غالبًا لأن السر (Client Secret) غير صحيح، أو لأن عنوان إعادة التوجيه في تطبيقكم لا يطابق تمامًا. راجعوا الاثنين (في الربط بتطبيقكم الخاص)، ثم اربطوا من جديد. |
| No stored Zoho Books credentials for this company. Run Connect first. | لم تُحفظ مفاتيح عميلكم. الصقوا معرّف العميل والسر من جديد واضغطوا الاتصال بزوهو بوكس. |
| Zoho token error: … | رفض زوهو العميل: غالبًا لأنه أُنشئ في وحدة تحكم مركز بيانات غير مركز بيانات زوهو الذي اخترتموه. اختاروا مركز البيانات الذي فيه العميل (أو أنشئوا العميل في وحدة تحكم مركز بياناتكم)، ثم اربطوا من جديد. |
| يعرض زوهو صفحة خطأ بدل تسجيل الدخول، تذكر عنوان إعادة التوجيه (Redirect URI) | عنوان إعادة التوجيه في عميل زوهو لا يطابق. اضبطوا Authorized Redirect URIs على https://ahlanhamad.com/auth/zoho-books/callback كما هو تمامًا، ثم اربطوا من جديد. |
| حسابك في Zoho لا يصل إلى أي منظمة في Zoho Books. | مستخدم زوهو الذي سجّلتم الدخول به ليست لديه منظمة في زوهو بوكس في مركز البيانات هذا. سجّلوا الدخول بحساب مدير زوهو بوكس، أو راجعوا مركز البيانات، ثم اربطوا من جديد. |
| يلزم إعادة ربط Zoho Books — مع «لم يعد Zoho Books يقبل الربط المحفوظ: أُلغي الوصول أو انتهت صلاحيته. القيود معلّقة ولم تضع. اربط مجددًا من الأسفل وسجّل الدخول، وتُرسل القيود المعلّقة تلقائيًا.» | اضغطوا إعادة الربط وسجّلوا الدخول من جديد، فتُرسل القيود المعلّقة وحدها بعد عودتكم. |
عند تحميل الحسابات (تبويب ربط الحقول)
| ما يظهر لكم | ما العمل |
|---|---|
| Choose the Zoho Books data centre your account lives in, then load your accounts. | ربط أُجري قبل تسجيل مركز البيانات: اختاروه من مركز بيانات زوهو في بطاقة الربط، ثم تحميل حساباتي. |
| Zoho Books needs to be reconnected: access was revoked or has expired. Reconnect Zoho Books from Integrations. | اضغطوا إعادة الربط في تبويب الاتصال وسجّلوا الدخول إلى زوهو من جديد. |
| Zoho Books did not report the organisation's base currency. | تأكدوا من العملة الأساسية للمنظمة في زوهو بوكس (Settings ← Currencies)، ثم حمّلوا الحسابات من جديد. وإن تكرر ذلك فتواصلوا معنا. |
في مسيّر الرواتب: متوقف
القيد المتوقف ينتظر ولم يضع. عالجوا السبب فيُرسل، إما وحده أو عند الضغط على إعادة المحاولة في بطاقة المسيّر.
| ما يظهر لكم | ما العمل |
|---|---|
| اربط هذه الحسابات أولاً: 5400, 5500. | اربطوا رموز الحسابات المذكورة في تبويب ربط الحقول واضغطوا حفظ الربط، ثم إعادة المحاولة. |
| حمّل حساباتك واحفظ الربط في صفحة التكامل أولاً. | في تبويب ربط الحقول اضغطوا تحميل حساباتي، واحفظوا الربط، ثم إعادة المحاولة. |
| … مربوطة بحساب لا يصلح للقيود (ذمم دائنة أو مدينة، أو حساب نظام أو حساب بنكي، أو حساب بلا رمز). اختر حسابًا آخر في صفحة التكامل. | بمصطلحات زوهو بوكس: حساب Accounts Payable أو Accounts Receivable. اربطوا تلك الرموز بحساب Other Current Liability (أو حساب مناسب آخر)، واحفظوا، ثم إعادة المحاولة. |
| عملة هذا المسير تختلف عن عملة دفاترك. اسمح بالترحيل بعملات أخرى لإرساله. | فعّلوا ترحيل المسيرات بعملات أخرى في تبويب ربط الحقول، ثم إعادة المحاولة. أو أبقوا ذلك المسيّر خارج زوهو بوكس. |
| يحتاج الربط إلى تجديد. أعد الربط ثم حاول مرة أخرى. | توقف زوهو عن قبول الربط: حُذف العميل من وحدة التحكم، أو أُزيل الوصول من داخل زوهو، أو فقد المدير الذي وافق على الربط صلاحيته. اضغطوا إعادة الربط في تبويب الاتصال وسجّلوا الدخول من جديد (ويُستخدم العميل نفسه). القيود المتوقفة لهذا السبب تُرسل تلقائيًا بعد إعادة الربط. |
| غير مرتبط، أو الترحيل غير مفعّل. | اربطوا زوهو بوكس من جديد في تبويب الاتصال، فتُرسل القيود المتوقفة تلقائيًا بعد إعادة الربط. وإن كان زوهو بوكس مرتبطًا وما زالت الرسالة تظهر، فتواصلوا معنا: ربما أُوقف الترحيل لشركتكم. |
في مسيّر الرواتب: فشل
هذه الرسائل تعود من زوهو بوكس بالإنجليزية، وتليها كلمات زوهو بوكس نفسها. عالجوا السبب في زوهو بوكس أو في ربط الحسابات، ثم اضغطوا إعادة المحاولة. إعادة المحاولة لا تُنشئ قيدًا ثانيًا أبدًا.
| ما يظهر لكم | ما العمل |
|---|---|
| Zoho Books rejected the journal (400). تليها رسالة زوهو بوكس نفسها | اقرؤوا رسالة زوهو بعد رسالتنا (تبدأ برمز زوهو بين قوسين). من الأسباب الشائعة أن التاريخ يقع في فترة مقفلة (Accountant ← Transaction Locking، مساعدة Zoho)، فاطلبوا من المحاسب فتحها، أو اعكسوا المسيّر وصحّحوه في أهلاً حمد. |
| Zoho Books refused access (403). The connection may lack permission to post journals, or the organisation was disconnected — reconnect Zoho Books. | مستخدم زوهو بوكس الذي سجّلتم الدخول به لا يستطيع إنشاء القيود في تلك الشركة. أعيدوا الربط بمستخدم يملك الصلاحية (مدير)، ثم إعادة المحاولة. |
| Zoho Books could not find the company or an account this journal points at (404). Check the account mapping belongs to the connected company. | حُذف حساب مربوط أو أُرشف في زوهو بوكس. اضغطوا إعادة تحميل الحسابات، وصحّحوا الربط، واحفظوا، ثم إعادة المحاولة. |
| This run's payroll accrual journal did not reach Zoho Books. Retry the accrual first, then retry this payment, so it clears exactly the salaries payable the accrual booked. | أعيدوا محاولة سطر استحقاق الرواتب أولًا، ثم سطر دفع الرواتب. |
| No exchange rate from … to … is available. | حاولوا لاحقًا، أو تواصلوا معنا. |
| … — gave up after 6 attempts. | استمر فشل زوهو بوكس أو الشبكة. تأكدوا أن زوهو بوكس يعمل بشكل طبيعي، ثم اضغطوا إعادة المحاولة. |
| Created as a draft but not published: … | القيد موجود في زوهو بوكس كمسودة ورفض زوهو نشره، والسبب بعد النقطتين. عالجوه ثم إعادة المحاولة، فتُنشر المسودة نفسها ولا يُنشأ قيد ثانٍ. |
في مسيّر الرواتب: غير مطلوب
| ما يظهر لكم | معناه |
|---|---|
| Reversed in Ahlan Hamad before it reached Zoho Books; the pair nets to zero. | لا شيء مطلوب: القيد وعكسه يلغي أحدهما الآخر، فلا يُرسل أي منهما إلى زوهو بوكس. |
| Reverses an entry that never reached Zoho Books, so there is nothing to reverse there. | لا شيء مطلوب. |
نظاما محاسبة
إذا ظهر في صفحة زوهو بوكس أو في المسيّر «تُرحَّل قيود الرواتب إلى …» مع أكثر من نظام، فكل مسيّر يُسجَّل في كل نظام منها. إن كنتم تمسكون دفاتركم في زوهو بوكس فقط، فافصلوا الأنظمة الأخرى حتى لا تُحتسب تكاليف الرواتب مرتين.
8. فصل الربط
- في أهلاً حمد افتحوا التكاملات ← زوهو بوكس ← الاتصال واضغطوا قطع الاتصال بزوهو بوكس. يحذف أهلاً حمد الربط المحفوظ ويلغي وصوله لدى زوهو أيضًا.
- إن ربطتم بعميل زوهو الخاص بكم ولن تستخدموه مجددًا، فيمكنكم حذفه من Zoho API Console كذلك.
- القيود الموجودة في زوهو بوكس تبقى كما هي، فنحن لا نحذفها ولا نعدّلها.
- ما دام زوهو بوكس مفصولًا لا تُرسل قيود الرواتب الجديدة، وتقول بطاقة المسيّر: «زوهو بوكس غير مرتبط، لذا لا تُرسل القيود الجديدة.»
- إن ربطتم من جديد لاحقًا، فافتحوا كل مسيّر من تلك الفترة واضغطوا إرسال قيود هذا المسير، وأرسلوا أشهر نهاية الخدمة الظاهرة في بطاقة الربط.
مصادر زوهو المستخدمة في هذا الدليل
- Zoho Accounts: إنشاء عميل OAuth، ومراكز البيانات المتعددة.
- واجهة Zoho Books: المقدمة ومراكز البيانات ومعرّف المنظمة، والقيود.
- Zoho Books: الأسعار والباقات، والقيود اليدوية، وقفل المعاملات، والخانات العشرية.
- Zoho وZoho Books علامتان تجاريتان لشركة Zoho Corporation، ولا ترتبط أهلاً حمد بشركة Zoho.