# QuickBooks Online + Krokul CRM

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

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

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

### Рахунок іде в QuickBooks із документа

Менеджер натискає кнопку надсилання в QuickBooks на рахунку Krokul, або з’єднання надсилає його саме, щойно рахунок виставлено. Спершу з’єднання створює Customer і відсутні Item, потім Invoice з тими самими рядками, податковими кодами й строком оплати. Invoice ID і DocNumber з QuickBooks лишаються на документі Krokul.

### Оплати, проведені в QuickBooks, доходять до угоди

Коли Payment створено чи змінено, QuickBooks надсилає Krokul підписаний вебхук. Одна Payment може закрити кілька рахунків, тому Krokul проводить окрему оплату-факт на кожен покритий рахунок, і кожну в ту угоду, до якої цей рахунок належить. Коли рахунок покрито повністю, іде подія `invoice.paid`, а борг компанії-клієнта зменшується.

### Анульований рахунок видно продажам

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

### Один клієнт, рахунки у двох валютах

QuickBooks закріплює валюту Customer після першої операції. Krokul тримає окремий Customer у QuickBooks на кожну пару «компанія-клієнт і валюта», тож і рахунок у EUR, і рахунок у USD тому самому клієнту проходять.

### Пропущені сповіщення наздоганяються

Якщо вебхук так і не дійшов, з’єднання за розкладом питає QuickBooks про свіжі зміни через Change Data Capture і застосовує пропущені оновлення Invoice і Payment.

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

| QuickBooks Online | Krokul | Напрям | Коли |
|---|---|---|---|
| Customer | Компанія-клієнт (окремо на кожну валюту) | Krokul → QuickBooks | Перед першим рахунком цьому клієнту |
| Item | Товар чи послуга | Krokul → QuickBooks | Перед першим рядком рахунку з цим товаром |
| Invoice | Рахунок (документ) | Krokul → QuickBooks | Надсилання вручну або автоматично під час виставлення |
| Залишок і статус рахунку | Оплачена сума й статус на документі | QuickBooks → Krokul | Рахунок змінено в QuickBooks |
| Анульований чи видалений Invoice | Анульований документ або розбіжність у журналі | QuickBooks → Krokul | Рахунок анульовано чи видалено |
| Payment | Оплата-факт на кожен рахунок в угоді | QuickBooks → Krokul | Оплату створено чи змінено |
| Об’єднаний Customer чи Item | Зовнішній ключ переходить на запис, що лишився | QuickBooks → Krokul | Записи об’єднано в QuickBooks |

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

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

1. Додайте застосунок Krokul у свій акаунт платформи й підключіть його ключем API Krokul.
2. Поєднайте тригер Krokul, наприклад Company Created чи Deal Won, із дією QuickBooks, наприклад Find or Create Customer, Create Invoice чи Send Invoice.
3. У зворотному напрямі почніть із тригера QuickBooks, наприклад New Payment, New Paid Invoice чи New Invoice Due, і візьміть дію Krokul, наприклад Record Payment чи Create Task.

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

1. Створіть у Krokul ключ API зі scope на компанії, документи й оплати.
2. Спрямуйте вебхук на свою адресу для document.created і card.won і звіряйте заголовок x-crm-signature кожної доставки зі своїм секретом.
3. Створіть Customer і Invoice через QuickBooks Online Accounting API, потім закріпіть обидва ID з QuickBooks за компанією й документом Krokul через externalRef/api-upsert.
4. Коли QuickBooks повідомляє про Payment, запишіть її через payment/api-create разом із cardUuid угоди, за якою стоїть рахунок.

**Тригери:** New Invoice; Updated Invoice; New Paid Invoice; New Invoice Due; New Payment; New Customer; Updated Customer; New Credit Memo.

**Дії:** Create Customer; Find or Create Customer; Create Invoice; Send Invoice; Void Invoice; Create Payment; Create Estimate; Create Product/Service.

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

Кожен запис, який синхронізує з’єднання, несе свій ID з QuickBooks зовнішнім ключем Krokul під системною назвою з `qbo.` та ID компанії в QuickBooks, тож ваш код знаходить його через `externalRef/api-resolve`. Публічний REST API, підписані вебхуки з журналом доставок і тестова компанія з ключем API дають розширити з’єднання, а саме з’єднання проходить перевірку на тестовій компанії Intuit до переходу в робочий режим.

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

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

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

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

### Яка система відповідає за суму рахунку?

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

### Як швидко оплата з QuickBooks доходить до Krokul?

У власному потоці QuickBooks надсилає на вашу адресу підписаний вебхук, коли Payment створено чи змінено, а ваш код проводить її в Krokul. Через застосунок Krokul затримка залежить від тригера QuickBooks на вашій платформі. Свій вебхук Krokul надсилає одразу, щойно сталася подія.

### Хто може надіслати рахунок у QuickBooks?

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

### Чи працює з’єднання з QuickBooks Desktop?

Ні. З’єднання працює через QuickBooks Online Accounting API. QuickBooks Desktop є окремим продуктом зі своєю моделлю інтеграції.

## Обмеження

Обліковою системою лишається QuickBooks Online: за нею сума рахунку, відкритий залишок і книга обліку. Рахунки постачальників, витрати, банківські виписки й звірка лишаються в QuickBooks, а Krokul веде роботу продажів за кожним рахунком.

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

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

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

QuickBooks і Intuit є торговельними марками Intuit Inc. Krokul не пов’язаний з Intuit.

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

---

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