Інтеграції через сервіс-конектор Apix-Drive

Інтеграція KeepinCRM з Finmap через Apix-Drive

Як підключити KeepinCRM до Finmap через сервіс Apix-Drive: покрокова інструкція з налаштування автоматичної передачі фінансових операцій.

Що таке Apix-Drive

Apix-Drive — це no-code платформа для автоматизації, яка дозволяє обмінюватися даними між різними сервісами без написання коду.

У випадку інтеграції з Finmap схема роботи виглядає так:

KeepinCRM → Apix-Drive → Finmap

Apix-Drive відстежує зміни у KeepinCRM та автоматично створює відповідні фінансові операції у Finmap.

Як працює інтеграція

Для налаштування інтеграції необхідно:

Обрати систему-джерело (KeepinCRM).
Вказати подію, яка запускатиме автоматизацію.
Авторизуватися у KeepinCRM.
Підключити Finmap.
Замапити поля.
Запустити інтеграцію.

Після цього всі нові події автоматично потраплятимуть до Finmap.

Крок 1. Створіть нове підключення

У кабінеті Apix-Drive створіть новий Connection.

Як систему-джерело оберіть:

KeepinCRM

Крок 2. Оберіть тригер

KeepinCRM підтримує такі події.

Get CLIENTS (new)

Запускається після створення нового клієнта.

Коли використовувати:

автоматичне створення контрагентів;
синхронізація клієнтської бази.

Для інтеграції з Finmap використовується нечасто.

Get AGREEMENTS (new)

Запускається після створення нового договору.

Саме цей тригер є одним із найкорисніших для інтеграції з Finmap.

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

Get AGREEMENTS (modified)

Запускається після зміни договору.

Наприклад:

змінилася сума;
змінилися реквізити;
змінилися умови договору.

Використовується тоді, коли необхідно оновлювати фінансову інформацію після внесення змін.

Get AGREEMENTS by status (new)

Запускається після переходу договору у певний статус.

Наприклад:

Оплачено
Виконано
Закрито

Це найбільш рекомендований тригер для інтеграції з Finmap.

Він дозволяє створювати фінансові операції лише після настання потрібного бізнес-сценарію.

Крок 3. Підключіть акаунт KeepinCRM

Авторизуйтеся у своєму акаунті KeepinCRM та надайте Apix-Drive доступ до даних.

API ключ Keepin CRM: https://keepincrm.com/api-key

Крок 4. Оберіть систему-приймач

Як систему призначення виберіть:

Finmap

Згенерувати ключ API Finmap можна тут: https://my.finmap.online/settings/api

Крок 5. Оберіть дію у Finmap

Наразі Finmap підтримує три типи операцій.

Add RECEIPT

Створення надходження.

Використовується для:

оплат клієнтів;
оплат за договорами;
отримання виручки.

Add COST

Створення витрати.

Підходить для:

закупівель;
витрат за договорами;
комісій;
сервісних платежів.

Add TRANSFER

Створення переказу між рахунками компанії.

Крок 6. Замапте поля

Передайте із KeepinCRM до Finmap необхідні дані:

сума;
дата;
клієнт;
номер договору;
коментар;
валюта;
проєкт;
рахунок.

Після цього виконайте тестове надсилання.

Крок 7. Запустіть інтеграцію

Якщо тест виконано успішно, увімкніть автоматизацію.

Після цього всі нові події автоматично створюватимуть фінансові операції у Finmap.

На що звернути увагу

Якщо ви використовуєте одночасно Get AGREEMENTS (new) та Get AGREEMENTS (modified), варто передбачити механізм захисту від дублювання операцій у Finmap.
Для більшості компаній оптимальним варіантом є створення надходження після переходу договору у статус «Оплачено», адже саме він відображає фактичний рух коштів.
Якщо в KeepinCRM використовується кілька статусів виконання договору (наприклад, «Погоджено», «У роботі», «Оплачено», «Закрито»), рекомендується запускати інтеграцію саме зі статусу, який означає отримання коштів.
Якщо планується двостороння синхронізація або подальше оновлення операцій, рекомендується передавати унікальний ідентифікатор договору (Agreement ID). Це допоможе коректно зіставляти записи між KeepinCRM та Finmap і уникати дублювання.

Зміст