ربط Zoho Books

يربط بروكداك كل منشأة بحسابها في Zoho Books عبر عميل API تنشئه المنشأة بنفسها في وحدة تحكم Zoho. فتبقى صلاحية الوصول ملكا لمنشأتك، وتستطيع إلغاءها من Zoho في أي وقت.

أنشئ عميل API في Zoho

1. سجل الدخول إلى وحدة تحكم Zoho API بحساب يصل إلى منشأتك في Zoho Books. استخدم الموقع الخاص بمركز بياناتك إن كان حسابك خارج zoho.com، مثل api-console.zoho.sa للحسابات السعودية.
2. اختر Add Client ثم Server-based Applications. لا تختر Self Client، فهو لا يناسب هذا الربط.
3. اكتب اسما للعميل مثل «بروكداك»، وضع عنوان موقع منشأتك في Homepage URL.
4. انسخ عنوان إعادة التوجيه الذي تعرضه بطاقة Zoho Books في الإعدادات، والصقه في Authorized Redirect URIs كما هو.
5. احفظ العميل، ثم انسخ Client ID وClient Secret من تبويب Client Secret.

عنوان إعادة التوجيه هو:

https://procduck.com/api/integrations/zoho-books/callback

أدخل العميل واربط الحساب

1. افتح الإعدادات ← التكاملات في بروكداك، وانتقل إلى بطاقة Zoho Books.
2. اختر مركز البيانات الذي أنشأت فيه العميل، والصق معرّف العميل والرمز السري، ثم اختر احفظ العميل.
3. اختر اربط Zoho Books، ثم وافق على الصلاحيات في صفحة Zoho. يطلب بروكداك القراءة والإنشاء والتعديل فقط، ولا يطلب صلاحية الحذف.
4. إذا كان حسابك يصل إلى أكثر من منشأة في Zoho Books، فاختر المنشأة التي تريد المزامنة معها.

اختر ما ينتقل

كل اتجاه متوقف حتى تفعله. ولا ينتقل في أي اتجاه إلا ما أرخ في يوم البدء أو بعده، وهو يوم إدخال العميل افتراضيا ويمكنك تغييره.

• استيراد أوامر البيع، مع نسخ الأمر ومرفقاته: كل ساعة يصبح كل أمر بيع جديد في Zoho أمر بيع في بروكداك مرة واحدة، مع العميل والبنود والأسعار والتواريخ والملفات المرفقة. ولا تكتب تعديلات Zoho اللاحقة فوقه، ولا تستورد المسودات ولا الأوامر الملغاة. والأمر الذي صدرت فاتورته كاملة في Zoho يسجل مسلما بكل بنوده.
• استيراد أمر الشراء المرفق فقط: لا ينشأ شيء تلقائيا. في صفحة استيراد أوامر البيع تظهر قائمة «من Zoho Books»، فتحدد أمرا أو أكثر، أو تقرأ كل أمر لم يستورد منذ يوم تختاره (حتى 500 أمر في كل مرة)، فتقرأ المنصة ملفات PDF المرفقة بها كأي أمر شراء ترفعه، ثم تراجعها كلها في قائمة واحدة قبل إنشائها. والأمر الذي صدرت فاتورته كاملة في Zoho يسجل مسلما بكل بنوده عند إنشائه، وهذا يحتاج دور المشرف أو المالك.
• إرسال أوامر البيع إلى Zoho: تنشأ أوامر البيع الجديدة في Zoho وتحدث المعدلة منها. ولا ترسل إليه الأوامر المستوردة منه.
• إرسال عروض الأسعار المعتمدة كتقديرات: يرسل عرض السعر بعد بقائه معتمدا 24 ساعة، فلا يصل إلى Zoho عرض ألغي اعتماده أو حذف خلال اليوم. ويرسل مرة أخرى إذا عدل واعتمد من جديد.

تعمل المزامنة كل ساعة، ويشغلها زر زامن الآن فورا. وتعرض البطاقة نتيجة آخر تشغيل وكل سجل رفضه Zoho مع سببه. ولا يحذف بروكداك أي شيء في Zoho Books.

فصل الربط

اختر افصل الربط في البطاقة. يلغي بروكداك صلاحيته في Zoho ويحذف الرمز السري ورموز الدخول، ولا يحذف شيئا نسخ سابقا في أي من الجانبين. وإذا ربطت الحساب مرة أخرى فلن ينسخ أي سجل مرتين.