ㅤKeyCRM — це сучасна CRM-система для малого та середнього бізнесу, яка допомагає управляти клієнтами, замовленнями та платежами в одному місці. Вона автоматизує продажі, інтегрується з касами, сайтами й маркетплейсами та формує зручну аналітику. У поєднанні з Finmap ви отримуєте повний контроль як над операційною діяльністю, так і над фінансами бізнесу.
ㅤ
ㅤ
ㅤ🔧 Кому буде корисна інтеграція
- Власникам бізнесу — бачать фінансову картину в реальному часі.
- Бухгалтерам і фінансовим менеджерам — економія часу на ручному внесенні даних.
- Адміністраторам — зручна синхронізація для звітності та контролю.
ㅤ
ㅤ🔗 Переваги інтеграції з KeyCRM
- Автоматичне завантаження транзакцій із KeyCRM у Finmap.
- Передача даних кожну годину.
- Повторна перевірка незавершених транзакцій кожні 15 хвилин.
- Гнучкість — у майбутньому можна підключати й інші системи.
ㅤ
ㅤ🔧 Які дані передаються з KeyCRM у Finmap
| Дані з 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. У коді: tx.status === ‘completed’ або у вебхуці status === ‘paid’. |
| 🗄️ Архівний статус (is_archived) | Фільтр | Тип boolean (true/false). Передаються тільки неархівні (!tx.is_archived). |
| 🏦 Рахунок (accountId) | accountId | Транзакція прив’язується до рахунку користувача у Finmap. Наприклад, “Каса” з ID 68920fc8467ef4931c3eea7d. |
🔧 Усі транзакції з KeyCRM відображаються у розділі Платежі.
Поля потрапляють у такі колонки:
Рахунок → accountId.
Сума → amount (з автоматичним визначенням: дохід / витрата).
Дата → date (у форматі Finmap).
Коментар → description.
⚙️ Крок 1: Отримання API-ключа в KeyCRM
- Увійдіть у KeyCRM.
- Перейдіть у Налаштування → Основні → API ключ
- Скопіюйте API-ключ.
- Готово! У вас є API ключ KeyCRM
ㅤ
ㅤ
⚙️ Крок 2: Отримання API-ключа у Finmap
- Увійдіть у ваш акаунт Finmap.
- Перейдіть у Налаштування компанії → API.
- Створіть новий або використайте існуючий ключ.
ㅤ
ㅤ
⚙️ Крок 3: Налаштування інтеграції
Щоб інтеграція запрацювала, потрібно передати:
- API-ключ від KeyCRM
- API-ключ від Finmap
- ID або назву рахунку у Finmap (див. у відео нижче)
- Дату початку синхронізації (наприклад, 01.01.2025)
- Ім’я користувача (унікальна назва для вашого профілю в інтеграції, напр. keycrm_user_1)
ㅤ
*Отримати ID рахунку можна таким чином:
ㅤ
*Отримати ім’я користувача з KeyCRM можна таким чином:
ㅤВаріант №1
- Скопіювати назву домену в URL стрічці до .keycrm.app
ㅤ
ㅤВаріант №2
- Скопіювати в налаштуваннях доменне ім’я до .keycrm.app
ㅤ
ㅤ
⚙️ Крок 4: Як це працює після запуску
- Перший запуск: система завантажує усі транзакції, починаючи з вашої дати старту, і переносить їх у Finmap.
- Далі: щогодини перевіряються нові транзакції, а у випадку помилок повторна спроба робиться кожні 15 хв.
- Фільтрація: у Finmap передаються тільки нові, ще не відправлені операції.
ㅤ
⚙️ Крок 5: Використання у Finmap
- Доходи відображаються як “Дохід”.
- Витрати — як “Витрата”.
- Транзакції автоматично прив’язуються до обраного рахунку (наприклад, “Каса” чи “Банк”).
ㅤ
⚙️ Крок 6: Надійність і контроль
- Перевірка ключів: перед запуском інтеграція тестує працездатність.
- Унікальність: один рахунок Finmap може бути прив’язаний лише до однієї інтеграції.
- Логування: усі дії зберігаються для прозорості.
ㅤ
📝 Як виглядатимуть платежі у Finmap після запуску інтеграції
ㅤ
ㅤ
✅ Готово! Інтеграція KeyCRM із Finmap налаштована
ㅤ