Интеграция «Точка Банк»

Доступность: настраивается для компании. Подключение и токены — в Настройки, вкладка «Точка Банк». Рабочий экран операций — пункт меню «Точка Банк» (/tochka-bank).

Банк и CRM в одном процессе

Интеграция с Точка Банк позволяет подтянуть остатки по счетам, загрузить выписку (платежи) и аккуратно перенести операции в ваш учёт «Деньги» — с привязкой к счетам CRM, заказам и категориям расходов. Меньше ручного ввода, меньше расхождений между выпиской и таблицей платежей.

⚙️ Подключение в «Настройки → Точка Банк»

Включите чекбокс интеграции и заполните поля. При сохранении CRM проверяет токен через API банка.

Пошагово: JWT и Client ID (как в подсказке интерфейса)

  1. Войдите в интернет-банк Точка.
  2. Настройки → Интеграции → Подключить.
  3. Выберите «Сгенерировать JWT-ключ».
  4. Название ключа: например MyFabric CRM; срок доступа: Бессрочно.
  5. На шаге «Доступы» оставьте включёнными как минимум:
    • Просмотр реквизитов;
    • Просмотр остатка по счёту;
    • Получение выписок;
    • Создание и получение вебхуков.
    Остальные доступы при необходимости отключите.
  6. Продолжить → введите 5-значный код из SMS от банка.
  7. На экране «Ключ готов!» скопируйте ключ → Готово.
  8. На карточке ключа скопируйте Токен и Client_ID в поля CRM: JWT — в поле «JWT-токен», Client ID — в «Client ID» (Client_ID также нужен для вебхуков).

Маппинг счетов

После сохранения подтягиваются счета из банка. Для каждой строки выберите соответствующий счёт в справочнике CRM. Если удобного счёта нет — используйте кнопку «Создать счёт» из данных банка. Лишние счета можно «Скрыть»; список скрытых разворачивается в панели «Скрытые счета» с возможностью вернуть в маппинг.

Вебхуки

В настройках отображается конечный URL вебхука (вызывается банком при операциях) и список типов подписок. Кнопка «Проверить вебхуки в банке» обновляет данные; при необходимости раскрывается блок с сырым ответом API для отладки.

Отладка API

Если нужно убедиться в ответе банка, есть кнопка «Показать ответ API (первые 2 счёта)» с раскрывающимся JSON.

💼 Экран «Точка Банк» в меню

Пока интеграция не настроена, показывается подсказка с кнопкой перехода в настройки. После настройки доступны блоки:

  • Статус синхронизации выписки — прогресс и текст статуса (если идёт загрузка выписок).
  • Балансы — карточки остатков по подключённым счетам; периодическое обновление на клиенте (в коде — интервал порядка нескольких минут).
  • Счета без сопоставления — предупреждение, если счёт из Точка не привязан к CRM; кнопка перехода в настройки маппинга (иначе операции не смогут корректно попадать в «Деньги»).
  • Таблица «Платежи» — строки выписки с датой, типом (приход/расход), суммой и назначением платежа.

Действия в таблице платежей

  • Обновить — перезагрузить список с банка.
  • Подвязать по назначению — попытка автоматического сопоставления по тексту назначения.
  • Очистить платежи — массовая очистка (осторожно, подтверждение в интерфейсе).
  • Для строк можно задать/изменить привязку к заказу, категорию расхода, отметку перевода и счёт списания — в зависимости от типа операции (как в форме строки таблицы).
  • Перенести (N) — перенос выбранных строк в учёт «Деньги». Кнопка неактивна, если для расходов не указано назначение, а для переводов — не указан счёт списания (подсказка на кнопке это объясняет). При ошибках переноса список ошибок выводится в алерте над таблицей.

⚠️ Важно помнить

  • JWT в форме при сохранении у банка может быть одноразовым для ввода — поле в CRM может требовать ввод нового ключа при обновлении (см. подсказку у поля JWT в настройках).
  • Зачёт аванса по заказу не проходит через экран Точка — это внутренняя операция взаиморасчётов с клиентом.

🔗 Связанные разделы