Подключение банка Точка

Точка отдаёт выписку по API без участия человека. После подключения остаток и операции по умолчанию обновляются раз в шесть часов. От вас нужно одно: создать в интернет-банке токен и вставить его в свóдно. Этот же ключ умеет больше: с платёжным разрешением свóдно отправляет в банк платёжки на подпись.

Что понадобится

Доступ в интернет-банк Точки и телефон для подтверждения. Заявки, отдельного договора и общения с поддержкой не потребуется, токен вы выпускаете себе сами.

Шаг 1. Создайте токен в интернет-банке

1. Откройте вкладку «Сервисы» → «Все сервисы» → «Интеграции и API».
2. Нажмите «Создать JWT-ключ».
3. Укажите название. Оно любое и нужно только чтобы отличать ключи друг от друга, понятнее всего написать «свóдно».
4. Задайте срок действия. Ставьте максимально возможный: когда срок кончится, выписка перестанет загружаться и ключ придётся выпускать заново.
5. Выдайте разрешения. Для загрузки выписки хватит прав на чтение: счета, балансы, выписки.
6. Если платите через казначейство свóдно, добавьте ещё разрешение на создание платежа на подпись. Без него выписка загрузится, а платёжка получит от банка отказ по правам.
7. Введите код из СМС.
8. Скопируйте токен целиком.

Токен виден в разделе «JWT-ключи» того же сервиса, там же его можно удалить. А вот кнопку «Перевыпустить» лучше не трогать: вместе с ключом сменится и client_id, старая пара удалится, и выписка встанет, пока вы не замените ключ в свóдно. Нужен ключ с другими правами, создайте рядом новый.

Разрешения выбираются в момент создания ключа. Если платёжное понадобилось позже, выпустите новый ключ и замените его в свóдно. Старый удаляйте после того, как убедитесь, что новый работает.

Токен даёт доступ к данным вашего счёта. Держите его как пароль: не пересылайте в мессенджерах и не храните в заметках.

Шаг 2. Вставьте токен в свóдно

Откройте «Настройки» → «Интеграции» → вкладка «Каталог» → фильтр «Банки / Платежи» → карточка Точки.

Заполните:

• Название: например «Точка, основной счёт».
• API токен (JWT): вставьте скопированную строку целиком.

Остальные поля можно не трогать. При первой синхронизации свóдно получает список счетов и код клиента из API Точки. По коду клиента запрашивается карточка компании, а юрлицо сопоставляется по ИНН из этой карточки. Если такой организации в справочнике ещё нет, она создастся. Глубина истории задаётся отдельно: по умолчанию стоит 30 дней, а в расширенных настройках можно указать от 1 до 365 дней.

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

Что произойдёт дальше

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

Остаток по счёту появится в виджете «Остатки ДС» на главной, операции в разделе «Операции». Если 1С у вас не подключена, свóдно всё равно посчитает остаток, банковской выписки для этого достаточно.

Полезно знать

У токена есть срок жизни. Это самая частая причина, по которой через полгода выписка «вдруг перестала грузиться». Когда срок подойдёт к концу, выпустите новый ключ в интернет-банке и замените его в интеграции.

Платёжку подписываете вы. свóдно готовит документ и отправляет его в банк, дальше платёжка ждёт в интернет-банке в разделе «На подпись». Деньги уйдут получателю после того, как сотрудник с типом доступа «С правом подписи» введёт код из СМС.

Созданную платёжку лучше не править в банке. Точка перестаёт отдавать актуальный статус по документу, который отредактировали вручную, и в свóдно он навсегда останется отправленным. Нужны изменения, создайте платёжку заново из свóдно.

Остаток внутри дня меняется. Точка показывает текущий остаток на момент запроса, а не итог дня. Для сверок свóдно опирается на последний завершённый день. У транзитных счетов, где деньги приходят и уходят в один день, только так цифры и сходятся.

Если что-то пошло не так

Ошибка авторизации: токен скопирован не полностью либо уже просрочен. Проверьте в разделе «JWT-ключи», жив ли ключ, и выпустите новый, если срок вышел.

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

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

Операции задваиваются с 1С: так бывает, когда один и тот же платёж приезжает и из банка, и из учётной системы. Напишите нам, мы настроим приоритет источника по счёту.