Интеграция KeyCRM с Finmap через Apix-Drive

Что такое Apix-Drive

Apix-Drive — это no-code платформа для автоматизации, которая позволяет передавать данные между разными сервисами без программирования.

Она работает как посредник между двумя системами:

KeyCRM → Apix-Drive → Finmap

Apix-Drive отслеживает изменения в KeyCRM (создание или обновление заказов, клиентов, товаров и т. д.) и автоматически передаёт нужные данные в Finmap.

Как работает интеграция

После создания нового подключения необходимо:

1. Выбрать систему-источник (KeyCRM).

2. Указать событие, после которого будет запускаться автоматизация.

3. Подключить свой аккаунт KeyCRM.

4. Подключить аккаунт Finmap.

5. Замапить поля.

6. Включить автоматизацию.

После этого все новые события будут автоматически передаваться в Finmap.

Шаг 1. Создайте новое подключение

В кабинете Apix-Drive нажмите Создать Connection.

В качестве системы-источника выберите:

KeyCRM

Шаг 2. Выберите триггер

KeyCRM позволяет запускать автоматизацию после таких событий:

Товары

• Get PRODUCTS and STOCKS (new)

• Get PRODUCTS and STOCKS (modified)

Когда использовать:

• если необходимо синхронизировать каталог товаров;

• для финансового учёта обычно не используется.

Клиенты

• Get CUSTOMERS (new)

• Get CUSTOMERS (modified)

Когда использовать:

• если нужно автоматически создавать контрагентов;

• если важно передавать контактные данные клиентов.

Для большинства сценариев с Finmap этот триггер не является основным.

Заказы

• Get ORDERS (new)

• Get ORDERS (modified)

• Get ORDERS by stage (new)

Это наиболее полезные триггеры для интеграции с Finmap.

Именно заказы чаще всего содержат информацию о:

• сумме продажи;

• клиенте;

• валюте;

• статусе;

• ожидаемой оплате.

Лиды

• Get LEADS (new)

• Get LEADS (modified)

• Get LEADS by stage (new)

Используются тогда, когда компания работает через воронку продаж и хочет прогнозировать будущие поступления.

Шаг 3. Подключите аккаунт KeyCRM

После выбора триггера необходимо авторизоваться в KeyCRM.

После успешного подключения Apix-Drive получит доступ к необходимым данным.

API ключ KEY CRM: https://help.keycrm.app/en/process-automation-api-and-more/where-to-get-an-api-key

Шаг 4. Выберите систему-приёмник

В качестве системы назначения необходимо выбрать:

Finmap

Сгенерировать ключ API Finmap можно здесь: https://my.finmap.online/settings/api

Шаг 5. Выберите действие в Finmap

Сейчас через Apix-Drive можно создавать три типа операций:

Add RECEIPT

Создание поступления.

Используется для:

• оплат клиентов;

• оплат заказов;

• получения выручки.

Add COST

Создание расхода.

Подойдёт для:

• закупок;

• логистики;

• возврата средств;

• комиссий маркетплейсов;

• рекламных расходов.

Add TRANSFER

Создание перевода между счетами.

Используется тогда, когда необходимо отразить перемещение средств между счетами компании.

Шаг 6. Замапьте поля

На этом этапе необходимо передать в Finmap нужные значения, например:

• сумма;

• валюта;

• дата;

• контрагент;

• комментарий;

• номер заказа;

• проект;

• счёт.

После маппинга выполните тестовую передачу данных.

Шаг 7. Запустите интеграцию

Если тест прошёл успешно, включите автоматизацию.

Отныне новые события из KeyCRM будут автоматически создавать соответствующие операции в Finmap.

Рекомендованные сценарии интеграции

1. Новый заказ → Поступление в Finmap ⭐⭐⭐⭐⭐

Trigger

Get ORDERS (new)

Action

Add RECEIPT

Подойдёт компаниям, которые хотят автоматически отображать продажи в Finmap после создания заказа.

2. Заказ перешёл в статус "Оплачен" → Поступление ⭐⭐⭐⭐⭐

Trigger

Get ORDERS by stage

Например:

• Paid

• Completed

• Delivered

Action

Add RECEIPT

Это один из лучших сценариев, поскольку в Finmap попадают только фактически оплаченные заказы.

3. Изменение суммы заказа → Обновление финансовой информации ⭐⭐⭐⭐☆

Trigger

Get ORDERS (modified)

Action

Add RECEIPT

Позволяет автоматически учитывать изменения стоимости заказа до момента его оплаты.

Важно: если использовать этот сценарий отдельно, нужно продумать логику, чтобы избежать создания дублированных операций при каждом изменении заказа.

4. Новый лид → Плановое поступление ⭐⭐⭐⭐☆

Trigger

Get LEADS (new)

Action

Add RECEIPT

Подходит компаниям, которые ведут финансовое планирование и хотят видеть потенциальные будущие продажи.

5. Лид перешёл в финальный статус → Поступление ⭐⭐⭐⭐☆

Trigger

Get LEADS by stage

Например:

• Won

• Success

• Closed

Action

Add RECEIPT

Позволяет автоматически переносить успешные сделки в финансовый учёт.

6. Создание нового клиента → Контроль финансовых операций ⭐⭐⭐☆☆

Trigger

Get CUSTOMERS (new)

Action

Add RECEIPT или Add COST

Может использоваться, если бизнес хочет автоматически создавать финансовые операции для нового контрагента. На практике используется значительно реже.

На что обратить внимание

• Не рекомендуется одновременно использовать несколько триггеров, которые создают одну и ту же финансовую операцию (например, Get ORDERS (new) и Get ORDERS (modified)), без дополнительной логики проверки — это может привести к дублированию данных.

• Самый надёжный сценарий — создавать поступление после перехода заказа в статус «Оплачен», ведь именно он отражает фактическое движение средств.

• Если в KeyCRM есть отдельные статусы для подтверждения, доставки и оплаты, стоит использовать именно статус оплаты как триггер для передачи данных в Finmap.

• Если планируется двусторонняя интеграция, рекомендуется использовать уникальный идентификатор заказа (Order ID или External ID) для сопоставления записей между системами. Это поможет избежать дублирования и упростит дальнейшую синхронизацию.