Кастомная интеграция Zoho CRM и Zoho Books: когда стандартных решений недостаточно
Интеграция Zoho CRM и Zoho Books — задача, которая вроде бы уже решена внутри самой экосистемы Zoho. Есть стандартные подключения, автоматическая синхронизация контактов и инвойсов. Но на практике часто возникают сценарии, где этого недостаточно:
- В счет нужно передавать дополнительные поля.
- Требуется особая логика работы с валютами.
- Клиент хочет, чтобы передавались только активные контакты или специфические товары.
- Необходимо выбирать, когда именно создавать инвойс, и делать это вручную через кнопку.
В таких случаях на помощь приходит Deluge и Zoho API. Сегодня я покажу, как можно реализовать передачу счета из модуля Invoices в Zoho CRM напрямую в Zoho Books, по собственному сценарию. Код полностью готов к использованию — вы можете скопировать его, настроить под себя и внедрить.
Что делает скрипт?
- Получает данные инвойса из Zoho CRM по ID.
- Ищет контакт в Zoho Books по имени клиента.
- Подбирает товар по названию и валюту по ISO-коду.
- Формирует структуру line_items для Zoho Books.
Создаёт новый инвойс в Zoho Books с нужными полями.
Что нужно знать перед использованием
- Скрипт использует Deluge и выполняется в функции кнопки.
- Подключения (connection:"crm" и connection:"books") должны быть настроены заранее через Zoho Connections.
- Указан organization_id вашей организации в Zoho Books — его нужно получить из настроек и заменить на свой.
- Работает с полями из стандартного модуля Invoices, при необходимости адаптируйте под свою структуру.
Как подключить
- Настройте соединения (crm и books) в разделе Connections.
- Замените organization_id и currency_id на ваши.
- Добавьте функцию как кнопку на модуле Invoices.
- Убедитесь, что у товаров в CRM указано корректное имя и цена.
Если не справляетесь самостоятельно
Интеграция Zoho CRM и Books через Deluge даёт полный контроль над процессом. Такой подход особенно полезен, когда стандартная интеграция не учитывает вашу бизнес-логику. Код из этой статьи вы можете адаптировать под любые задачи: учёт налогов, кастомные статусы, дополнительную проверку и т.д.
Если вам нужно более сложное решение или интеграция с другими Zoho-продуктами — напишите нам. Мы помогаем компаниям настраивать Zoho под реальный бизнес, а не наоборот.