Программный интерфейс допускает создание черновика документа в личном кабинете контрагента при переходе по специально подготовленной ссылке.
Внимание!
Запуск в документооборот созданного черновика осуществляется только в личном кабинете контрагента.
Алгоритм создания ссылки
- Подготавливается JSON-структура с командой "ЗаписатьДокумент"(в формате команды СБИС.ЗаписатьДокумент), где в поле "Параметр" указываются необходимые параметры документа.
{ "Команда": "ЗаписатьДокумент", "Параметр": {} }
- Полученная JSON-структура кодируется в Base64 и формат URLencode.
- Формируется итоговая ссылка: https://online.sbis.ru/opendoc.html?exec= + структура полученная на шаге 2.
При переходе по ссылке сначала производится аутентификация в личном кабинете контрагента (по логину/паролю или сертификату), затем в случае успешного выполнения отображается карточка созданного черновика, в противном случае отображается сообщение об ошибке.
Ссылку для создания черновика рекомендуется помещать в формах обратной связи для контрагента в его личном кабинете на сайте эмитента.
Пример создания черновика
Документа с типом "корреспонденция исходящая", примечанием "Благодарность за помощь в получении скидки на товар" в адрес эмитента с ИНН 1111111131, КПП 000000000 от контрагента с ИНН 1111111283 и КПП 000000000 и вложением текстового документа "data.txt":
- Формируем параметры запроса (в формате команды СБИС.ЗаписатьДокумент):
{ "Команда": "ЗаписатьДокумент", "Параметр": { "Документ": { "Вложение": [{ "Файл": { "ДвоичныеДанные": "z/Du8fLuIO7j8O7s7eD/IOHr4OPu5ODw7e7x8vw=", "Имя": "data.txt" } }], "Контрагент": { "СвЮЛ": { "ИНН": "1111111283", "КПП": "000000000" } }, "НашаОрганизация": { "СвЮЛ": { "ИНН": "1111111131", "КПП": "000000000" } }, "Тип": "КоррИсх", "Примечание": "Благодарность за помощь в получении скидки на товар" } } }
- Кодируем в 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