Интеграция KeyCRM та Finmap

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

🛠️ ПОПРОБОВАТЬ KeyCRM

🔧 Кому будет полезна интеграция

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

Важно!

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

ㅤ🔗 Преимущества интеграции с KeyCRM

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

ㅤㅤ🔗 Преимущества интеграции с KeyCRM

Finmap получает транзакции из двух разделов KeyCRM — «Воронки» и «Заказы».

В Finmap передаются только те карточки, которые имеют статус «Оплачено».

Изменение статуса на «Оплачено» является основным фильтром, который использует Finmap для передачи транзакций в систему.

Для каждой транзакции передаются:

Дата и время оплаты
Сумма оплаты
Источник заказа (если был указан) — передается в Finmap как тег
Номер заказа / сделки
Комментарий

Важно!

Из-за особенностей базовых настроек часового пояса в Finmap (UTC+0) транзакции из KeyCRM могут передаваться с другим временем.
Например, если в KeyCRM установлен часовой пояс UTC+2, то транзакция с временем оплаты 14:00 будет передана со временем 12:00.

Чтобы это изменить, установите соответствующий часовой пояс в KeyCRM

Как мы сохраняем порядок?

Транзакции загружаются частями (по 50 за раз), чтобы не перегружать систему, и объединяются в единый список.
Все записывается в базу данных, чтобы понимать:
- какие транзакции уже переданы;
- когда в последний раз выполнялась синхронизация (чтобы забирать только новые данные).
Если что-то пошло не так (например, Finmap временно не принял транзакцию), система проверяет это каждые 15 минут и повторяет попытку.

Как часто это происходит?

Синхронизация запускается раз в час (например, в 12:00, 13:00 и т.д.).
Проверка незавершенных транзакций — каждые 15 минут.

Что нужно сделать, чтобы специалисты Finmap могли настроить интеграцию

В вашем кабинете Finmap необходимо создать 2 счета: «Воронки» и «Заказы».
Даже если в KeyCRM вы не используете обе сущности, два счета должны быть созданы для корректной настройки. Ненужный счет можно затем скрыть.
Предоставить менеджеру Finmap следующую информацию:

API Ключ Finmap
API-ключ KeyCRM
ID или название счета в Finmap (см. видео ниже)
Дату начала синхронизации (например, 01.01.2026)
Имя пользователя (уникальное название для вашего профиля в интеграции, например: keycrm_user_1). Имя выбирается произвольно и не влияет на работу интеграции.

Важно!

Не удаляйте API-ключи, предоставленные для интеграции. Удаление ключей приведет к остановке работы интеграции.

Технические данные

Для подключения интеграции обязательно нужно получить API-ключ в KeyCRM. Как это сделать:

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

ㅤ

ㅤПолучение API-ключа в Finmap

Ввойдите в ваш аккаунт Finmap.
Перейдите в Настройки компании → API.
Создайте новий или используйте существующий ключ.

ㅤ

Как это работает после запуска

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

Использование в Finmap

Доходы отображаются как “Доход”.
Расходы — как “Расход”.
Транзакции автоматически привязываются к выбранному счету (например, «Касса» или «Банк»).

ㅤ

Надежность и контроль

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

ㅤ

✅ Готово! Интеграция KeyCRM с Finmap настроена

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