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

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

Внимание!

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

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

Подготовьте JSON-структуру с командой «ЗаписатьДокумент». В поле «Параметр» нужно указать необходимые параметры для документа.
{ "Команда": "ЗаписатьДокумент", "Параметр": {} }
Полученную JSON-структуру перекодируйте в Base64 и формат URLencode.
Сформируйте итоговую ссылку: https://online.sbis.ru/opendoc.html?exec= + структура, которая получена на предыдущем шаге.

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

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

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

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

Формируются параметры запроса в формате команды «СБИС.ЗаписатьДокумент»):

{
  "Команда": "ЗаписатьДокумент",
  "Параметр": {
    "Документ": {
      "Вложение": [{
        "Файл": {
          "ДвоичныеДанные": "z/Du8fLuIO7j8O7s7eD/IOHr4OPu5ODw7e7x8vw=",
          "Имя": "data.txt"
              }
          }],
           "Контрагент": {
               "СвЮЛ": {
                   "ИНН": "1111111283",
                   "КПП": "000000000"
                }
          },
          "НашаОрганизация": {
               "СвЮЛ": {
                   "ИНН": "1111111131",
                   "КПП": "000000000"
               }
          },
          "Тип": "КоррИсх",
          "Примечание": "Благодарность за помощь в получении скидки на товар"
      }
   }
}

Скачать пример

JSON-структура кодируется в Base64:

ew0KICAgICLQmtC+0LzQsNC90LTQsCI6ICLQl9Cw0L/QuNGB0LDRgtGM0JTQvtC60YPQvNC10L3RgiIsDQogICAgItCf0LDRgNCw0LzQtdGC0YAiOiB7DQogICAgICAgICLQlNC+0LrRg9C80LXQvdGCIjogew0KICAgICAgICAgICAgItCS0LvQvtC20LXQvdC40LUiOiBbew0KICAgICAgICAgICAgICAgICLQpNCw0LnQuyI6IHsNCiAgICAgICAgICAgICAgICAgICAgItCU0LLQvtC40YfQvdGL0LXQlNCw0L3QvdGL0LUiOiAiei9EdThmTHVJTzdqOE83czdlRC9JT0hyNE9QdTVPRHc3ZTd4OHZ3PSIsDQogICAgICAgICAgICAgICAgICAgICLQmNC80Y8iOiAiZGF0YS50eHQiDQogICAgICAgICAgICAgICAgfQ0KICAgICAgICAgICAgfV0sDQogICAgICAgICAgICAi0JrQvtC90YLRgNCw0LPQtdC90YIiOiB7DQogICAgICAgICAgICAgICAgItCh0LLQrtCbIjogew0KICAgICAgICAgICAgICAgICAgICAi0JjQndCdIjogIjExMTExMTEyODMiLA0KICAgICAgICAgICAgICAgICAgICAi0JrQn9CfIjogIjAwMDAwMDAwMCINCiAgICAgICAgICAgICAgICB9DQogICAgICAgICAgICB9LA0KICAgICAgICAgICAgItCd0LDRiNCw0J7RgNCz0LDQvdC40LfQsNGG0LjRjyI6IHsNCiAgICAgICAgICAgICAgICAi0KHQstCu0JsiOiB7DQogICAgICAgICAgICAgICAgICAgICLQmNCd0J0iOiAiMTExMTExMTEzMSIsDQogICAgICAgICAgICAgICAgICAgICLQmtCf0J8iOiAiMDAwMDAwMDAwIg0KICAgICAgICAgICAgICAgIH0NCiAgICAgICAgICAgIH0sDQogICAgICAgICAgICAi0KLQuNC/IjogItCa0L7RgNGA0JjRgdGFIiwNCiAgICAgICAgICAgICLQn9GA0LjQvNC10YfQsNC90LjQtSI6ICLQkdC70LDQs9C+0LTQsNGA0L3QvtGB0YLRjCDQt9CwINC/0L7QvNC+0YnRjCDQsiDQv9C+0LvRg9GH0LXQvdC40Lgg0YHQutC40LTQutC4INC90LAg0YLQvtCy0LDRgCINCiAgICAgICAgfQ0KICAgIH0NCn0NCg==

Формируется URLencode:

ew0KICAgICLQmtC%2B0LzQsNC90LTQsCI6ICLQl9Cw0L%2FQuNGB0LDRgtGM0JTQvtC60YPQvNC10L3RgiIsDQogICAgItCf0LDRgNCw0LzQtdGC0YAiOiB7DQogICAgICAgICLQlNC%2B0LrRg9C80LXQvdGCIjogew0KICAgICAgICAgICAgItCS0LvQvtC20LXQvdC40LUiOiBbew0KICAgICAgICAgICAgICAgICLQpNCw0LnQuyI6IHsNCiAgICAgICAgICAgICAgICAgICAgItCU0LLQvtC40YfQvdGL0LXQlNCw0L3QvdGL0LUiOiAiei9EdThmTHVJTzdqOE83czdlRC9JT0hyNE9QdTVPRHc3ZTd4OHZ3PSIsDQogICAgICAgICAgICAgICAgICAgICLQmNC80Y8iOiAiZGF0YS50eHQiDQogICAgICAgICAgICAgICAgfQ0KICAgICAgICAgICAgfV0sDQogICAgICAgICAgICAi0JrQvtC90YLRgNCw0LPQtdC90YIiOiB7DQogICAgICAgICAgICAgICAgItCh0LLQrtCbIjogew0KICAgICAgICAgICAgICAgICAgICAi0JjQndCdIjogIjExMTExMTEyODMiLA0KICAgICAgICAgICAgICAgICAgICAi0JrQn9CfIjogIjAwMDAwMDAwMCINCiAgICAgICAgICAgICAgICB9DQogICAgICAgICAgICB9LA0KICAgICAgICAgICAgItCd0LDRiNCw0J7RgNCz0LDQvdC40LfQsNGG0LjRjyI6IHsNCiAgICAgICAgICAgICAgICAi0KHQstCu0JsiOiB7DQogICAgICAgICAgICAgICAgICAgICLQmNCd0J0iOiAiMTExMTExMTEzMSIsDQogICAgICAgICAgICAgICAgICAgICLQmtCf0J8iOiAiMDAwMDAwMDAwIg0KICAgICAgICAgICAgICAgIH0NCiAgICAgICAgICAgIH0sDQogICAgICAgICAgICAi0KLQuNC%2FIjogItCa0L7RgNGA0JjRgdGFIiwNCiAgICAgICAgICAgICLQn9GA0LjQvNC10YfQsNC90LjQtSI6ICLQkdC70LDQs9C%2B0LTQsNGA0L3QvtGB0YLRjCDQt9CwINC%2F0L7QvNC%2B0YnRjCDQsiDQv9C%2B0LvRg9GH0LXQvdC40Lgg0YHQutC40LTQutC4INC90LAg0YLQvtCy0LDRgCINCiAgICAgICAgfQ0KICAgIH0NCn0NCg%3D%3D

Готовится итоговая ссылка:

https://online.sbis.ru/opendoc.html?exec=ew0KICAgICLQmtC%2B0LzQsNC90LTQsCI6ICLQl9Cw0L%2FQuNGB0LDRgtGM0JTQvtC60YPQvNC10L3RgiIsDQogICAgItCf0LDRgNCw0LzQtdGC0YAiOiB7DQogICAgICAgICLQlNC%2B0LrRg9C80LXQvdGCIjogew0KICAgICAgICAgICAgItCS0LvQvtC20LXQvdC40LUiOiBbew0KICAgICAgICAgICAgICAgICLQpNCw0LnQuyI6IHsNCiAgICAgICAgICAgICAgICAgICAgItCU0LLQvtC40YfQvdGL0LXQlNCw0L3QvdGL0LUiOiAiei9EdThmTHVJTzdqOE83czdlRC9JT0hyNE9QdTVPRHc3ZTd4OHZ3PSIsDQogICAgICAgICAgICAgICAgICAgICLQmNC80Y8iOiAiZGF0YS50eHQiDQogICAgICAgICAgICAgICAgfQ0KICAgICAgICAgICAgfV0sDQogICAgICAgICAgICAi0JrQvtC90YLRgNCw0LPQtdC90YIiOiB7DQogICAgICAgICAgICAgICAgItCh0LLQrtCbIjogew0KICAgICAgICAgICAgICAgICAgICAi0JjQndCdIjogIjExMTExMTEyODMiLA0KICAgICAgICAgICAgICAgICAgICAi0JrQn9CfIjogIjAwMDAwMDAwMCINCiAgICAgICAgICAgICAgICB9DQogICAgICAgICAgICB9LA0KICAgICAgICAgICAgItCd0LDRiNCw0J7RgNCz0LDQvdC40LfQsNGG0LjRjyI6IHsNCiAgICAgICAgICAgICAgICAi0KHQstCu0JsiOiB7DQogICAgICAgICAgICAgICAgICAgICLQmNCd0J0iOiAiMTExMTExMTEzMSIsDQogICAgICAgICAgICAgICAgICAgICLQmtCf0J8iOiAiMDAwMDAwMDAwIg0KICAgICAgICAgICAgICAgIH0NCiAgICAgICAgICAgIH0sDQogICAgICAgICAgICAi0KLQuNC%2FIjogItCa0L7RgNGA0JjRgdGFIiwNCiAgICAgICAgICAgICLQn9GA0LjQvNC10YfQsNC90LjQtSI6ICLQkdC70LDQs9C%2B0LTQsNGA0L3QvtGB0YLRjCDQt9CwINC%2F0L7QvNC%2B0YnRjCDQsiDQv9C%2B0LvRg9GH0LXQvdC40Lgg0YHQutC40LTQutC4INC90LAg0YLQvtCy0LDRgCINCiAgICAgICAgfQ0KICAgIH0NCn0NCg%3D%3D