Интеграция с информационной системой

Создание черновика документа по ссылке (API)

Создание черновика документа по ссылке (API)

Программный интерфейс допускает создание черновика документа в личном кабинете контрагента при переходе по специально подготовленной ссылке.

Внимание!

Запуск в документооборот созданного черновика осуществляется только в личном кабинете контрагента.

Алгоритм создания ссылки

  1. Подготавливается JSON-структура с командой "ЗаписатьДокумент"(в формате команды СБИС.ЗаписатьДокумент), где в поле "Параметр" указываются необходимые параметры документа.
  2. Полученная JSON-структура кодируется в Base64 и формат URLencode.
  3. Формируется итоговая ссылка: https://online.sbis.ru/opendoc.html?exec= + структура полученная на шаге 2.

При переходе по ссылке сначала производится аутентификация в личном кабинете контрагента (по логину/паролю или сертификату), затем в случае успешного выполнения отображается карточка созданного черновика, в противном случае отображается сообщение об ошибке.

Ссылку для создания черновика рекомендуется помещать в формах обратной связи для контрагента в его личном кабинете на сайте эмитента.

Пример создания черновика

Документа с типом "корреспонденция исходящая", примечанием "Благодарность за помощь в получении скидки на товар" в адрес эмитента с ИНН 1111111131, КПП 000000000 от контрагента с ИНН 1111111283 и КПП 000000000 и вложением текстового документа "data.txt":

  1. Формируем параметры запроса (в формате команды СБИС.ЗаписатьДокумент):
  2. Кодируем в base64:
  3. Делаем URLencode:
  4. Формируем итоговую ссылку: