Інтеграція KeyCRM та Finmap

KeyCRM — це сучасна CRM-система для малого та середнього бізнесу, яка допомагає управляти клієнтами, замовленнями та платежами в одному місці. Вона автоматизує продажі, інтегрується з касами, сайтами й маркетплейсами та формує зручну аналітику. У поєднанні з Finmap ви отримуєте повний контроль як над операційною діяльністю, так і над фінансами бізнесу.

🔧 Кому буде корисна інтеграція

• Власникам бізнесу — бачать фінансову картину в реальному часі.
• Бухгалтерам і фінансовим менеджерам — економія часу на ручному внесенні даних.
• Адміністраторам — зручна синхронізація для звітності та контролю.

Важливо! У даній інструкції описаний сценарій інтеграції між системами Finmap та KeyCRM, який реалізується на нашому продуктовому середовищі та є платною послугою. Ви можете налаштувати інтеграцію самостійно, використавши відкрите API двох систем.

ㅤ🔗Переваги інтеграції з KeyCRM

• Автоматичне завантаження транзакцій із KeyCRM у Finmap.
• Передача даних кожну годину.
• Повторна перевірка незавершених транзакцій кожні 15 хвилин.

🔧 Кому буде корисна інтеграція

Finmap забирає транзакції з двох розділів у KeyCRM – “Воронки” та “Замовлення”

У Finmap потрапляють тільки ті картки, які мають статус “Сплачено”:

Зміна статусу на “Сплачено” є основним фільтром, який використовує Finmap для передачі транзакцій у систему.

Для кожної транзакції ми передаємо:

• Дату та час оплати
• Суму оплати
• Джерело замовлення (якщо таке було наявне) – передається у Finmap як тег
• Номер замовлення \ угоди
• Коментар 

Важливо!

Через особливості базових налаштувань часового поясу у Finmap (UTC+ 0), транзакції з KeyCRM можуть передаватися з іншим часом. Наприклад, якщо у вас в KeyCRM стоїть часовий пояс UTM+2, то транзакція з часом оплати 14:00 передасться з часом оплати 12:00. Щоб це змінити, встановіть відповідний часовий пояс у KeyCRM.

Як ми зберігаємо порядок?

Транзакції завантажуються частинами (по 50 за раз), щоб не перевантажувати систему, і збираються в один список.

Усе записується в базу даних, щоб знати:

• Які транзакції вже передані.
• Коли востаннє ми синхронізували дані (щоб брати тільки нові).

Якщо щось пішло не так (наприклад, Finmap тимчасово не прийняв транзакцію), ми перевіряємо це кожні 15 хвилин і допрацьовуємо.

Як часто це відбувається?

Синхронізація запускається раз на годину (наприклад, о 12:00, 13:00 тощо).

Перевірка незавершених транзакцій — кожні 15 хвилин.

Що потрібно зробити, щоб спеціалісти Finmap могли налаштувати інтеграцію:

1. Ви маєте створити у своєму кабінеті Finmap 2 рахунки: “Воронки” та “Замовлення”. Навіть якщо у KeyCRM ви не користуєтеся обома сутностями, мають бути створені 2 рахунки для коректного налаштування. Не потрібний рахунок можна потім приховати.
2. Надати менеджеру Finmap таку інформацію:

• API-ключ KeyCRM
• API-ключ Finmap
• ID або назву рахунку у Finmap (див. у відео нижче)
• Дату початку синхронізації (наприклад, 01.01.2026)
• Ім’я користувача (унікальна назва для вашого профілю в інтеграції, напр. keycrm_user_1 ). Ім’я користувача вибирається на свій розсуд, не впливає на інтеграції.

Важливо! Не видаляйте API-ключі, які ви надали для інтеграції. Видалення ключів призведе до припинення роботи інтеграції.

Отримання API-ключа в KeyCRM

1. Увійдіть у KeyCRM.
2. Перейдіть у Налаштування → Основні → API ключ
3. Скопіюйте API-ключ.
4. Готово! У вас є API ключ KeyCRM

ㅤ

Отримання API-ключа у Finmap

1. Увійдіть у ваш акаунт Finmap.
2. Перейдіть у Налаштування компанії → API.
3. Створіть новий або використайте існуючий ключ.

ㅤ

Отримати ім’я користувача з KeyCRM можна таким чином:

ㅤВаріант №1

• Скопіювати назву домену в URL стрічці до .keycrm.app

ㅤВаріант №2

• Скопіювати в налаштуваннях доменне ім’я до .keycrm.app

ㅤ

ㅤ

Як це працює після запуску

• Перший запуск: система завантажує усі транзакції, починаючи з вашої дати старту, і переносить їх у Finmap.
• Далі: щогодини перевіряються нові транзакції, а у випадку помилок повторна спроба робиться кожні 15 хв.
• Фільтрація: у Finmap передаються тільки нові, ще не відправлені операції.

Використання у Finmap

• Доходи відображаються як “Дохід”.
• Витрати — як “Витрата”.
• Транзакції автоматично прив’язуються до відповідного рахунку

ㅤ

Надійність і контроль

• Перевірка ключів: перед запуском інтеграція тестує працездатність.
• Унікальність: один рахунок Finmap може бути прив’язаний лише до однієї інтеграції.
• Логування: усі дії зберігаються для прозорості.

ㅤ

Як виглядатимуть платежі у Finmap після запуску інтеграції

ㅤ

Готово! Інтеграція KeyCRM із Finmap налаштована

ㅤ

Важливо!
На ваш запит ми можемо внести зміни до поточного сценарію інтеграції (побажання будуть зафіксовані і реалізовані по мірі накопичення фідбеку) , або підготувати для вас кастомний варіант. Вартість такої послуги прораховується додатково і визначається складністю запиту.