# Chargebee + Krokul CRM

Так. Krokul CRM інтегрується з Chargebee і тримає одного власника білінгу на клієнта. Коли підпискою володіє Chargebee, виграна угода створює її в Chargebee, а Krokul читає статус, продовження, скасування й оплати. Коли нею володіє Krokul, договір Krokul виставляє рахунки за періоди, а Chargebee стягує їх зі збереженої картки. Зв’язка працює через застосунок Krokul у Zapier, Make, n8n чи Albato або через API і вебхуки Krokul.

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

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

### Chargebee веде білінг і отримує підписку з виграної угоди

Угода, виграна у воронці підписок, створює customer і subscription у Chargebee з цінами позицій (item prices), погодженими в угоді. Відтоді планом володіє Chargebee, а Krokul показує його на контрагенті лише для читання, зі статусом і датою наступного списання.

### Продовження, зміни й скасування Krokul читає з Chargebee

Вебхуки Chargebee, як-от `subscription_changed`, `subscription_renewed` і `subscription_cancelled`, оновлюють копію підписки в Krokul. Коли Chargebee планує скасування, Krokul ставить менеджеру клієнта задачу до дати завершення, а звіт MRR у Krokul враховує підписку з сумами, які тримає Chargebee.

### Krokul веде білінг, Chargebee стягує рахунок за період

Коли підписка живе в Krokul, договір виставляє рахунок за кожен період. Конектор створює відповідну разову копію в Chargebee для того самого клієнта, Chargebee списує кошти зі збереженої картки, а оплата потрапляє на рахунок Krokul як факт оплати.

### Оплати й невдалі списання в угоді

В обох варіантах `payment_succeeded` стає фактом оплати в Krokul, а `payment_failed` додає активність для відповідального за клієнта. Chargebee веде власну роботу з боргами, а менеджер бачить у Krokul, чому продовження під загрозою.

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

| Chargebee | Krokul | Напрям | Коли |
|---|---|---|---|
| Customer | Контрагент | Krokul → Chargebee | Перше виставлення рахунку клієнту |
| Subscription | Виграна угода з погодженим планом | Krokul → Chargebee | Угоду виграно (білінг веде Chargebee) |
| Статус підписки, продовження, скасування | Підписка лише для читання й MRR на клієнті | Chargebee → Krokul | `subscription_changed`, `subscription_renewed`, `subscription_cancelled` |
| Invoice | Рахунок за період за договором Krokul | Krokul → Chargebee | Договір виставляє рахунок за період (білінг веде Krokul) |
| Оплата (`payment_succeeded`) | Факт оплати на рахунку й угоді | Chargebee → Krokul | Списання пройшло |
| Невдала оплата (`payment_failed`) | Активність для відповідального за клієнта | Chargebee → Krokul | Списання не пройшло |

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

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

1. Підключіть застосунок Krokul ключем API Krokul.
2. Поєднайте тригер Krokul, як-от Deal Won, з дією Chargebee, як-от Create Subscription, або Deal Status Changed з Pause Subscription.
3. У зворотний бік почніть із тригера Chargebee, як-от New Payment чи Payment Failure, і завершіть дією Krokul, як-от Record Payment чи Add Activity.

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

1. Випустіть ключ API Krokul зі scope на угоди, контрагентів і оплати.
2. Зареєструйте вебхук на card.won через webhook/api-upsert з фільтром за воронкою підписок. Звіряйте заголовок x-crm-signature кожної доставки зі своїм секретом.
3. На цю подію створіть customer і subscription у Chargebee і збережіть ID з Chargebee на контрагенті й угоді через externalRef/api-upsert.
4. Спрямуйте вебхук Chargebee на свій приймач. payment_succeeded надсилайте в payment/api-create з cardUuid угоди, а payment_failed в activity/api-create.

**Тригери:** New Subscription; Subscription Activation; Subscription Cancellation; Subscription Cancellation Scheduled; New Invoice; New Payment; Payment Failure; New Customer.

**Дії:** Create Customer; Update Customer; Create Subscription; Update Subscription; Pause Subscription; Record Offline Payment for an Invoice.

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

Назва події Chargebee складається з ресурсу й події, наприклад `subscription_created`, `invoice_generated` чи `payment_succeeded`, і Chargebee повторює невдалу доставку вебхука. Конектор використовує ID події як ключ дедуплікації. На боці Krokul `card/api-create` приймає `externalId` і `externalSystem`, тож повторна подія повертає вже створену угоду, а виклик пісочниці дає порожню тестову компанію з ключем API.

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

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

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

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

### У Krokul є власні підписки. Хто виставляє рахунки клієнту?

Ви вибираєте для кожного клієнта. Коли власник Chargebee, підписку веде Chargebee, а Krokul її читає. Якщо власник Krokul, договір Krokul виставляє рахунки, а Chargebee тільки стягує оплату. В одного клієнта ніколи немає обох.

### Чи видно MRR з Chargebee в Krokul?

Так. Підписки, якими володіє Chargebee, входять у звіт MRR у Krokul із сумами, які тримає Chargebee, поруч із договорами, за якими Krokul виставляє рахунки сам.

### Чи може клієнт перейти від одного власника білінгу до іншого?

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

## Обмеження

Дві системи ніколи не виставляють рахунки одному клієнту одночасно. Конектор не запускає підписку Chargebee для клієнта з активним договором Krokul, і навпаки. Робота з боргами (dunning) і повторні спроби списання лишаються в Chargebee в обох варіантах.

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

- [Stripe](https://krokul.com/uk/integrations/stripe/index.md)
- [PayPal](https://krokul.com/uk/integrations/paypal/index.md)
- [GoCardless](https://krokul.com/uk/integrations/gocardless/index.md)
- [QuickBooks Online](https://krokul.com/uk/integrations/quickbooks-online/index.md)
- [Xero](https://krokul.com/uk/integrations/xero/index.md)
- [Avalara](https://krokul.com/uk/integrations/avalara/index.md)

[Платежі й банки](https://krokul.com/uk/integrations/category/payments/index.md)

Chargebee є торговою маркою її власника. Krokul не афілійований з Chargebee.

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

---

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