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

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

ㅤ

🛠️ СПРОБУВАТИ KeyCRM

ㅤ

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

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

ㅤ

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

Автоматичне завантаження транзакцій із KeyCRM у Finmap.
Передача даних кожну годину.
Повторна перевірка незавершених транзакцій кожні 15 хвилин.
Гнучкість — у майбутньому можна розширювати сценарії інтеграції.

ㅤ

ㅤ🔧 Які дані передаються з KeyCRM у Finmap

Усі транзакції, які передаються з KeyCRM у Finmap, ми забираємо з журналу платежів KeyCRM:

Finmap не забирає транзакції, які не є завершені, або які є архівованими. Передаються тільки транзакції зі статусом “Оплачено”:

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

Повний список метрик, які Finmap забирає з KeyCRM можна переглянути у таблиці нижче:

Дані з KeyCRM	Як виглядає у Finmap	Що означає / як працює
🆔 ID транзакції (id)	Використовується як унікальний ідентифікатор	Наприклад, “123”. Потрібен для того, щоб транзакція не дублювалась у Finmap.
💰 Сума (amount)	amount	Сума платежу у гривнях або іншій валюті. • 100.00 → дохід (Income) • -50.00 → витрата (Expense).
📅 Дата транзакції (date)	date	Дата і час створення транзакції, наприклад “2025-09-10T15:00:00Z”. Використовується для відбору (від startDate до поточної дати) і відображається у Finmap у локальному форматі: 10.09.2025.
📝 Опис (description)	comment	Текстовий опис, напр. “Payment for order #123”. Якщо опису немає → створюється дефолтний “Order <id>”.
📊 Статус (status)	Фільтр (визначає, чи передається транзакція)	Передаються тільки завершені транзакції (статус “Оплачено”): • completed • paid.
🗄️ Архівний статус (is_archived)	Фільтр	Аналізуємо статус транзакції (архівна чи не архівна). Передаються тільки неархівні (!tx.is_archived).
🏦 Рахунок (accountId)	accountId	Транзакція прив’язується до рахунку користувача у Finmap. Наприклад, “Каса” з ID 68920fc8467ef4931c3eea7d.

🔧 Усі транзакції з KeyCRM відображаються у розділі Платежі.

Поля потрапляють у такі колонки:

Рахунок → accountId.

Сума → amount (з автоматичним визначенням: дохід / витрата).

Дата → date (у форматі Finmap).

Коментар → description.

Технічні дані

Для підключення інтеграції, обов’язково потрібно отримати API-ключ в KeyCRM. Як це зробити:

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

ㅤ

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

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

ㅤ

ㅤВажливо! Ключі мають бути збережені та не видалятися, поки інтеграція сервісів для вас актуальна. Якщо ключ видалиться, інтеграція перестане працювати.

ㅤ

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

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

ㅤ

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

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

ㅤ

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

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

ㅤ

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

ㅤ

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