# Dynamics 365 Business Central + Krokul CRM

Так. Krokul CRM інтегрується з Microsoft Dynamics 365 Business Central через Business Central API v2.0. Контрагенти стають клієнтами (customers), комерційні пропозиції й виграні угоди стають пропозиціями й замовленнями на продаж, а проведені рахунки й оплати клієнтів повертаються в угоду в Krokul. Дані несуть застосунок Krokul у Zapier і Make разом з API й вебхуками Krokul.

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

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

### Контрагент і клієнт у Business Central збігаються

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

### Пропозиція й замовлення в ERP

Комерційна пропозиція, виставлена в Krokul, стає sales quote у Business Central, а виграна угода стає замовленням на продаж для того самого клієнта з погодженими рядками. Склад відвантажує з Business Central, і привʼязана дія shipAndInvoice проводить там рахунок.

### Відділ продажу бачить проведений рахунок

Конектор тримає вебхук-підписку на salesInvoices. Коли рахунок проведено, Business Central повідомляє Krokul, конектор читає рахунок і показує його номер і статус в угоді.

### Оплата клієнта закриває борг

Оплати, проведені через customerPaymentJournals, доходять до Krokul тим самим шляхом. Кожна оплата стає фактом оплати на відповідному рахунку, і борг контрагента в Krokul іде за Business Central.

### Підписки поновлюються у фоні

Підписки Business Central спливають через три доби. Конектор вчасно їх поновлює й відповідає на перевірку validationToken, тому оновлення клієнтів, рахунків і оплат надходять далі без ручних кроків.

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

| Business Central | Krokul | Напрям | Коли |
|---|---|---|---|
| customers | Контрагент | Krokul ↔ Business Central | Створено в Krokul; змінено в будь-якій системі |
| items | Товар | Business Central → Krokul | Позицію створено чи змінено |
| salesQuotes | Комерційна пропозиція (документ) | Krokul → Business Central | Пропозицію виставлено в Krokul |
| salesOrders | Виграна угода з рядками | Krokul → Business Central | Угоду виграно |
| salesInvoices | Статус рахунку в угоді | Business Central → Krokul | Вебхук-сповіщення після проведення |
| customerPaymentJournals | Факт оплати на рахунку | Business Central → Krokul | Вебхук-сповіщення після проведення оплати |

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

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

1. Підключіть застосунок Krokul із ключем API Krokul.
2. У Make почніть із тригера Business Central Watch Records і завершіть дією Krokul, наприклад Create Task.
3. У Zapier застосунок Business Central тригерів не має, тому потоки починаються з тригерів Krokul на кшталт Deal Won і закінчуються дією Create a Record чи API Request (Beta).

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

1. Створіть ключ API Krokul із правами на контрагентів, угоди, документи й оплати та зареєструйте застосунок у Microsoft Entra ID з доступом до Business Central.
2. Підпишіться на clientCompany.created і card.won через webhook/api-upsert і відкидайте кожну доставку, чий заголовок x-crm-signature не збігається з вашим секретом.
3. Створіть клієнта й замовлення на продаж через API v2.0, потім збережіть ID з Business Central у записах Krokul через externalRef/api-upsert.
4. Додайте підписки Business Central на salesInvoices і customerPaymentJournals, відповідайте на перевірку validationToken, поновлюйте їх до спливу трьох діб і записуйте кожну оплату через payment/api-create з cardUuid угоди.

**Тригери:** Watch Records.

**Дії:** Create a Record; Update a Record; Get a Record; Search Records; API Request (Beta).

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

Сповіщення Business Central приходять приблизно через 30 секунд після зміни, а понад 1000 змін за цей проміжок надходять одним колекційним сповіщенням. Невдалу доставку Business Central повторює лише на відповідь 408, 429 чи 5xx, а будь-який інший код помилки видаляє підписку. Вебхукам Krokul перевірка (handshake) не потрібна. Вони підписані HMAC-SHA256, а отримувач, що відповідає 410 Gone, вимикає підписку.

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

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

### Чи інтегрується Krokul з Dynamics 365 Business Central?

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

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

Business Central надсилає вебхук-сповіщення приблизно через 30 секунд після зміни, а отримувач тоді читає змінений запис і оновлює угоду чи контрагента. У зворотний бік Krokul надсилає свій вебхук одразу, щойно сталася подія.

### Чи працює це з Business Central on-premises?

API v2.0 є в обох варіантах, але online використовує Microsoft Entra ID, а on-premises ключ доступу вебсервісу. Krokul розрахований на Business Central online.

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

Business Central. Krokul надсилає пропозиції й замовлення, а Business Central проводить рахунки й оплати. Krokul показує їхні номери й статус в угоді.

## Обмеження

Склад, проведення, головна книга й журнали оплат лишаються в Business Central. Конектор розрахований на Business Central online, де доступні вебхук-підписки й вхід через Microsoft Entra ID.

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

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

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

Microsoft, Dynamics 365 і Business Central є торговими марками групи компаній Microsoft. Krokul не афілійований з Microsoft.

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

---

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