Интеграция 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 «.
📊 Статус (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 настроена