# FreshBooks + Krokul CRM

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

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

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

### Один запис клієнта в обох системах

Контрагент, створений у Krokul, стає клієнтом FreshBooks. Коли хтось редагує клієнта у FreshBooks, вебхук `client.update` повідомляє Krokul, і конектор читає запис та оновлює компанію. Кожна сторона зберігає ID іншої.

### Спершу кошторис, рахунок після згоди

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

### Оплата, записана у FreshBooks

Коли клієнт оплачує рахунок у FreshBooks, приходить вебхук `payment.create` з ID оплати. Krokul читає оплату, знаходить рахунок за його ID у FreshBooks і записує факт оплати в угоду.

### Перекази, записані в Krokul

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

### Години з FreshBooks лягають на проєкт Krokul

У налаштуваннях конектора звʼяжіть проєкт FreshBooks з відповідним проєктом Krokul. Кожен новий запис часу додає туди ті самі години, тож звіт про години й акт для клієнта спираються на справжні числа.

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

| FreshBooks | Krokul | Напрям | Коли |
|---|---|---|---|
| Client | Контрагент | Krokul ↔ FreshBooks | Створено в Krokul; змінено в будь-якій системі |
| Estimate | Комерційна пропозиція (документ) | Krokul → FreshBooks | Пропозицію виставлено в Krokul |
| Invoice | Рахунок (документ) | Krokul → FreshBooks | Рахунок виставлено в Krokul |
| Статус рахунку | Статус рахунку в угоді | FreshBooks → Krokul | Вебхук `invoice.update` |
| Payment | Факт оплати на рахунку | FreshBooks ↔ Krokul | Вебхук `payment.create` або оплата, записана в Krokul (один власник на підключення) |
| Time entry | Години на привʼязаному проєкті | FreshBooks → Krokul | У FreshBooks створено запис часу |

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

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

1. Підключіть застосунок Krokul із ключем API Krokul.
2. Зʼєднайте тригер Krokul, наприклад Deal Won, з дією FreshBooks, наприклад Create Project чи Send Estimate.
3. Від тригерів FreshBooks на кшталт New Project чи New Time Entry ведіть до дій Krokul, наприклад Create Task чи Log Hours.

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

1. Дайте своєму потоку ключ API Krokul із правами лише на контрагентів, документи, оплати й проєкти.
2. Зареєструйте вебхук Krokul на clientCompany.created і document.created і перевіряйте кожну доставку за заголовком x-crm-signature.
3. Створіть клієнта й рахунок через API FreshBooks і збережіть обидва ID у записах Krokul через externalRef/api-upsert.
4. Коли FreshBooks повідомляє payment.create, запишіть оплату через payment/api-create з cardUuid угоди. Записи часу йдуть у проєкт через project/api-logHours.

**Тригери:** New Client; New Estimate; New Invoice; Updated Invoice; New Invoice Payment; New Project; New Time Entry.

**Дії:** Create or Update Client; Create Estimate; Send Estimate; Create Invoice; Send Invoice; Add Payment to Invoice; Create Project.

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

Вебхуки FreshBooks охоплюють клієнтів, кошториси, рахунки, оплати, проєкти й записи часу, а на всі події ресурсу можна підписатися за його назвою, наприклад `invoice`. Кожне сповіщення несе назву події й ID обʼєкта, а підписує його verifier, отриманий під час реєстрації. Інтеграторам Krokul дає публічний API, вебхуки з підписом HMAC-SHA256 і `x-crm-delivery` для дедуплікації, зовнішні ключі для компаній, товарів, угод і документів, а також тестову компанію (пісочницю).

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

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

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

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

### У який бік мають іти оплати?

Кожне підключення має одного власника оплат. Якщо клієнти оплачують рахунки FreshBooks онлайн, оплатами володіє FreshBooks, а Krokul їх читає. Якщо ваша команда спершу записує перекази в Krokul, власником є Krokul, і він надсилає кожну оплату у FreshBooks.

### Чи можна списувати записи часу FreshBooks на проєкти Krokul?

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

### Як швидко зміни у FreshBooks доходять до Krokul?

FreshBooks надсилає вебхук, коли запис змінюється. Сповіщення містить лише ID, тож потік-отримувач читає запис з API FreshBooks. У зворотний бік Krokul надсилає свій вебхук одразу, щойно сталася подія.

## Обмеження

Витрати, рахунки постачальників, бухгалтерські звіти й зарплата лишаються у FreshBooks. У кожному підключенні в оплат один власник. Або FreshBooks записує оплату, а Krokul її читає, або Krokul записує оплату й надсилає її у FreshBooks.

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

- [QuickBooks Online](https://krokul.com/uk/integrations/quickbooks-online/index.md)
- [Xero](https://krokul.com/uk/integrations/xero/index.md)
- [Zoho Books](https://krokul.com/uk/integrations/zoho-books/index.md)
- [Sage Accounting](https://krokul.com/uk/integrations/sage-accounting/index.md)
- [Stripe](https://krokul.com/uk/integrations/stripe/index.md)

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

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

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

---

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