Выписки Сбер: импорт через API и автоматическая загрузка из писем

В документации мы постарались ответить на частые вопросы по работе TesLab, с которыми сталкиваются пользователи.
Если Вы не нашли ответ на свой вопрос, напишите нам.

Личный кабинет

Выписки Сбер: импорт через API и автоматическая загрузка из писем

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

В этой статье

Проверить действующий способ загрузки

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

API запрашивает операции банка напрямую. IMAP даёт доступ к входящим письмам. Он отличается от SMTP, через который отправляют почту. Исправная отправка писем не подтверждает, что TesLab читает банковский ящик.

Выбрать способ и проверить доступ

СпособЧто требуетсяГде работать
Sber APIПодключённая своя организация, банковское разрешение на выписки и доступ TesLab к Sber API и списку банковских операций.Подключение в «Моих организациях», загрузка периода во вкладке «Банк. выписка».
Сбер по e-mailАдминистративное право, доступ по IMAP и банковское письмо со ссылкой на поддерживаемый файл обмена 1С, TXT.«Контрагенты» → «Настройки» → «Банковские выписки» → «Авто-выписки».
Ручной файлВыписка 1С, TXT, и право на её импорт.Загрузка файла в банковскую выписку по отдельной инструкции.

Подключение банка описано в статье «Подключение своей организации к СберБизнес». БИК и расчётный счёт в карточке заказчика сами по себе не подключают API. Для вкладки «Банк. выписка» также должен быть доступен модуль «Лаборатория». Настройка почты одна для всей установки TesLab; она не привязана к открытой карточке контрагента.

Загрузить период через API

  1. Откройте «Контрагенты» → «Банк. выписка».
  2. Нажмите банковский значок с подсказкой «Sber API» или выберите в меню «Импорт через Sber API».
Кнопка Sber API в панели таблицы банковской выписки
1. Кнопка «Sber API» в панели таблицы «Банк. выписка». Нажмите её, чтобы выбрать период загрузки.
  1. В окне «Импорт выписки через Sber API» укажите даты «С» и «По». Обе даты входят в период. Допустимо не более 31 дня, без будущих дат.
  2. Нажмите «Начать загрузку». Запрос проверяет все подключённые свои организации с разрешением на выписки.
  3. Следите за окном «Загрузка выписки из Сбера»: в нём показаны организация, день и результат обработки. После завершения сверьте операции и связанные счета.
Выбор периода перед загрузкой выписки через API
1 и 2. Начало и конец периода. 3. Кнопка «Начать загрузку».

Сообщение «Запрос принят» подтверждает приём задания. Итог «Импорт завершён» появляется после обработки периода. Если указано «Обработка завершена не полностью», прочитайте причины и проверьте уже сохранённые операции, даже когда новых операций показано ноль.

Подтверждённый результат загрузки выписки за два дня
1. Итог обработки дней и число подтверждённых новых операций. 2. Повторная проверка результата.

Окно можно закрыть. Незавершённая загрузка продолжится на сервере. Чтобы проверить её, снова нажмите «Sber API»: выполняющийся запрос откроется сразу, а для завершённого доступна кнопка «Проверить предыдущий импорт». Результат хранится для проверки в течение суток и доступен пользователю, который начал загрузку.

При работающем серверном расписании API запрашивает операции на 1-й и 31-й минуте каждого часа. До 05:00 берётся предыдущий день, затем текущий. Пропущенные дни после зарегистрированного сбоя догружаются последовательными периодами. Это время сервера; фактическую работу расписания проверяет администратор.

Текущая загрузка обрабатывает рублёвые переводы. Неподдерживаемый тип операции отмечается как незавершённая обработка счёта. Возможности и доступная глубина истории зависят от банка; актуальный контракт приведён в официальной документации Сбера.

Настроить загрузку из писем

До настройки IMAP проверьте банковскую рассылку. Нужна ссылка из HTML письма, по которой получается файл обмена 1С, TXT, до 20 МБ. PDF, Excel, Word и ZIP этот загрузчик не разбирает. Наличие такой рассылки само по себе не подтверждает совместимость: если банк не предоставляет подходящий файл по ссылке, используйте API или ручную выгрузку 1С.

  1. Согласуйте почтовый ящик для банковских выписок и убедитесь, что письма попадают в его папку «Входящие». Программа ищет письма от sberbusiness@sberbank.ru за последние три дня.
  2. Откройте «Контрагенты» → «Настройки». В блоке «Банковские выписки» нажмите «Авто-выписки».
  3. Выберите «Сбер по e-mail».
  4. Укажите IMAP-сервер, порт, логин и пароль для доступа к ящику. Значения получите у почтового администратора. Если провайдер требует пароль приложения, используйте его действующую процедуру.
  5. В поле «Уведомлять в Telegram» выберите сотрудников. Пустой список отключает уведомления этой почтовой загрузки. Получателю нужны активная учётная запись, подключённый Telegram и включённая категория банковских выписок в личных настройках.
  6. Нажмите «Сохранить». Затем проверьте очередную загрузку и операции в журнале.
Кнопка Авто-выписки в банковском блоке настроек контрагентов
1. Кнопка «Авто-выписки» открывает почтовые настройки.

При повторном открытии оставьте «Сохранить прежний логин» и «Сохранить прежний пароль», если меняете только получателей или соседние поля. Чтобы заменить реквизит, снимите соответствующую отметку и введите новое значение. Скопированная маска не заменяет пароль.

Почтовые настройки со сохранением прежнего пароля и выбранным учебным получателем
1. Почтовый режим. 2. Сохранение прежнего пароля. 3. Получатели Telegram. 4. Сохранение настроек. Значения ящика на иллюстрации учебные.

Сохранение подтверждает запись параметров и проверку доступа по IMAP. Оно не подтверждает наличие банковского письма, пригодность его файла или разноску платежей. При известном отказе окно сохраняет ввод. Если исход записи неизвестен или параметры изменил другой администратор, закройте окно и прочитайте настройки заново.

Почтовая загрузка предусмотрена на 08:01 по времени сервера. За один запуск она проверяет подходящие письма по порядку и обрабатывает их ссылки; подтверждённые ссылки повторно не загружаются. Окно настроек показывает сведения о последнем запуске и уведомлениях. После перерыва дольше трёх дней отдельно проверьте пропущенный период.

Для отключения выберите «Отключено», сохраните параметры и повторно откройте окно. Уже загруженные операции остаются в выписке. Отключение почты не отключает API.

Разобрать учебный пример

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

При почтовом способе сначала проверяют письмо и файл по ссылке, затем те же банковские операции. Письмо в ящике, успешное сохранение настроек и Telegram-сообщение являются разными подтверждениями.

Проверить операции и разноску

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

Полученное поступление может требовать ручного выбора счёта. Порядок проверки описан в статье «Загрузка банковской выписки и сопоставление платежей со счетами», а общая сумма за несколько счетов или другого заказчика в статье «Один платёж за несколько счетов или другую организацию».

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

Найти причину неполной загрузки

Что произошлоЧто проверить
Нет кнопки API или вкладки настроекПрава TesLab. Для почтовой настройки нужен администратор; для API нужны доступ к Sber API и банковской выписке.
Нет подключения, разрешения или доступных счетовСвою организацию и доступ банка по инструкции подключения. Реквизиты заказчика это подключение не заменяют.
Связь прервалась, результат не подтверждёнПовторно откройте Sber API и проверьте прежний запрос. Закрытие окна и обрыв связи не отменяют уже сохранённые данные.
Есть ошибки по отдельным дням или счетамПричины в результате, строки всего периода и оплаты. Другие дни или организации могли обработаться успешно.
Письмо есть, операций нетПапку «Входящие», отправителя, трёхдневное окно, доступ по IMAP, действующую ссылку и файл 1С. Смена SMTP не исправляет чтение входящих.
Нет Telegram-сообщенияВыбранных получателей, их Telegram и личную категорию уведомлений. Сначала проверьте сам импорт. При неизвестном исходе отправки сверьте доставку с получателем перед повтором.

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

Импортировать контрагентов из Сбера

В реестре контрагентов есть отдельная кнопка «Sber». Она загружает банковских корреспондентов и требует отдельного разрешения банка на их получение. Это не запрос выписки за период. После подтверждения проверьте организации и банковские реквизиты, при одинаковом ИНН сверяйте КПП. Полученные сведения не заменяют проверку реквизитов для нового договора.

Продолжить работу