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

Обновлено 20 сентября 2023

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

Июль

13.07.2023

Обратите внимание: для сохранения доступа к тестированию сервисов канала SberBusinessAPI необходимо перейти на новый тестовый контур ИФТ. При переходе на новый тестовый контур с вашей стороны доработок учетной системы не потребуется. TLS сертификат останется прежним. В ближайшее время текущий тестовый контур EDUPIR будет недоступен.

Июнь

20.06.2023

C 02.07.2023 по 01.10.2023 всем Партнерам при В2В интеграции (когда файл с выпиской запрашивается по счетам Клиентов) необходимо сделать доработки на своей стороне: при получении ссылки на скачивание файла с выпиской по методу GET /v1/files/tasks-for-download скачивать файл под своим TLS-сертификатом в свое хранилище и передавать ссылку Клиенту на свое хранилище, в котором уже не будет проверки TLS-сертификата.

• Добавили новый раздел Тарификация с информацией о тарифах.

Апрель

25.04.2023

Добавьте сертификаты НУЦ Минцифры для работы по СберБизнесID

Обратите внимание: для сохранения доступа к сервису СберБизнесID от Сбера в срок до 11.05.2023 вам необходимо произвести настройки и добавить доверенные сертификаты НУЦ Минцифры в настройки системы. Подробности по ссылке https://www.sberbank.ru/ru/certificates.

Если не выполнить эту настройку, интеграция со СберБизнесID станет недоступна.

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

С 03.04.2023 добавляем новые методы по получению выписки v2/, которые заменят аналогичные методы v1/:

• /v2/statement/transactions
• /v2/statement/transactionId
• /v2/statement/transactionId/print
• /v2/statement/summary

Что изменится:

1. При запросе выписки по счету Клиент будет использовать новый метод /v2/statement/transactions:

• на входе будет указывать Дату + Счет;
• на выходе получать Выписку с операциями, где у каждой операции будет стоять идентификатор (operationId). Важно, данный operationId – это уникальный ID операции, по нему Клиент сможет запросить реквизиты операции в форматах json либо печатной форме.

2. При запросе реквизитов операции по выписке Клиент будет использовать новые методы /v2/statement/transactionId и /v2/statement/transactionId/print:

• на входе будет указывать Дату + Счет + operationId + формат печатной формы (при необходимости);
• на выходе будет получать реквизиты операции по выписке в форматах json либо печатной форме.

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

C 18.03.2023 изменятся наименования статусов рублевого платежного поручения (метод GET /v1/ payments/{externalId}/state):

Код состояние документа	Наименование статуса было	Наименование статуса стало
ACCEPTED_BY_ABS	Принят АБС	Принят
CARD2	Картотека 2	Ожидает оплаты
INVALIDEDS	ЭП/АСП не верна	Подпись неверна
REFUSEDBYBANK	Отвергнут банком	Отклонен банком

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.

В соответствии с Приказом Минфина России №107Н, если плательщик является ИП, то payerKpp необходимо заполнять значением "0".

03.10.2022

Обновили архив SberBusinessID.framework в разделе SDK для iOS.

Сентябрь

15.09.2022

• Исправили пример запроса GET /v1/corporate-cards/{corpCardId}/transactions.

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

Август

31.08.2022

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

  Предыдущий TLS-сертификат действует до 04.09.2022.

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

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

• Исправили назначение статуса 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

• Исправили конечный успешный статус PROCESSED на IMPLEMENTED для GET /v1/corporate-card-request/{externalId}/state.

• Исправили пример запроса 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/sberbusinessapi/sberpayments/cash-hold#poluchenie-svedeniy-o-klientah2.

22.12.2021

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