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