История обновлений

В этом разделе вы найдете историю обновлений и изменений документации.

Сентябрь

18.09.2026

1. Обновили список статусов для параметра employeeSalaries.result в методе Получение зарплатной ведомости.

2. Добавили бизнес-сценарий для претензий по эквайрингу.

3. Новые методы в сервисе "Безопасные сделки".

Добавлено 4 эндпоинта:

• POST /v1/secure-deals/beneficiaries/delete - Удалить бенефициара

• POST /v1/secure-deals/beneficiaries/update - Изменить информацию по бенефициару

• POST /v1/secure-deals/deals/close - Закрыть сделку

• POST /v1/secure-deals/transactions/tax - Создать налоговый платеж

16.09.2026

1. Добавили документацию в формате Markdown и файл llms.txt. Чтобы упростить работу с документацией в AI-помощниках.

2. Рассказали про доступ к документации с помощью MCP-сервера docs-mcp.

3. Добавили раздел "Настройка интеграции" в инструкцию по подключение и настройке налоговых вычетов в 1С:БГУ.

Август

31.08.2026

1. Реализовали два новых MCP-сервера для работы с:

• Инкассацией
• НСО и депозитами

2. В ответ метода /v1/client-info добавлено поле taxationSystem.

3. В перечень claims добавлен claim taxationSystem.

4 Новые методы для работы с УКЭП.

Добавлено два эндпоинта:

• POST /v1/crypto/ukep-ul/activate - Подключение УКЭП ЮЛ для учетной записи

• POST /v1/crypto/ukep-ul/deactivate - Отключение УКЭП ЮЛ для учетной записи

24.08.2026

1. Документация по старому тестовому стенду (efs-sbbol-ift-web.testsbi.sberbank.ru, iftfintech.testsbi.sberbank.ru) скрыта в связи с их отключением в конце августа. Для тестирования используйте актуальный контур — «Песочница API».

20.08.2026

1. В сервисе "Моментальные платежи" появилась возможность подписать платеж с помощью QR.

2. Новый метод в сервисе "Безопасные сделки".

Добавлен эндпоинт:

• POST /v1/secure-deals/transactions/sbp/b2c - Создать платеж по СБП В2С

12.08.2026

1. Добавили возможность подтвердить платеж с помощью QR-кода.

03.08.2026

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

• Рублевое платежное поручение

• Исходящее платежное требование

2. Добавили возможность отзыва TLS-сертификата в личном кабинете Sber API.

Июль

30.07.2026

1. С 1 сентября 2026 года доступ к файловым методам Sber API будет возможен только при одновременном использовании TLS-сертификата и токена авторизации в заголовке Authorization.

Методы по работе с файлами:

• Работа с файлами
• Получение ссылки на скачивание выписки
• Загрузка файла к претензии

29.07.2026

1. Новые методы для работы с претензиями по эквайрингу.

Добавлено пять эндпоинтов:

• POST /v1/acquiring/claims/primary - Отправка ответа на первичную претензию или преарбитраж

• GET /v1/acquiring/claims/{claimId}/upload-links - Получение ссылок на загрузку файлов к претензии

• POST /v1/acquiring/claims/{claimId}/uploaded-files/state - Получение статусов загруженных файлов

• POST /v1/acquiring/claims/{claimId}/uploaded-files/delete - Удаление загруженных файлов из претензии

• POST /v1/sberbusinessapi/AcquiringClaim/files/upload-file/{random}/{fileId} - Загрузка файла к претензии

2. Расширены права подписи заявления на подключение Sber API.

Теперь подпись заявлений доступна:

• единоличному исполнительному органу (ЕИО) с единственной подписью;
• ЕИО с первой подписью;
• пользователям, на которых была выдана доверенность.

23.07.2026

15.07.2026

1. В ответ метода /v1/client-info добавлены поля okved и orgKindActivityInfo.

2. В перечень claims добавлены okved и activityType.

13.07.2026

1. Реализовали сценарии тестирования в песочнице для наборов:

• Моментальные платежи
• Корпоративные подписки
• Платформам
• Холдингам
• СберБизнес ID

08.07.2026

1. Реализовали новый tool "Получение реквизитов контрагента" для MCP-сервера по работе с рублевыми платежными поручениями.

01.07.2026

1. Скрыли документацию по сервису «Переписка с банком» в связи с его полным отключением. Сервис был выведен из эксплуатации согласно плану, анонсированному 12.02.2026.

Также скрыт связанный справочник метода GET /v1/dicts. При попытке его запроса API с идентификатором справочника GenericLetterType будет возвращаться ошибка.

Июнь

22.06.2026

1. Новые методы для работы с претензиями:

Добавлены два эндпоинта:

• GET /v1/acquiring/claims/{claimId} - Получение детальной формы претензии

• POST /v1/acquiring/claims/{claimId}/download-links- Получение ссылок на скачивание файлов из претензии

16.06.2026

1. Добавили возможность подписания рублевого платежного поручения с помощью УКЭП ЮЛ.

Для подписания необходимо:

• Подключить подписание УКЭП юрлица в СберБизнес.
• Получить уникальный идентификатор подписи УКЭП можно в методах Получения криптоинформации и Получения крипроинформации для ЕИО в поле certificateInfos.uuid.
• Сформировать и подписать дайджест подписью УКЭП, закодировать его в Base64.
• Передать информацию о идентификатор подписи УКЭП и тип подписи в методе Создание РПП.

08.06.2026

1. С 4 июля 2026 года в форматы данных платежных поручений вносятся изменения. Это касается полей amount (сумма) и vat.amount (сумма НДС).

Изменится максимальная длина целой части числа уменьшается с 18 до 15 знаков.

• Старое правило: ^-?\d{0,18}(\.\d{1,2})?$
• Новое правило: ^\d{0,15}(\.\d{1,2})?$

Проверьте ваши интеграции и скрипты, которые формируют/проверяют платежи. С 04.07.2026 платежи, переданные со значениями длиннее 15 целых знаков до запятой будут отклоняться.

2. Добавили инструкцию по настройке расширения в 1С:БГУ для работы с сервисом "Налоговые вычеты".

01.06.2026

1. Реализовали новый MCP-сервер для работы с выписками.

Май

28.05.2026

1. Реализовали новый сервис для работы с налоговым вычетом.

2. В Личный кабинет Sber API добавлена возможность скачивания печатных форм заявлений.

Чтобы скачать печатную форму:

1. Перейдите на вкладку "Документы"

2. Нажмите кнопку скачивания у соответствующего заявления

3. Добавили детализацию кодов для объекта codes23e.

25.05.2026

1. Уточнили конфигурации и версии 1С, в которых доступна интеграция со Sber API.

21.05.2026

1. Добавили новый раздел MCP, где будем публиковать MCP-сервера банка. На данный момент доступен сервер по работе с рублевым платежным поручением.

2. Полностью обновили описание спецификации API по продукту ВЭД:

• ВК и ВБК

• Письма ВК

• Валютные операции

• СПД

3. Новые методы для внесения изменений в I раздел ВБК:

Добавлены три эндпоинта:

• POST /v1/bank-control-statements/curr-contract-change-application - Создание заявления о внесении изменений в I раздел ВБК

• GET /v1/bank-control-statements/curr-contract-change-application/{externalId}- Получение документа Заявление о внесении изменений в I раздел ВБК

• GET /v1/bank-control-statements/curr-contract-change-application/{externalId}/state - Получение статуса документа Заявление о внесении изменений в I раздел ВБК

4. Реализовали сервис работы с претензиями.

5. Описали схему работы с СБП B2B в наборе "Платформам".

15.05.2026

1. Добавили библиотеку Pixso в партнерские кнопки.

2. Переработали формат таблицы ошибок для сервиса "Безопасные сделки".

3. Уточнили статусы зарплатной ведомости и добавили описание ошибок (RCB0015, RCB0016, RCB0017) по самозанятым.

4. Добавили новый статус PROCESSING_RECALL для валютного платежного поручения.

05.05.2026

1. Добавили информацию о заголовке Content-Type в методы выписки.

2. Новые методы для работы с инкассацией

Добавлены два эндпоинта:

• GET /v1/encashments/contracts — получение списка договоров инкассации;
• GET /v1/encashments/contracts/{contractId}/objects — запрос списка объектов по договору инкассации.

3. Новые типы счетов в информации о клиенте

В метод GET /v1/client-info добавлены возможные значения параметра type (тип счета):

• eskrow
• pledge
• segregate
• metal
• special

4. Актуализированы описания статусов:

• для СБП B2B;
• для СБП B2C.

5. В метод СБП B2C (/v1/sbp/paymentB2C/execute) добавлена возможность тестирования различных ошибок в зависимости от значения параметра amount.

Апрель

15.04.2026

1. Добавили новые стандартные claims: firstName, middleName, lastName.

2. Реализовали сервис покупки/продажи валют, функционал доступен в тестовом режиме.

Март

31.03.2026

1. Добавили информацию о готовых интеграциях.

2. Полностью обновили описание и структуру стайлгайда.

3. Добавили новый бизнес-сценарий "подтверждение аккаунта с помощью СберБизнес ID".

4. Переместили страницу с коллекцией Postman в "Справочник API".

30.03.2026

1. В текущий метод Автокотировки /v1/placement/interest-rate добавлены следующие атрибуты:

• дата начала (startDate - обязательный атрибут);
• счет списания/поддержания (account - обязательный атрибут);
• счет возврата (accountReturn - необязательный атрибут).

2. Реализовали 4 метода v2 для НСО и депозитов:

• /v2/placement/deposit/application - Создание заявления на депозит на основании ПКП (предодобренное предложение);
• /v2/placement/deposit/application/interest-rate - Создание заявления на депозит с автоматическим запросом ставки (автокотировка);
• /v2/placement/minimum-balance/application - Создание заявления на НСО на основании ПКП (предодобренное предложение);
• /v2/placement/minimum-balance/application/interest-rate - Создание заявления на НСО с автоматическим запросом ставки (автокотировка). В модель запроса добавлено поле дата начала (startDate - обязательный атрибут).

Причины доработки методов версии v2:

• в связи с изменениями Условий размещения денежных средств по Депозитам/НСО (ссылка на действующую редакцию Условий размещения по депозитам и НСО на сайте банка );
• теперь для создания сделки по Депозитам/НСО не требуется предварительного присоединения к соглашению-оферте на Депозиты/НСО;
• теперь при каждом заключении сделки на Депозиты/НСО в канале Sber API клиент присоединяется к условиям размещения денежных средств, опубликованным на сайте банка (ссылка в п. 1);
• если у клиента отдельный договор с особыми условиями предоставления продуктов Депозиты/НСО, то при заключении сделки в канале Sber API эти условия не будут учтены;
• методы по Депозитам/НСО версии v2 теперь доступны для интеграций наборам "Компаниям" и "Холдингам";
• для холдингов в форму согласия на передачу данных добавлены продукты Депозиты/НСО в рамках договора Sber API.

3. Реализовали метод для получения списка зарегистрированных чеков самозанятого.

24.03.2026

1. Уточнили описание поля paymentPeriodCode в запросе списка предодобренных коммерческих предложений.

2. Реализовали методы для работы с инкассацией.

3. Реализовали методы для работы с самозанятыми.

16.03.2026

1. Реализовали новый тестовый стенд "Песочница API" для тестирования методов набора "Компаниям".

2. Добавили новые методы в сервис "Безопасные сделки":

• /v1/nominal-account/transactions/incomes — запросить список операций зачисления по номинальному счету за определенный промежуток времени
• /v1/nominal-account/transactions/{id}— запросить детали операции
• /v1/nominal-account/transactions/refunds — запросить список операций возврата

Февраль

12.02.2026

04.02.2026

1. Добавили видеоинструкцию по получению настроек для 1С:ДиректБанк в личном кабинете Sber API.

Январь

19.01.2026

1. Полностью обновили описание процесса авторизации. Вся необходимая информация теперь вынесена на отдельную страницу.

2. Обновили и привели к единому стилю документацию по авторизации:

• /v2/oauth/authorize
• /v2/oauth/token
• /v2/oauth/user-info
• /v2/oauth/revoke
• /v1/change-client-secret

3. На страницах методов /v2/oauth/user-info и /v1/client-info описали все возможные claims, которые возвращаются в ответах.

4. Удалили неактуальный параметр transactionId из описания ответов методов /v2/statement/transactionId и /v2/statement/transactions.

5. Из описания метода /v1/payrolls удалил неиспользуемый статус ответа 202.

6. Дополнили описание параметра uip в документации к методу /v1/payments.

7. В разделы документации, касающиеся платежных поручений и платежных требований, добавлена информация о возможности применения ставки НДС 22%.

8. Удалили упоминание о фиксированном максимуме в 100 операций на странице выписки. С конца марта 2026 года это ограничение будет снято.

Ноябрь

28.11.2025

1. Для клиентов набора "Холдингам" теперь есть возможность подписать согласие на все будущие счета. После его первого подписания открытие новых расчетных и транзитных счетов не требует переподписания согласия.

2. Мы переработали Личный кабинет Sber API:

• Полностью переработанный интерфейс, более современный и интуитивно понятный.

• Возможность подписать одно заявление для получения доступа ко всем доступным наборам Sber API.

• Вместо заявления на отключение — единое Корректирующее заявление. В нем можно:

  • Доподключить новые API-наборы.

  • Отключить выборочно N наборов или все сразу.

  • Отредактировать данные ответственных лиц.

• К одному набору API теперь можно создать несколько client_id для разграничения нескольких интеграций (например, для разных платформ или сайтов).

3. Добавили примеры дайджестов в НСО и депозиты.

4. Обновили стайлгайд:

• Полностью переработан дизайн компонентов и текст гайда.

• Добавлена компактная кнопка для авторизации через СберБизнес ID.

• Реализованы кнопки для корректного отображения в темной теме интерфейса.

• Добавлена таблица с формулировками кнопок, привязанная к конкретным наборам API, для единообразия интерфейсов.

07.11.2025

1. Обновили структуру документации и добавили AI поиск:

• Крупные тематические разделы были переработаны в систему вкладок для удобной навигации.

• На главной странице документации теперь доступен интеллектуальный поиск на базе GigaChat.

2. Реализовали метод для получения бессрочного client_secret.

3. Обновили бизнес-описание сервиса "Безопасные сделки". Разделили объемное описание на отдельные страницы.

4. Добавили новый метод для запроса QR-кода на пополнение номинального счета по реквизитам.

Октябрь

10.10.2025

1. Обновили раздел подключения к Sber API

• Раздел был полностью переработан для большей ясности
• Добавлена исчерпывающая информация, необходимая для начала работы
• Теперь документ описывает все доступные варианты подключения

2. Добавили пошаговое руководство по получению и генерации TLS-сертификата.

3. Изменили состав атрибутов TLS-сертификата:

• Удален атрибут: **2.****5.****4.**10 organizationName (O) (Полное наименование организации)
• Добавлен атрибут: **2.****5.****4.**11 organizationalUnitName (OU) (ОГРН или ОГРНИП)

4. Полностью обновлена инструкция по SDK и представлен новый SDK на Node.js — вся информация для работы с API теперь собрана в одном месте.

Сентябрь

22.09.2025

1. Реализовали возможность создания НСО и депозитов по автокотировке.

2. Полностью обновили раздел документации по Электронной подписи в Sber API. Материал был переработан для большей ясности, а также дополнен наглядными примерами и визуальными схемами для лучшего понимания процесса.

3. Удален код ответа 202 у метода /v1/payment-requests/outgoing.

4. Реализовали новый метод GET /v1/statement/tasks-for-download/{taskId} для получения ссылки на скачивание выписки. Он является полным аналогом текущего метода для файлов.

5. Добавили информацию о формировании дайджеста для запроса на создание электронного реестра на открытие счетов и выпуск карт.

11.09.2025

1. Добавлены ссылки на API эндпоинты в бизнес-сценарий.

2. Реализовали новый сервис "СБП B2B оплата" для создания ссылки на перевод.

3. Обновили бизнес описание сервиса "Безопасные сделки". Реализовали возможность выплат физическим лицам с номинального счета по СБП.

4. Реализовали механизм уплаты налогов в рамках подтверждения смарт-контракта.

5. Опубликована новая страница с описанием сервиса для выставления счетов контрагентам через API. Сервис находится на этапе beta-тестирования и доступен для ограниченного круга партнеров по предварительной заявке. Функционал позволяет создавать счета и получать ссылки для их оплаты без интеграции с OAuth. Для получения доступа необходимо оставить заявку через форму на странице документации.

6. Реализованы методы v2 для работы с электронной подписью. Функционал позволяет перевыпустить УНЭП без посещения банка.

Август

18.08.2025

1. Добавили информацию о валюте, в которой можно разместить депозиты и неснижаемый остаток.

2. Уточнили описание параметров account и payDocs при создании зарплатной ведомости с резервированием и без.

3. Уточнили порядок атрибутов TLS сертификата.

4. Обновили раздел FAQ.

04.08.2025

1. Обновили формат описания для следующих ресурсов:

• /correspondents

2. Описали альтернативный сценарий подписания зарплатного реестра для платформ.

3. Добавили информацию о необходимости установки сертификатов Минцифры для тестового стенда.

4. Во все запросы справочника API добавлены тестовые и промышленные url.

5. Описали сценарий создания платежного поручения за счет кредитных средств.

Июль

21.07.2025

1. Разместили информацию о тестовом стенде на отдельной странице.

2. Уточнили параметры urgencyCode и vat.type в платежных поручениях, добавили описание параметров.

3. Обновили описание сервиса "Моментальные платежи". Описали сценарий B2C платежей.

4. Обновили формат описания для следующих ресурсов:

• /files

5. Добавили информацию о кодировании ссылки авторизации и пример в urlencode.

03.07.2025

1. Разработан SDK для упрощения интеграции учетных систем с Sber API.

2. В заголовке ответов на запросы появился новый параметр X-Rq-Uid. В случае обращении на поддержку Sber API данный параметр позволяет оперативно найти логи на стороне банка. Рекомендуется предусмотреть логирование данного параметра.

3. В сервисе «Безопасные сделки» появился новый метод для запроса списка событий по возврату невыясненных сумм на номинальный счет по факту отказа в зачислении в сторонних банках.

4. Реализовали новый сервис для дистанционного выпуска нового сертификата электронной подписи.

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

6. Новый сервис «Неснижаемый остаток» позволяет корпоративным клиентам напрямую через API-интеграцию управлять размещением денежных средств в виде неснижаемого остатка на расчетном счете.

7. В связи с реорганизацией территориальных учреждений Банка России с 15 июля 2025 года меняются номера БИК и корреспондентского счета для проведения расчетов и платежей.

Апрель

25.04.2025

1. Добавили спецификацию на новые методы для работы с депозитами (/placement/deposit). 2. В новом разделе "Экосистема Сбера" разместили описание и спецификацию методов для работы сервисом SberCrossOrder.

18.04.2025

1. Переложили описание кодов статусов зарплатной ведомости (GET /fintech/api/v1/payrolls/{externalId}/state) на страницу с обновленным форматом.

11.04.2025

1. Обновили атрибутный состав запроса на TLS сертификат,

2. Изменили алгоритм проверки TLS-сертификата. Теперь после загрузки сертификата через supportdbo2@sberbank.ru или выпуска в личном кабинете Sber API сертификат автоматически распространяется на все сервисы Sber API организации. Загрузить сертификат в сервис, принадлежащий другой организации, больше нельзя,

3. Изменили спецификацию сервиса Безопасные сделки. Добавили таблицу ошибок и статусные модели, изменили адрес страницы со спецификацией основного API,

4. Теперь создавать и обновлять токен доступа можно прямо из личного кабинета. Описали это подробно в обновленном разделе,

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

Март

31.03.2025

1. Обновили инструкции по формированию TLS-сертификатов для OC Windows, MacOS, Linux; 2. Для /payments:

• изменили схему не успешных ответов (в ней появилось поле internalErrorCode, значение которого можно указывать при обращении в поддержку),

• вернули описание статусов РПП,

• уточнили значения скоупов; 3. Вернули описание ошибок в /statements; 5. Обновили формат описания для следующих ресурсов:

• /acceptance-advances,

• /partner-info,

• /payment-requests,

• /salary-agreements.

24.03.2025

1. Уточнили регулярное выражение для полей client_secret, new_client_secret и тип метода для обновления Client Secret,

2. Добавили пояснение о том, какой набор атрибутов (клэймов) возвращается в ответе на запрос для получения информации о компании,

3. На страницу описания запроса данных по ранее созданной зарплатной ведомости добавили таблицы с описанием статусов чеков самозанятых для ФНС receiptResult и receiptStatus,

4. Добавили ошибку 429 (Too Many Requests) в описания ответов по следующим методам:

• POST /v1/payments

• POST /v1/payments/from-invoice

• POST /v1/payments/from-invoice-any

• POST /v1/payments/from-invoice-budget

• GET /v1/payments/{externalId}/state

• GET /v1/payments/{externalId}

• POST /v1/pay-doc-cur

• GET /v1/pay-doc-cur/{externalId}/state

• GET /v1/pay-doc-cur/{externalId}

• GET /v1/crypto

• POST /v1/crypto/cert-requests

• GET /v1/crypto/cert-requests/{externalId}/state

• POST /v1/crypto/cert-requests/{externalId}/activate

• GET /v1/crypto/cert-requests/{externalId}/print

• GET /v1/crypto/eio

• POST /v1/crypto/cert-requests/eio

• GET /v1/crypto/cert-requests/eio/{externalId}/state

• POST /v1/crypto/cert-requests/eio/{externalId}/activate

• POST /v1/crypto/cert-requests/eio/{externalId}/print

• GET /v1/client-info

• GET /v1/correspondents/rur

• GET /v1/dicts?name

5. Обновили формат описания для следующих ресурсов:

• /credit-offers

17.03.2025

1. Обновили формат описания для следующих ресурсов:

• /pay-doc-cur
• /credit-requests
• /payments
• /corporate-cards
• /client-info
• /payrolls
• /nominal-account
• /statement
• /generic-letters
• /card-issues

2. Описали коллекции запросов. Этот инструмент разработчика поможет тестировать и интегрировать быстрее.

3. В "Бизнес-картах" описали новые методы для переводов по СБП.

4. В "Зарплатный проект" вернули методы для открытия счетов и выпуска карт Сбера.

01.03.2025

• Добавили в модель /ic/sso/api/v2/oauth/authorize новый необязательный параметр prompt.
• В больших файлах /fintech/api/v1/files/upload указали актуальные форматы файлов для загрузки в Банк.
• В сведения о владельце сертификата добавлены необязательные атрибуты SN и GN.
• Указали допустимый ТПС для эндпоинтов связанных с функционалом выписки.
• Добавили новый раздел "Коллекция готовых запросов".

Ноябрь

29.11.2024

Вообще наша документация рассчитана на широкий круг специалистов. Тем не менее мы разделили пользователей на две основные группы: бизнес-пользователи (руководители компаний, проектов, владельцы продуктов, аналитики и другие) и разработчики (архитекторы, программисты, тестировщики).

Задача очевидна – сделать документацию удобной для всех. В течение года наша команда работала над подробным описанием всех сервисов в Sber API.

Итогом этой работы стало разделение документации на два раздела: «Бизнес-сценарии» — для бизнес-пользователей и «Справочник API» — для разработчиков. Пользуйтесь!

Отметим, что раздел «Бизнес-сценарии» будет полезен не только для бизнеса, но и для системных аналитиков, поскольку содержит диаграммы последовательности, которые подробно описывают взаимодействие вашей системы с Sber API в рамках интеграции.

Что изменилось?

1. Основное навигационное меню
Теперь оно станет проще и интуитивно понятнее. Уходим от сложных терминов вроде "Host-to-host", "Holdings", "B2BSaaS" и прочих сокращений. Все стало логичнее:
- Для бизнес-пользователей – раздел "Бизнес-сценарии",
- Для разработчиков – "Справочник API".

Разделы "Другие b2b-решения" и "Другие API решения" больше не нужны – вся необходимая информация теперь аккуратно распределена по соответствующим категориям.

2. Разводящая страница раздела «Бизнес-сценарии»
При нажатии на этот раздел вы попадете на страницу, которая поможет точнее определить задачу пользователя документации.

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

3. Раздел "Справочник API"
Выбрав «Справочник API», вы попадете на страницу, где на первом уровне представлены все ресурсы (объекты), с которыми можно взаимодействовать через API. На втором уровне – сами API-запросы для этих ресурсов.

4. Отдельная страница с описанием API-запроса

22.11.2024

• Сервис «Большие файлы» — ваш помощник в работе с документами.
  С его помощью вы сможете загружать документы в банк для различных целей. Например:
  • предоставление документов в валютный контроль банка;
  • экспорт файлов с выписками по счетам для импорта в другие системы.
  
  Чтобы вашей команде было проще разобраться, как технически реализовать функционал, мы добавили диаграммы последовательности. Это сэкономит время и силы на этапах проектирования и тестирования интеграции.
  Все запросы API описаны в унифицированном формате, который знаком вам по другим сервисам.

20.11.2024

• Мы объединили два раздела в один. Теперь все, что касается Sber API для внешнеэкономической деятельности – в новом разделе «ВЭД».
  Также мы добавили наглядное описание работы сервиса, чтобы вы понимали, какие возможности он предоставляет с помощью API.
  В этом обновлении мы использовали унифицированное описание для схем моделей запросов и ответов, чтобы обеспечить единообразие при работе с каждым сервисом.

15.11.2024

• Мы изменили ответ на запрос Получение информации по бизнес-картам /fintech/api/v2/сorporate-cards/transfer/list. Теперь он включает данные о лимитах по бизнес-карте.
• Исправили ошибку в описании запроса Создание заявления на перевод по бизнес-карте /fintech/api/v2/corporate-cards/transfer/commission. Ранее поля receiverInfo и senderInfo ошибочно указывались как массивы, теперь они правильно описаны.
• Для следующих API-запросов добавили ошибку 429 (Too Many Requests):
  • GET /v2/statement/transactionId/print
  • GET /v2/statement/summary
  • GET /v2/statement/transactions
  • GET /v2/statement/transactionId
  • GET /v1/statement/print
  • GET /v1/statement/download/{fileId}
  • GET /v2/statement/increment
  • GET /v1/files/tasks-for-download/{taskId}
  • GET /v1/statement/files
  • POST /v1/payment-requests/outgoing
  • GET /v1/payment-requests/outgoing/\{externalId\}/state
  • POST /v1/payrolls
  • GET /v1/payrolls/\{externalId\}/state
  • GET /v1/payrolls/\{externalId\}
  • GET /v1/salary-agreements

11.11.2024

• Подробнее описали возможные ошибки, которые могут возникнуть при получении, обновлении и отзыве access_token. Это поможет вам уменьшить количество проблем у пользователей при авторизации через СберБизнес ID.

01.11.2024

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

• Удалили раздел Тарификация в связи с отсутствием платы за подключение и использование Sber API

• В запросе /fintech/api/v1/acceptance-advances/{externalId} изменили обязательность атрибута date в ответе 200 (OK) - было required, стало optional

• Изменили формат возвращаемых в ответе на запрос /ic/sso/api/v2/oauth/user-info Получение информации (user-info) значений для следующих атрибутов (claim):

  Наименование атрибута (claim)	Было	Стало
  tbIdentCode	"tbIdentCode": "38"	"tbIdentCode": "10000367"
  terBank	"terBank": "Московский Банк Сбербанка РФ"	"terBank": "Московский банк"
  orgLawFor	"orgLawForm": "Открытое акционерное общество"	"orgLawForm": "Открытые акционерные общества"

• Перестанут возвращаться в ответе на запрос /ic/sso/api/v2/oauth/user-info Получение информации (user-info):

  • summOfferSmartCredit (Сумма предодобренного предложения по смарт-кредитам)
  • offerSmartCredit (Предодобренные предложения по смарт-кредитам)

• В ответе на запрос /ic/sso/api/v2/oauth/user-info Получение информации (user-info) будет возвращаться новай атрибут - emailConfirmed (Адрес электронной почты пользователя подтвержден)

Октябрь

25.10.2024

• В запросах /fintech/api/v1/acceptance-advances/{externalId} и /fintech/api/v1/acceptance-advances/{externalId}/state в описание к ошибке 404 Not found добавили информацию о возможности удаления документа Пользователем

• В запросах /fintech/api/v1/payments/from-invoice, /fintech/api/v1/payments/from-invoice-any и /fintech/api/v1/payments/from-invoice-budget скорректировали регулярное выражение для атрибута rate из объекта vat

  Было	Стало
  ^[0-9]2$	^(0|10|20)$

16.10.2024

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

14.10.2024

• Упростили графическую схему работы сервиса Корпоративные подписки - теперь она содержит самую основную и полезную информацию, которая позволяет легко понять принцип работы подписки через СберБизнес.
• Также в диаграммах последовательностей к описанию сервиса Корпоративные подписки добавили уточняющую информацию. Она позволит вашей команде разработки сэкономить время на этапах проектирования и тестирования.

11.10.2024

• Обновили раздел Безопасные сделки. Изменили запрос для создания бенефициара. Теперь для этого используется ресурс /v1/nominal-account/beneficiaries/create. Добавили новые запросы на удаление бенефициара и изменение информации по бенефициару.
• Обновили раздел Корпоративные подписки. Поле date в модели ответа 200 (ОК) на запрос получения заявления ЗДА станет необязательным с 02 ноября 2024.
• Убрали ссылки на Swagger: функциональность будет отключена 31 октября 2024. Для наиболее актуальной информации обращайтесь к спецификации Sber API.

Сентябрь

13.09.2024

• В сервисе Моментальные платежи изменили модель ссылки переадресации пользователей на платежное поручение:

  Было	Стало
  {контур Банка}/ic/**dcb**/index.html#/payment-creator/\{externalId\}?backUrl={backUrl}	{контур Банка}/ic/**ufs/rpp-light**/index.html#/payment-creator/\{externalId\}?backUrl={backUrl}

09.09.2024

По описанию продукта Платежные поручения провели редизайн:

• Сформировали обновленную схему работы - она стала проще, понятнее и лаконичнее.
  Благодаря обновлению вы сможете сохранить время на этапах проектирования и разработки.
• Описали все запросы в едином стиле. Каждая страница спецификации начинает имет единую узнаваемую структуру. Вам будет легче ориентироваться в нашей документации.
• Перечислили возможные ошибки и рассказали, как их устранить.

02.09.2024

Продолжаем постепенно делать нашу спецификацию удобной и понятной.

Провели редизайн страниц с описанием продукта Зарплатный проект в Sber API.

Разработали общую схему работы продукта — вы сможете быстрее разобраться с доступной функциональностью продукта в API. Также мы сформировали подробные диаграммы последовательностей, чтобы сэкономить время вашим аналитикам. И для каждого запроса подготовили описание в едином стиле с подробными моделями запросов и ответов, ошибками и способами их решения.

Август

29.08.2024

• Исправили опечатки и ошибки по тексту
• Изменили обязательность заполнения атрибута deliveryAmount в модели запроса /fintech/api/v1/credit-requests Создание кредитной заявки - сделали его опциональным.

26.08.2024

• Сервис Безопасные сделки для всех новых client_id доступен по умолчанию. Раньше один из шагов подключения сервиса было обращение в Техническую поддержку банка, и сейчас его выполнять не потребуется.

• В сервисе Корпоративные подписки изменили модель ссылки переадресации пользователей на заявление на ЗДА:

  Было	Стало
  {контур Банка}/ic/dcb/index.html#/acceptance-advance-creator/\{externalId\}?backUrl={backUrl}	{контур банка}/ic/ufs/advance-acceptance/index.html#/advance-acceptance-creator/\{externalId\}?backUrl={backUrl}

24.08.2024

Обновили файл с описанием авторизации v1:

• При успешной авторизации пользователя СберБизнес ID возвращает его на адрес, указанный в параметре redirect_uri. Строка браузера содержит параметры code, state и nonce. nonce больше не будет возвращаться в качестве одного из параметров в строку браузера. Этот параметр вы можете получить в id_token, который получаете при обмене code на access_token.
• Параметр scope в ссылке авторизации v1 пользователя будет работать аналогично v2 - в scope необходимо перечислить все операции и атрибуты, до которых у вас, как у Партнера, будет доступ при успешной авторизации Пользователя. О работе scope подробнее можно ознакомиться в соответствующем разделе документации.

23.08.2024

Разработали методы v2 для продукта Бизнес-карты.
Выводим из эксплуатации методы v1. Поэтому все старые ссылки на описание по бизнес-картам будут вести на новые страницы.

• На новой странице добавили для вашего удобства общую схему работы методов Sber API по бизнес-картам. Вам будет легко понять общий принцип работы и определить, как наше решение интегрировать в свои системы.
• Методы по бизнес-картам в API позволят вам реализовать функциональность получения информации по картам пользователя и осуществлять переводы. Разработали диаграммы последовательностей, которые сэкономят время вашим аналитикам и разработчикам.
• Описание всех методов в едином стиле с подробным описанием моделей запрсоов и ответов, ошибками и способами их решения. Команде разработке будет в помощь при возникновении сложностей.

16.08.2024

• Обновили описание атрибутов incomeTypeCode и urgencyCode для ресурса /v1/payments - описание стало простым и понятным, вам будет легко определить способ его заполнения

• Добавили информацию с описанием требований к формированию дайджеста. Информация позволит при создании дайджеста сразу учесть все важные моменты и сократить количество возможных ошибок.
  Digest (дайджест) – набор значимых полей платежного документа, который подписывается электронной подписью (ЭП).

• Добавили на странице Работа с ЭП в Sber API в раздел Подпишите документ и отправьте в Банк информацию о передаче ЭП в запросе. Мы подробно рассказали, как именно сформированную ЭП по дайджесту необходимо передать в отправляемом запросе API.

• Упростили название операции сервиса Безопасные сделки для добавления в scope ссылки авторизации:

  Было	Стало
  nominal_accounts_1	nominal_accounts

15.08.2024

• Обновили статусную модель заявления на выпуск сертификата ЭП

05.08.2024

• Исправили опечатки по тексту

• Изменили модель ответа 200 (OK) для ресурса /v1/client-info. Параметры, которые больше не будут возвращаться в ответе:

  Атрибут/Объект	Описание
  cardNum	Номер таможенной карты
  offerSmartCredit	Предодобренные предложения по смарт-картам
  orgBusinessSegment	Бизнес-сегмент
  orgBusinessSegmentName	Наименовение бизнес-сегмента
  orgCrmId	Идентификатор организации в CRM
  orgGuid	Глобальный идентификатор организации
  orgId	Идентификатор организации в СББОЛ
  summOfferSmartCredit	Сумма предодобренного предложения по смарт-кредитам
  аccounts. businessNewType	Признак бизнес-счета "нового" типа
  аccounts. creditBlockedInitiator	Наименование органа, наложившего арест
  аccounts. creditBlockedTaxAuthorityCode	Код налогового органа, наложившего арест
  аccounts. debitBlockedInitiator	Наименование органа, наложившего арест
  аccounts. debitBlockedTaxAuthorityCode	Код налогового органа, наложившего арест
  accounts. mode	Режим работы счета
  accounts. overdraft	Сумма общего лимита овердрафта в валюте счета
  accounts. passive	Признак пассивности счета
  dboConract. financeBlock	Признак финансовой блокировки
  Блок orgIndustry

• Расширили описание возможных ошибок для ресурсов /v1/crypto/cert-requests Создание запроса на выпуск сертификата и /v1/crypto/cert-requests/eio Создание запроса на выпуск сертификата ЕИО.
  Информация позволит вам понимать возникающие ошибки и оперативно их исправлять.

• Изменили модель ответа 200 (OK) для ресурса /v1/partner-info/advance-acceptances Получение сведений о подписчиках:

  • Убрали массив объектов bundles
  • Убрали параметр payerOrgIdHash

01.08.2024

Провели редизайн описания работы продукта Выписки по счету.

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

Июль

23.07.2024

• Добавили в описание ресурса /fintech/api/v1/credit-offers Получение информации по кредитным предложениям код возврата 204 (No Content). Данный код возврата позволит понять, что для Платформы/Клиента отсутствуют кредитные предложения.

22.07.2024

• Расширили описание возможных ошибок при создании черновика заявления на ЗДА. Информация будет полезна для оперативного решения возможных проблем при попытке создания документа.
• Добавили регулярные выражения для атрибутов contractNumber, number и obligation в описании модели запроса /v1/acceptance-advances Создание черновика заявления ЗДА. Информация позволит понять, какие символы и в каком количество доступтимо использовать при заполнении данных атрибутов.
• Скорректировали статусную модель заявления на выпуск ЗДА:
  • Добавили статус ACCEPTED, который означает, что банком принят документ и по нему продолжается внутренние проверки,
  • Перенесли статус CHECKERROR в блок окончательных статусов.
• Добавили в статусную модель Платежного требования статус REFUSEDBYBANK. Статус означает отказ сотрудником Банка по результатам ручной обработки.

12.07.2024

• Скорректировали формулу составления индентификатора сертификата BicryptId:

  Было	Стало
  certCenterCode + certCenterNum + s + ФамилияИО	certCenterCode + (certCenterNum +1) + s + ФамилияИО

  Подробнее в разделе о формировании идентификатора.

• Добавили уточнение в описание атрибутов certsCA и cert в ресурсах /v1/crypto и /v1/crypto/eio:
  Сертификаты возвращаются в формате base64. Для дальнейшего использования потребуется их раскодировать.

05.07.2024

• Для удобства работы с описанием работы ЭП в Sber API методы для работы с криптографией вынесли на отдельные страницы:
• Расширили описание принципа формирования идентификатора сертификата ЭП BicryptId. Информация позволит вам снизить количество ошибок и выработать корреткный механизм формирования идентификатора.
• Добавили описание Клиентского пути для сервиса Моментальные платежи. Теперь у вас есть возможность понять, как путь пользователя может выглядеть его глазами.

Июнь

27.06.2024

• Из описания атрибута purpose ресурса Создание платежного требования /v1/payment-requests/outgoing выделили в отдельный блок рекомендации по заполнению Назначения платежа.
  Рекомендации подробно и понятно описывают принцип заполнения атрибута, что сэкономит вам время на подбор способа его формирования.
• Расширили описание атрибута incomeTypeCode в ресурсе /v1/payrolls. Теперь указаны все доступные значения для заполнения с расшифровками этих значений. Информация будет полезна при маппинге полей с вашей системой, с которой ведется интеграция ресурса отправки зарплатных ведомостей.
• Теперь в успешном ответе запроса Получения заявления ЗДА /v1/acceptance-advances/\{externalId\} будет возвращаться дополнительный атрибут payerCorrAcc - корреспондентский счет получателя. Данный атрибут вы сможете использовать при создании исходящего платежного требования с помощью ресурса /v1/payment-requests/outgoing, например, в рамках сервиса Корпоративные подписки.
• Внесли изменения в модель ресурса Создания заявки на кредитный договор /v1/credit-requests:
  • Изменили обязательность объекта payeeInfo - было optional, стало required
  • Изменили обязательность атрибута creditProductCode - было required, стало optional

17.06.2024

Провели редизайн описания сервиса Кредит в корзине.

Что изменилось:

• Структура подачи информации стала логичнее и понятнее;
• Упростилась общая схема работы сервиса;
• Сформированы и добавлены подробные схемы разработки функциональности при помощи сервиса;
• В едином стиле переформатированы описания всех используемых в сервисе ресурсов;
• Для каждого ресурса создано описание возможных ошибок и способов их решения.

15.06.2024

Провели редизайн описания сервиса по работе с криптографическими ресурсами - раздел назвали Работа с ЭП в Sber API.

Что изменилось:

• На одной странице агрегировали всю информацию об ЭП и работе с ней в Sber API, что сделает изучение работы сервиса работы с криптографией удобнее и проще;
• Структура подачи информации стала логичнее и понятнее - теперь рассказываем о работе с криптографией по принципу "от общего" - "к частному";
• Сформировали общую упрощенную схему работы с ЭП и для каждого отдельного этапа разработали sequence-диаграммы, которые описывают полный механизм работы функциональности
• Структурировали описание ресурсов криптографии и дали исчерпывающее описание их работы, возможных ошибок и способов их решения

14.06.2024

• В целях усиления мер обеспечения кибербезопасности при предоставлении информации, относящейся к банковской тайне и содержащей персональные данные Клиента, в соответствии с 152-ФЗ ("О персональных данных") и 149-ФЗ ("Об информации, информационных технологиях и о защите информации") были выполнены доработки в сервисе Sber Api.
  Теперь при загрузке/скачивании файлов: Сведения о валютных операциях, Справка о подтверждающих документах, Валютный контракт, Ведомость банковского контроля, Письма для целей валютного контроля, в рамках сервиса «большие файлы» Вам потребуется TLS-сертификат, привязанный к Вашему внешнему сервису.
  В связи с этим, если Ваш в запрос на загрузку/выгрузку файла, не зашифрован TLS сертификатом, то возможно будет лишь направить запрос на создание валютного документа, но без загрузки файла.
• При скачивании файла с Выпиской стоит ограничение на размер файлов до 40 мб.

13.06.2024

• Временно вывели из эксплуатации ряд ресурсов: /v1/payments-registry, /v1/payments-registry/\{externalId\}/change-state, /v1/debt-registries, /v1/debt-registries/\{externalId\}/state.
  Отдельно сообщим, когда вернем их в работу.

Май

31.05.2024

• В модель ресурсов Запрос на заявление на регистрацию валютного контракта (ВК) /v1/bank-control-statements/reg-curr-contracts и Запрос на получение ранее отправленного заявления на регистрацию валютного контракта /v1/bank-control-statements/reg-curr-contracts/\{externalId\} добавлен новый необязательный атрибут isAffiliatedPerson (boolean) "Аффилированное лицо"

• В ресурсе Получение писем для целей ВК /curr-control-messages/from-bank вложения, загруженные из банка, будут временно не доступны для скачивания по fileId до 01.11.24. Вложения будут доступны для скачивания в формате base64 в блоке Attachment.

• Исправили опечатку в описании атрибута purpose в модели ресурса Создание платежного требования /v1/payment-requests/outgoing:

  Было	Стало
  "Оплата_по_договору_[contractNumber]_от_[date]._НДС_[rate]%_[amount]_рублей_[type]._[Любая_ваша_информация]"	"Оплата_по_договору_[contractNumber]_от_[contractDate]._НДС_[rate]%_[amount]_рублей_[type]._[Любая_ваша_информация]"

• Внесли корректировку в описание ресурса Создание запроса ссылки на скачивание файла /v1/files/download - сделали его простым и понятным.

29.05.2024

• В статусную модель по Зарплатной ведомости (Host-2-host и Holding) добавили новые возможные статусы

  Статус	Значение	Состояние
  SENDING_TO_RZK	Направлен контролирующей организации	Промежуточный/Продолжать опрашивать
  SENT_TO_RZK	Отправлено в СБК	Промежуточный/Продолжать опрашивать
  WAITING_FOR_RZK	Ожидание от СБК	Промежуточный/Продолжать опрашивать
  PROCESSING	Согласование контролирующей организацией	Промежуточный/Продолжать опрашивать
  REFUSED_BY_RZK	Отказан контролирующей организацией	Конечный/Прекратить опрашивать

• Скорректировали описание атрибута result в моделе ресурса /v1/payrolls: возможные статусы начисления Зачислено и Не зачислено

• На страницу сервиса СберБизнес ID в раздел Визуальные гайдлайны добавили ссылку на ресурс Figma

• Изменили дополнительную информацию в описании сервиса Моментальные платежи: переформулировали описание заполнения объекта vat - стало понятнее и легче для восприятия.

• В связи с отменой комиссии за использование канала убрали из описания функциональности Личного кабинета Sber API информацию о способе получения данных по комиссиям

28.05.2024

Опубликовали описание сервиса Безопасные сделки.

Безопасные сделки — это технология Сбера для защищенных расчетов между контрагентами. Технология предоставляет возможность интеграции по API для торговых площадок (Маркетплейсов), позволяет осуществлять безопасные расчеты покупателей (бенефициаров) с продавцами (поставщиками).

15.05.2024

С 01.06.2024 года отменена комиссия в канале Sber API.

08.05.2024

• Исправили орфографические ошибки и поправили некоторые формулировки (сделали их легче для восприятия)
• Добавили уточнение к описанию атрибута type в ресурсе /v1/files/upload:
  
  Поддерживаемые форматы файлов к валютным документам: pdf, jpeg, jpg, png, tiff, tif, pcx
  Максимальный размер файла: 30 мб
  
  Поддерживаемые форматы файлов к остальным документам: doc, docx, xls, xlsx, ppt, pptx, csv, dbf, rtf, txt, pdf, jpg, png, gif, bmp, tiff, zip, rar, arj, xml, jpeg
  Максимальный размер файла: 50 мб
• Добавили уточнение к описанию атрибута bic (БИК банка сотрудника) ресурсе /v1/payrolls: заполняется в случае, если счет сотрудника открыт не в СберБанке

06.05.2024

Провели рефакторинг механизма работы сервиса Корпоративные подписки:

• В рамках сервиса СберБизнес ID пользователь Клиента подписывает только Согласание на передачу данных
• Акцепт оферты происходит через Платформу Партнера
• Создание Заранее данного акцепта происходит отдельным шагом после подписания Согласия на передачу данных

На странице сервиса:

• Обновили общую схему сервиса
• Скорректировали детализированные sequence-диаграммы по функциональности "Оформить подписку" и "Списание платы за использование сервиса"
• Добавили используемые ресурсы для реализации механизмов

Апрель

23.04.2024

С 1 апреля 2024 года для ряда ресурсов сменился тип тарификации с тарифицируемого на служебные.

Актуальную информацию по тарификации Sber API можно посмотреть на соответствующей странице (уже нельзя посмотреть, т.к. раздел был удален).

18.04.2024

Изменения по сервису "Кредит в корзине":

• На странице сервиса актуализировали скриншоты модальных окон
• Обновили SDK Виджета подключения в Инструкции по установке
• В описании убрали информацию о рассрочке и скорректировали формулировки на кнопках

12.04.2024

• Для ресурса /v1/statement/print скорректировали описание: в модели ответа параметр "taskId" переименовали в Number и в примере ответа указали корректный пример. Ответ приходит обычным номером, а не JSON.
• Для ресурса /v1/statement/files скорректировали описание: в модели ответа параметр "taskId" переименовали в Number и в примере ответа указали корректный пример. Ответ приходит обычным номером, а не JSON.
• Для ресурса /v1/files/tasks-for-download скорректировали описание:
  • в модели запроса уточнили способ указания идентификатора задачи на скачивание - он указывается в path-параметре
  • в модели ответа уточнили статусы состояния ссылки на загрузку выписки
• Внесли небольшие корректировки по тексту (исправили опечатки)
• В целях усиления мер обеспечения кибербезопасности при предоставлении информации, относящейся к банковской тайне и содержащей персональные данные Клиента при использовании ресурса /v1/files/upload можно загружать файлы на ресурс Банка для дальнейшей привязки к документу в форматах pdf, jpeg, jpg, png, tiff, tif, pcx.
  Форматы файлов txt, doc, docx, rar, zip не будут приняты в обработку в канале Sber API.

05.04.2024

• Убрали на странице Формирование электронной подписи с помощью программных средств информацию о возможности получения токена для тестового стенда. Сейчас данная возможность не предоставляется.
• Скорректировали описание параметра docDate109 в модели ответа ресурсов /v1/statement/transactions и /v2/statement/transactions - Дата налогового документа (реквизит - 109), использует тип данных string с размерностью 1,10
• Упростили и сделали понятнее описание процесса формирования параметра BicryptID для осуществления запроса на выпуск нового сертификата ЭП.
• Скорректировали пример запроса в ресурсе Отправка зарплатной ведомости v1/payrolls

02.04.2024

Провели редизайн описания сервиса Корпоративные подписки. Что изменилось:

• структура подачи информации стала логичнее и понятнее;
• упростилась общая схема работы сервиса;
• сформированы и добавлены подробные схемы разработки функциональности при помощи сервиса;
• в едином стиле переформатированы описания всех используемых в сервисе ресурсов;
• для каждого ресурса создано описание возможных ошибок и способов их решения.

Март

29.03.2024

Банк начинает процесс перехода на использование подписи в формате CaDES-BES.

• В части подписи банка запланированы доработки по переходу на формат CaDES-BES. Начиная с 01.05.2024 подпись банка может приходить как в текущем raw-формате, так и в формате CaDES-BES. В период с 01.05.2024 по 30.09.2024 вам необходимо обеспечить одновременную поддержку проверки подписи банка текущего raw-формата и нового CaDES-BES.
  Подпись банка будет в формате CaDES-BES:
  • Подпись открепленная – detatched. Алгоритм цифровой подписи ГОСТ Р 34.10-2012 для ключей длины 256 бит.
  • Блок с сертификатами (Certificates) включает сертификаты подписанта и промежуточные сертификаты.

• В ряде запросов Банк предлагает возможность получение ответа в формате JOSE в представлении JWS Compact Serialization.
  Из заголовока (Header) получаемого JWS будет исключен UUID сертификата технологического криптопрофиля банка, которым подписан JOSE.
• Изменения в ресурсах /v1/crypto и /v1/crypto/eio
  В связи с тем, что блок с банковскими сертификатами для проверки подписи будет передаваться в составе подписи банка, из ответов /v1/crypto и /v1/crypto/eio будут исключены данные о банковских сертификатах:
  • certBank – сертификат технологического криптопрофиля банка;
  • certBankUuid – уникальный идентификатор сертификата технологического криптопрофиля банка.

Помимо изменений в подписи Банка, убедитесь, что используемые вами электронные цифровые подписи (ЭП) в Sber API соответствуют всем необходимым требованиям и условиям.

27.03.2024

• Обновили публичный ключ Банка.

25.03.2024

• В сервисе Большие файлы у ресурса Получение статуса загрузки /v1/files/upload/{fileId}/state скорректировали статусную модель - убрали неактуальный статус ATTACH_ERROR
• Выводим из эксплуатации ресурсы сервиса Управление тарифными планами - страница сервиса больше недоступна
• Внесли небольшие правки в формулировки описания функциональности Личного кабинета - текст стал понятнее и легче воспринимается
• Скорректировали опечатку в схеме обновления access_token - при запросе с просроченным access_token СберБизнес ID возвращает ответ 401 Unauthorized

22.03.2024

Провели редизайн описания сервиса Моментальные платежи:

• Сформировали и добавили подробную схему работы сервиса.
• В едином формате сформировали описание всех используемых в сервисе ресурсов;
• Для каждого ресурса сформулировали описание возможных ошибок и способов их решения.

13.03.2024

• Теперь при запросе информации по кредитным предложениям через ресурс /v1/credit-offers, параметр checkSum может содержать до 16 символов, вместо предыдущих 10.
• При создании заявки на кредитный договор через ресурс /v1/credit-requests в параметре orderId длина строки ограничена 50 символами - указали эту информацию в модели запроса.
• Требование заполнения параметра Number при запросе на выпуск нового сертификата стало обязательным как для ресурса /v1/crypto/cert-requests, так и для ресурса /v1/crypto/cert-requests/eio.
• При получении реестра платежей с использованием ресурса /v1/payments-registry вы получаете информацию о платежах физических лиц, принятых и перечисленных банком на ваш расчетный счет - внести это примечание.

12.03.2024

Провели редизайн описания сервиса СберБизнес ID:

• Сформировали и добавили подробную схему работы сервиса.
• Расширили информацию о способе получения кода авторизации (authorization code) для последующего обмена на токены доступа (access_token) и обновления (refresh_token).
• В едином формате сформировали описание всех используемых в сервисе ресурсов;
• Для каждого ресурса сформулировали описание возможных ошибок и способов их решения.

Февраль

28.02.2024

На странице Зарплатная ведомость добавили новые возможные статусы зарплатной ведомости, которые приходят в ответ на запрос GET-ресурса /v1/payrolls/\{externalId\}/state.

Новые добавленные статусы:

21.02.2024

• На странице Тестовые и промышленные URL Sber API скорректировали URL для использования нового тестового контура Банка для открытия форм оплаты счета и аутентификации через СберБизнес.

  Было	Стало
  https://iftfintech.testsbi.sberbank.ru:9443	https://efs-sbbol-ift-web.testsbi.sberbank.ru:9443

• Уточнили способы получения TLS-сертификата для промышленного стенда в зависимости от типа разрабатываемой интеграции на странице Получение TLS

  Было

  Стало

  Для начала интеграции на промышленном стенде получите TLS-сертификат и установите цепочку доверенных TLS-сертификатов. Для этого сгенерируйте и скачайте TLS-сертификат из личного кабинета Sber API или получите по инструкции для Windows, или по инструкции для openssl.

  Для начала интеграции на промышленном стенде получите TLS-сертификат и установите цепочку доверенных TLS-сертификатов. Способ получения TLS-сертификата зависит от типа разрабатываемой интеграции: 1. Если подключаетесь к Sber API для разработки прямой интеграции (H2H) либо интеграции для управления холдингом (Holding), то воспользуйтесь функциональностью Личного кабинета; 2. Для других вариантов подключения к Sber API получите сертификат по инструкции для Windows или по инструкции для openssl.

• Исправили опечатки в ряде страниц.

• На странице Большие файлы скорректировали возвращаемый Банком host в URL для загрузки файлов в примерах ответов ресурсов Получение статуса файла /v1/files/downloadState, Получение ссылки для загрузки формы /v1/files/tasks-for-download и Получение статуса загрузки /v1/files/upload/{fileId}/state.

  Было	Стало
  https://bf.sberbank.ru:9443	https://apifiles.sberbank.ru:9443

15.02.2024

Провели редизайн описания сервиса Бизнес-карты для H2H интеграции:

• Представили возможности сервиса с точки зрения функциональности;
• Функциональность представили в виде сценариев с подробными инструкциями по их реализации;
• В едином формате сформировали описание всех используемых в сервисе ресурсов;
• Для каждого ресурса сформулировали описание возможных ошибок и способов их решения.

10.02.2024

Изменили тарификацию ресурса GET /v1/corporate-cards: с 01.02.2024 он становится бесплатным. Актуальную информацию по тарификации Sber API можно посмотреть на соответствующей странице (уже нельзя посмотреть, т.к. раздел был удален).

Декабрь

20.12.2023

• 20 декабря команда Sber API объединила документацию на витрине API по двум каналам — Sber API и SberBusinessAPI — для улучшения клиентского опыта. В результате этого изменения был добавлен новый раздел под названием "Другие API-решения", который включает в себя описания публичных API:

1. Аккредитивы ФЛ (физические лица) 2. Аккредитивы ЮЛ (юридические лица) 3. Сервис управления сертификатами аутентификации 4. Оценка деловой репутации и фрод 5. Плати QR 6. SberVisor

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

Ноябрь

14.11.2023

Перенесли ресурсы из корпоративных подписок в другие API-решения

• Информация по офертам клиента
• Информация по тарифам сервисов
• Клиенты с небанковскими сервисами
• Получение документа по списанию средств
• Списание платы за использование сервиса

02.11.2023

• На странице Формирование электронной подписи с помощью USB токена Обновлено описание проверки подписи с подписанными данными

• Обновлен формат дайджеста на странице Покупка и конверсия валюты

Сентябрь

25.09.2023

Обновлена страница "С чего начать":

• Изменен заголовок с "Приступая к работе" на "С чего начать"
• Обновлено содержимое страницы "С чего начать"
• Добавлен подраздел "Шаги подключения" в раздел "С чего начать"
• Обновлено содержимое страницы Личный кабинет
• Добавлены страницы Функции личного кабинета, и Роль разработчика SberBusinessAPI в подраздел Личный кабинет вместо текущих страниц
• Обновлено содержимое страницы TLS

11.09.2023

Добавлено примечание на страницу

Август

25.08.2023

Обновлен раздел создание и отправка в банка b2b/b2p-перевода с бизнес-карт:

• Обновлена ​​статусная модель
• Обновлено описание кодов возврата и текстов ошибок
• Добавлен пример неудачного ответа на получение статуса заявки на перевод
• Добавлены требования для формирования дайджеста
• В раздел бизнес-карт добавлены ключи шифрования для ИФТ, ЭДУПИР и ПРОМ

24.08.2023

• Добавлены описания услуг h2h, b2bsaas и холдинга.
• Добавлена ​​инструкция как подключить дочернюю компанию для холдинга.

Июль

13.07.2023

Июнь

20.06.2023

Апрель

25.04.2023

17.04.2023

• Исправили пример запроса POST /v1/files/download.

• Изменили типы данных для нескольких полей в модели ответа GET /v1/credit-offers:

  Наименование	Было	Стало
  sumMax	number(19,2)	string
  sumMin	number(19,2)	string
  rate	number(19,2)	string
  availableSum	number(19,2)	string

04.04.2023

Добавили ресурсы v2 по получению выписки в список тарифицируемых:

/v2/statement/transactions

/v2/statement/transactionId

/v2/statement/transactionId/print

/v2/statement/summary

Март

30.03.2023

Изменили Условия доступности покупки в кредит для сервиса «Кредит в Корзине»:

• ОПФ организации - ИП/ООО/ГКФХ.
• Дата создания организации 6 или более месяцев от текущей даты.

20.03.2023

Изменили формулировку в разделе Получение TLS.

Было: файл с запросом на сертификат передать своему куратору.

Стало: файл с запросом на сертификат необходимо направлять на п/я supportdbo2@sberbank.ru.

14.03.2023

14.03.2023

Вынесли Сервисы SberBusiness Payments в отдельный раздел.

09.03.2023

Удалили сервисы холдирования денежных средств на расчетном счете клиента: POST /v1/cash-hold/hold, GET /v1/cash-hold/hold/{externalId}/state, POST /v1/cash-hold/unhold, GET /v1/cash-hold/unhold/{externalId}/state, POST /v1/cash-hold/unhold-transfer, GET /v1/cash-hold/unhold-transfer/{externalId}/state.

Февраль

16.02.2023

08.02.2023

• Исправили назначение статуса REFUSED_BY_RZK (был Промежуточным, стал Окончательным) для GET /v1/payments/{externalId}/state.

• Убрали параметр sendReport из модели запроса и ответа POST /v1/card-issues.

Январь

18.01.2023

Добавили раздел Получение операций по счету в ОНЛАЙН режиме с обновленными ресурсами GET /v2/statement/transactions, GET /v2/statement/transactionId, GET /v2/statement/transactionId/print

Ноябрь

23.11.2022

Добавили обязательность заполнения поля payeeAccount для ресурса Создание платежных требований.

19.11.2022

Убрали параметры acceptStartDate и acceptLastDate из модели ответа GET /v1/partner-info/advance-acceptances.

Октябрь

19.10.2022

Добавили правило заполнения параметра payerKpp (КПП плательщика) для POST /v1/payments/from-invoice-budget.

Сентябрь

15.09.2022

• Исправили пример запроса GET /v1/statement/transactions/{transactionId}/print.

Август

31.08.2022

• Обновили архив с готовым тестовым TLS-сертификатом в разделе Получение TLS.

• Добавили пример отправляемого файла реестра задолженности в раздел Реестр задолженности.

• Добавили пример получаемого файла реестра платежей в раздел Реестр платежей.

• Исправили назначение статуса CHECKERROR (Был Промежуточным, стал Окончательным) для GET /v1/business-cards/transfer/{externalId}/state.

16.08.2022

Обновили сертификат TLS на стороне SberBusinessAPI.

Чтобы обеспечить взаимодействие со SberBusinessAPI после обновления сертификата, нужно убедиться, что установлены все актуальные цепочки промышленных TLS-сертификатов, опубликованные в разделе Получение TLS (последнее обновление 26.04.2022).

Июль

26.07.2022

• Обновили модель и пример запроса POST /v1/credit-requests.

• Исправили назначения статусов: EXPORTED (был Окончательным, стал Промежуточным) и INVALIDEDS (был Промежуточным, стал Окончательным) для GET /v1/business-cards/transfer/{externalId}/state.

• Добавили новые параметры: acceptLastDate (дата окончания периода действия заранее данного акцепта) и acceptStartDate (дата начала периода действия заранее данного акцепта) в модель ответа GET /v1/partner-info/advance-acceptances.

19.07.2022

• Исправили пример запроса GET /v1/credit-offers.

05.07.2022

• Добавили правило заполнения поля purpose (Назначение платежа) для POST /v1/payment-requests/outgoing.

• Исправили пример ответа GET /v1/generic-letters/from-bank.

Июнь

03.06.2022

• Обновили архив файлов виджета в разделе Настройка кредитной линии.

• Добавили окончательный неуспешный статус CHECKERROR в разделы: Валютный контракт в Банк, Валютный кредитный договор, Заявление о снятии с учета/переуступке контракта (кредитного договора).

• Добавили обязательность заполнения полей: creditAmount, creditProductCode, creditTerm, negativeOrderUrl и блока PayeeInfo для ресурса Создание заявки на кредитный договор.

• Переименовали раздел Переводы между картами в Создание и отправка в Банк B2B/B2P-перевода с бизнес-карты.

• Переименовали раздел Сервис Кредит в Корзине в Сервис Рассрочка для Бизнеса.

Май

19.05.2022

Добавили Зачисления в другие банки в раздел Прямая интеграция.

Апрель

26.04.2022

• Обновили цепочку промышленных TLS-сертификатов в разделе Получение TLS.

• Обновили архив файлов виджета в разделе Настройка кредитной линии.

• Заменили типы DealPassCred138I, DealPassCon138I на InternalControlStatement и CurrDeallnq_138I на CurrControlInfoReq в таблице Типы документов (subType) в разделе Большие файлы.

• Исправили пример запроса POST /v1/contract-close-applications.

• Добавили промежуточный статус TRIED_BY_CFE для GET /v1/bank-control-statements/change-applications/{externalId}/state.

• Исправили назначение статуса Картотека №2 (CARD2) для платежных документов. Картотека №2 (CARD2) - промежуточный статус.

05.04.2022

• Добавили необязательное поле bic (БИК банка сотрудника) в модели запроса и ответа POST /v1/payrolls, GET /v1/payrolls/{externalId}.

• Добавили Переводы между картами в раздел Бизнес-карты.

• Добавили новый ресурс Получение ленты объявлений в раздел Интеграция для партнеров.

04.04.2022

Отметили обязательность поля number (Номер документа) в ресурсе POST /v1/card-issues.

Март

30.03.2022

• Исправили модели и примеры запроса-ответа GET /v1/files/upload/{fileId}/state в разделах Реестр задолженности, Большие файлы.

• Добавили поле bankDate в модели запроса и ответа POST /v1/bank-control-statements/reg-curr-cred-contracts.

• Добавили поля xmlBodies и bankDate в модель ответа GET /v1/bank-control-statements/reg-curr-contracts/{externalId}.

24.03.2022

Добавили новый раздел FAQ с ответами на часто задаваемые вопросы.

23.03.2022

• Убрали поле numberAbsent из модели запроса POST /v1/currency-operation-details.

• Убрали поле bankCorrAccount из модели запроса POST /v1/orders-mandatory-sale.

22.03.2022

• Перенесли Подключение личного кабинета и Работа с личным кабинетом в раздел Личный кабинет.

• Перенесли в отдельный раздел Получение TLS-сертификата.

• Обновили раздел Приступая к работе.

21.03.2022

• Добавилась новая ошибка при создании валютных платежей - "bankStatus":"CHECKERROR", "bankComment":"Осуществление платежей в указанной валюте на данный момент невозможно". Это связано с тем, что в связи с санкционными ограничениями на валютные операции с корреспондентскими счетами в американских банках в Сбербизнес нельзя совершить перевод в другой банк в долларах США, фунтах стерлингов, датских и шведских кронах, канадских долларах.

• Добавили условия доступности покупки в кредит в разделе Методы Кредит в Корзине.

11.03.2022

Обновили файл по ссылке КриптоПРО в разделе Криптографические ресурсы.

10.03.2022

Обновили кейсы для тестирования Кредит в Корзине.

01.03.2022

Обновили цепочки тестовых и промышленных TLS-сертификатов в разделе Приступая к работе.

Февраль

21.02.2022

Дополнили статусы обработки исходящего платежного требования.

Январь

27.01.2022

Исправили наименование сервиса, которое необходимо передать в scope для доступа к ресурсам Заявление о внесении изменений.

26.01.2022

Добавили правила заполнения полей сумма заказа (amount) и запрошенная сумма кредита (creditAmount) для ресурса Создание заявки на кредитный договор.

25.01.2022

Обновили файл по ссылке КриптоПРО в разделе Криптографические ресурсы.

Декабрь

28.12.2021

• Исправили модель и пример запроса для ресурса Создание исходящих платежных требований.

• Добавили важное примечание к описанию ресурса GET /v1/partner-info/advance-acceptances в Подписках и в Сервисе гарантированных расчетов /ru/sber-api/sberpayments/cash-hold.

22.12.2021

Обновили и перенесли в отдельный раздел документацию по Сервису авторизации СберБизнес ID.