# Finmap + Krokul CRM

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

**Статус:** Нативна.

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

### План оплати з угоди стає надходженням у календарі

Менеджер додає в угоду планову оплату зі строком. Krokul створює в Finmap операцію доходу на дату строку й на суму, що лишилась до оплати, на рахунку, який ви обрали під час підключення. Фінансист бачить очікувані гроші в платіжному календарі, не відкриваючи CRM.

### Зміна суми чи строку оновлює план

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

### Часткова оплата лишає в календарі залишок

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

### Прострочений план переїжджає на завтра

Минула дата у Finmap означала б уже отримані гроші. Тому прострочений план щодня переїжджає на наступний день із приміткою «прострочено з» і датою строку. Фінансист бачить борг у календарі, доки клієнт не заплатить або менеджер не прибере план.

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

| Krokul | Finmap | Напрям | Коли |
|---|---|---|---|
| Планова оплата угоди зі строком | Операція доходу (operations/income): дата, сума, рахунок, категорія | Krokul → Finmap | Менеджер додав план оплати |
| Нова сума чи строк плану | Та сама операція за externalId | Krokul → Finmap | Менеджер змінив план |
| Часткова оплата | Сума операції зменшується до залишку | Krokul → Finmap | Надійшла частина оплати |
| Оплачений або видалений план | Операція видаляється за externalId | Krokul → Finmap | План закрито або прибрано |
| Прострочений план | Дата операції переїжджає на завтра, примітка «прострочено з» | Krokul → Finmap | Щодня, доки план відкритий |

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

### Підключення (нативно, без коду)

1. У Finmap відкрийте «Налаштування» → «API» і створіть ключ. API доступне на тарифі з API.
2. У Krokul відкрийте «Маркетплейс» → «Finmap», дайте підключенню назву й натисніть «Підключити».
3. У налаштуваннях підключення вставте ключ API, ідентифікатор рахунку Finmap і валюту цього рахунку. Категорію доходу можна вказати за бажанням.
4. Перше надсилання переносить усі відкриті плани оплат. Далі Krokul надсилає зміни кожні 10 хвилин, а журнал надсилань видно на сторінці підключення.

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

Планові оплати Krokul створюються й змінюються через роути публічного API (`payment/api-create`, `payment/api-update`), а в Finmap вони потрапляють чергою синхронізації без окремого виклику. Кожна операція в Finmap має `externalId` з ідентифікатором планової оплати Krokul, тож її можна знайти й з вашого боку.

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

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

### Чи потрапить у Finmap план у валюті, що відрізняється від валюти рахунку?

Ні. Krokul надсилає лише плани у валюті рахунку, обраного під час підключення. Для плану в іншій валюті в журналі підключення буде причина.

### Що станеться з планом у Finmap, коли клієнт заплатив?

Оплачений план Krokul видаляє з календаря Finmap. Якщо оплата часткова, план лишається на суму залишку.

### Чи читає Krokul фактичні операції з Finmap?

Ні. Зв’язка вихідна, тож Krokul лише пише в Finmap планові надходження. Фактичні надходження в Krokul приходять з банку або вносяться в угоді.

### Що робити, якщо Finmap відмовив?

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

## Обмеження

Зв’язка працює в один бік. Krokul пише в Finmap планові надходження і з Finmap нічого не читає, тож фактичні операції Finmap у Krokul не потрапляють. Потрібен тариф Finmap з доступом до API.

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

- [QuickBooks Online](https://krokul.com/uk/integrations/quickbooks-online/index.md)
- [Xero](https://krokul.com/uk/integrations/xero/index.md)
- [ПриватБанк](https://krokul.com/uk/integrations/privatbank/index.md)
- [monobank](https://krokul.com/uk/integrations/monobank/index.md)
- [Salt Edge](https://krokul.com/uk/integrations/saltedge/index.md)

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

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

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

---

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