# Zoho Books + Krokul CRM

Так. Krokul CRM інтегрується з Zoho Books, обліковим застосунком. Компанії-клієнти стають клієнтами (customers) Zoho Books, а комерційні пропозиції Krokul стають estimates. Виставлені рахунки йдуть у Zoho Books, а оплати клієнтів, записані там, закривають рахунок в угоді. Шлях іде через застосунок Krokul у Zapier, Make, n8n і Albato або через API й вебхуки Krokul.

**Статус:** Через API і вебхуки. **Платформи автоматизації:** Zapier, Make, n8n, Albato.

## Що отримує команда

### Клієнта створено один раз, і він працює в кожному рахунку

Нова компанія-клієнт у Krokul стає контактом Zoho Books типу customer із платіжною адресою, поштою й валютою. ID контакта Zoho Books лишається на компанії-клієнті. Кожен estimate і кожен рахунок для цього клієнта йде на того самого customer.

### Пропозиція в Krokul, estimate у Zoho Books

Комерційна пропозиція, виставлена в Krokul, записується в Zoho Books як estimate з тими самими позиціями й цінами. Якщо ваша команда надсилає документи поштою із Zoho Books, клієнт отримує estimate звідти, а пропозиція в Krokul зберігає номер estimate.

### Рахунок із виграної угоди

Коли угоду виграно й рахунок виставлено, конектор створює рахунок у Zoho Books для привʼязаного клієнта. Позицію, якої в Zoho Books немає, конектор спершу створює з каталогу Krokul з тією самою назвою й ціною.

### Зміни рахунку повертаються в Krokul

Правило workflow у Zoho Books для рахунків викликає адресу вебхука Krokul зі сторінки конектора із секретним токеном. Коли рахунок редагують, анулюють чи оплачують, Krokul читає його через API й оновлює статус рахунку на угоді.

### Оплати клієнтів на угоді

Krokul читає оплати клієнтів (customer payments) із Zoho Books і записує кожну проти рахунків, до яких її застосовано. Борг компанії-клієнта в Krokul збігається із Zoho Books, а `invoice.paid` спрацьовує, коли рахунок покрито.

## Що передається між системами

| Zoho Books | Krokul | Напрям | Коли |
|---|---|---|---|
| Contact (customer) | Компанія-клієнт | Krokul → Zoho Books | Компанію-клієнта створено чи змінено |
| Item | Товар чи послуга | Krokul → Zoho Books | Перед першим рядком, де він потрібен |
| Estimate | Комерційна пропозиція (документ) | Krokul → Zoho Books | У Krokul виставлено пропозицію |
| Invoice | Рахунок (документ) | Krokul → Zoho Books | У Krokul виставлено рахунок |
| Invoice (вебхук правила workflow) | Статус рахунку на угоді | Zoho Books → Krokul | Рахунок редагують, анулюють чи оплачують |
| Customer payment | Факт оплати за рахунком | Zoho Books → Krokul | У Zoho Books записано оплату |

## Як підключити сьогодні

### Застосунок Krokul у Zapier, Make, n8n чи Albato

1. Підключіть застосунок Krokul ключем API Krokul.
2. Візьміть тригер Krokul, наприклад Company Created чи Document Created, і дію Zoho Books, наприклад Create Customer, Create Item чи Create Sales Invoice.
3. У зворотний бік почніть із New Estimate чи New Sales Invoice у Zoho Books, коли документ, зроблений там, має з’явитися активністю на угоді Krokul.

### Власний потік через API й вебхуки Krokul

1. Дайте своїй інтеграції ключ API Krokul зі scope для компаній-клієнтів, документів і оплат.
2. Підпишіть вебхук на clientCompany.created і document.created і перевіряйте заголовок x-crm-signature кожної доставки своїм секретом.
3. Записуйте customer, estimate чи invoice через API Zoho Books у дата-центрі вашої організації, потім привʼяжіть кожен ID із Zoho Books до запису Krokul через externalRef/api-upsert.
4. Коли правило workflow у Zoho Books повідомляє про оплату, викличте payment/api-create з cardUuid угоди, щоб рахунок у Krokul закрився.

**Тригери:** New Customer; New Estimate; New Sales Invoice; New Item; New Expense.

**Дії:** Create Customer; Create Estimate; Create Sales Invoice; Create Item.

### Для інтеграторів

Вебхуки Zoho Books підтримують POST, PUT чи DELETE, типовий payload у JSON і секретний токен, а невдалий виклик Zoho Books повторює. Двері вебхуків Krokul перевіряють цей токен, перш ніж ставити щось у чергу. Для власного коду Krokul дає публічний API з Bearer-ключем, підписані вихідні вебхуки з журналом доставок і `externalRef/api-upsert`, який пише запис за його ID у Zoho Books без попереднього пошуку.

[Документація API](https://app.krokul.com/api/v1/docs)

## Питання й відповіді

### Чи інтегрується Krokul із Zoho Books?

Так. Krokul інтегрується із Zoho Books через застосунок Krokul у Zapier, Make, n8n і Albato, а також через свої API й вебхуки.

### Чи важливо, який дата-центр Zoho Books використовує мій акаунт?

Zoho Books має окремі домени API для регіонів, наприклад .com, .eu чи .in. Конектор визначає регіон під час входу й викликає відповідний домен, тож задавати його руками не треба.

### Навіщо Zoho Books потрібне правило workflow?

Zoho Books надсилає вебхуки з правил workflow, які ви створюєте в його налаштуваннях. Правило для рахунків одразу повідомляє Krokul про зміни, а оплати клієнтів ще й читаються за розкладом, тож ніщо не залежить від одного каналу.

### Які записи Krokul надсилає в Zoho Books?

Клієнтів, позиції, estimates і рахунки. Оплати клієнтів і статус рахунків ідуть у зворотний бік, із Zoho Books у Krokul.

## Обмеження

Рахунки постачальників, витрати, банк і податкова звітність лишаються в Zoho Books. Конектор викликає API Zoho Books у тому дата-центрі, де живе ваша організація, тож облікові дані лишаються в регіоні, який ви вибрали в Zoho.

## Пов’язані сервіси

- [Xero](https://krokul.com/uk/integrations/xero/index.md)
- [QuickBooks Online](https://krokul.com/uk/integrations/quickbooks-online/index.md)
- [FreshBooks](https://krokul.com/uk/integrations/freshbooks/index.md)
- [Sage Accounting](https://krokul.com/uk/integrations/sage-accounting/index.md)
- [NetSuite](https://krokul.com/uk/integrations/netsuite/index.md)

[Облік і бухгалтерія](https://krokul.com/uk/integrations/category/accounting/index.md)

Zoho Books є торговою маркою Zoho Corporation. Krokul не афілійований із Zoho Corporation.

Оновлено: 2026-10-15

---

Застосунок: https://app.krokul.com/ · API: https://app.krokul.com/api/v1/docs
