Так. Krokul CRM інтегрується з ПриватБанком через API для бізнесу (Автоклієнт). З токеном, який видає клієнт, Krokul читає виписку рахунку, знаходить контрагента за ЄДРПОУ платника й закриває відкриту планову оплату фактом. Бухгалтеру лишається розібрати незіставлені надходження.
Кілька разів на годину 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 | Звірка фактів за минулий день | Раз на добу |
payment/api-readList з openPlans: true.payment/api-create з cardUuid угоди, а пару REF і REFN збережіть на оплаті через externalRef/api-set, щоб повторне читання не дало другого факту.payment.received та invoice.paid, щоб облік чи командний чат отримували подію. Кожна доставка несе заголовок x-crm-signature, який ви звіряєте своїм секретом.Лише читати виписку через API Автоклієнт з токеном, який видали ви. Платежів Krokul не створює, а видалений токен зупиняє читання виписки.
За кілька хвилин після того, як транзакція з’явилась у проміжній виписці банку. Krokul опитує виписку за розкладом і тримається рекомендації банку не більше одного запиту на секунду.
Кладе його в «Нерозібрані надходження». Бухгалтер вибирає угоду вручну, і Krokul запам’ятовує платника для наступних разів.
Так. У реєстрі оплат бухгалтер позначає планові оплати, які бачить у виписці, і проводить їх фактами кнопкою «Факти з виписки».
Krokul працює з ПриватБанком лише через API банку і в межах прав токена, який видав клієнт. Він читає виписку й платежів не створює. Банк не надсилає подій про нові транзакції й радить не більше одного запиту на секунду, тому Krokul опитує виписку за розкладом.
Напишіть, яким сервісом ви користуєтесь і що має ходити між ним і Krokul. Ми відповімо способом і строком.
Запит отримано. Відповімо на вашу пошту.
ПриватБанк і Приват24 є торговими марками їхнього власника. Krokul не афілійований із ПриватБанком.