# ПриватБанк + Krokul CRM

Так. Krokul CRM інтегрується з ПриватБанком через API для бізнесу (Автоклієнт). З токеном, який видає клієнт, Krokul читає виписку рахунку, знаходить контрагента за ЄДРПОУ платника й закриває відкриту планову оплату фактом. Бухгалтеру лишається розібрати незіставлені надходження.

**Статус:** Через API і вебхуки.

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

### Надходження з виписки закриває план

Кілька разів на годину Krokul читає `/api/statements/transactions/interim` і бере вхідні транзакції з TRANTYPE C. За ЄДРПОУ платника AUT_CNTR_CRF він знаходить контрагента, а за сумою SUM і призначенням OSND вибирає відкриту планову оплату його угоди. План стає фактом з датою DAT_OD, і в стрічці угоди видно, з якого платежу прийшли гроші.

### Одна транзакція дає рівно один факт

Банк радить ідентифікувати платіж парою REF і REFN. Krokul зберігає цю пару як зовнішній ключ оплати і перед кожним записом її перевіряє, тож повторне читання тієї самої виписки другого факту не створює.

### Нерозібрані надходження чекають бухгалтера

Якщо ЄДРПОУ платника не знайдено серед контрагентів або сума не збігається з жодним планом, транзакція потрапляє в список «Нерозібрані надходження». Бухгалтер вибирає угоду вручну, а Krokul запам’ятовує ЄДРПОУ за контрагентом, щоб наступний платіж того ж платника лягав сам.

### Часткова оплата з виписки

Коли клієнт заплатив частину рахунку, Krokul проводить факт на суму транзакції SUM і лишає залишок плану відкритим. Менеджер бачить у картці угоди, скільки ще має надійти.

### Подія для обліку після надходження

Кожен факт оплати з виписки запускає вебхук Krokul `payment.received`, а коли надходження покрили рахунок угоди повністю, Krokul один раз надсилає `invoice.paid`. Ці події може слухати облікова програма або командний чат.

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

| ПриватБанк | Krokul | Напрям | Коли |
|---|---|---|---|
| Транзакція виписки (TRANTYPE C): SUM, OSND, DAT_OD | Оплата-факт угоди | ПриватБанк → Krokul | Krokul опитує `/api/statements/transactions/interim` за розкладом |
| ЄДРПОУ платника AUT_CNTR_CRF | Контрагент угоди | ПриватБанк → Krokul | Під час зіставлення транзакції |
| Пара REF і REFN | Зовнішній ключ оплати | ПриватБанк → Krokul | Після запису факту |
| Транзакція без збігу | Список «Нерозібрані надходження» | ПриватБанк → Krokul | Коли контрагента чи план не знайдено |
| Підсумкова виписка (`/final`) | Звірка фактів за минулий день | ПриватБанк → Krokul | Раз на добу |

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

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

1. У Приват24 для бізнесу відкрийте «Облік та звіти» → «Інтеграція (Автоклієнт)», натисніть «Підключити додаток», виберіть API і скопіюйте token. Для юридичних осіб послуга доступна на тарифах «Бізнес Комфорт» і «Бізнес ПРО».
2. У Krokul створіть ключ API зі scope на оплати й контрагентів. Відкриті плани контрагента ваш потік читає через `payment/api-readList` з `openPlans: true`.
3. Вхідну транзакцію з виписки проведіть фактом через `payment/api-create` з `cardUuid` угоди, а пару REF і REFN збережіть на оплаті через `externalRef/api-set`, щоб повторне читання не дало другого факту.
4. Підпишіть вебхук на `payment.received` та `invoice.paid`, щоб облік чи командний чат отримували подію. Кожна доставка несе заголовок `x-crm-signature`, який ви звіряєте своїм секретом.

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

Оплати з виписки доступні й через публічний API Krokul. Роут `payment/api-readList` з `openPlans: true` віддає відкриті плани контрагента, а відповідність ЄДРПОУ контрагенту зберігає зовнішній ключ `externalRef`. Події `payment.received` і `invoice.paid` приходять підписаними вебхуками з журналом доставок. Власний код зіставлення перевіряють на демо-компанії в пісочниці.

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

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

### Що Krokul може робити з рахунком у ПриватБанку?

Лише читати виписку через API Автоклієнт з токеном, який видали ви. Платежів Krokul не створює, а видалений токен зупиняє читання виписки.

### Як швидко оплата з ПриватБанку з’являється в угоді?

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

### Що робить Krokul з платежем, який не вдалося зіставити?

Кладе його в «Нерозібрані надходження». Бухгалтер вибирає угоду вручну, і Krokul запам’ятовує платника для наступних разів.

### Чи можна провести оплати з виписки вручну?

Так. У реєстрі оплат бухгалтер позначає планові оплати, які бачить у виписці, і проводить їх фактами кнопкою «Факти з виписки».

## Обмеження

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

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

- [monobank](https://krokul.com/uk/integrations/monobank/index.md)
- [LiqPay](https://krokul.com/uk/integrations/liqpay/index.md)
- [NovaPay](https://krokul.com/uk/integrations/novapay/index.md)
- [WayForPay](https://krokul.com/uk/integrations/wayforpay/index.md)
- [Opendatabot](https://krokul.com/uk/integrations/opendatabot/index.md)

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

ПриватБанк і Приват24 є торговими марками їхнього власника. Krokul не афілійований із ПриватБанком.

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

---

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