СОЗДАНИЕ ЧЕРНОВИКА ДОКУМЕНТА ПО ССЫЛКЕ (API)

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

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

Внимание!

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

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

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

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

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

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

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

  1. Формируем параметры запроса (в формате команды СБИС.ЗаписатьДокумент):
{
  "Команда": "ЗаписатьДокумент",
  "Параметр": {
    "Документ": {
      "Вложение": [{
        "Файл": {
          "ДвоичныеДанные": "z/Du8fLuIO7j8O7s7eD/IOHr4OPu5ODw7e7x8vw=",
          "Имя": "data.txt"
              }
          }],
           "Контрагент": {
               "СвЮЛ": {
                   "ИНН": "1111111283",
                   "КПП": "000000000"
                }
          },
          "НашаОрганизация": {
               "СвЮЛ": {
                   "ИНН": "1111111131",
                   "КПП": "000000000"
               }
          },
          "Тип": "КоррИсх",
          "Примечание": "Благодарность за помощь в получении скидки на товар"
      }
   }
}
  1. Кодируем в base64:
ew0KICAgICLQmtC+0LzQsNC90LTQsCI6ICLQl9Cw0L/QuNGB0LDRgtGM0JTQvtC60YPQvNC10L3RgiIsDQogICAgItCf0LDRgN
Cw0LzQtdGC0YAiOiB7DQogICAgICAgICLQlNC+0LrRg9C80LXQvdGCIjogew0KICAgICAgICAgICAgItCS0LvQvtC20LXQvdC4
0LUiOiBbew0KICAgICAgICAgICAgICAgICLQpNCw0LnQuyI6IHsNCiAgICAgICAgICAgICAgICAgICAgItCU0LLQvtC40YfQvd
GL0LXQlNCw0L3QvdGL0LUiOiAiei9EdThmTHVJTzdqOE83czdlRC9JT0hyNE9QdTVPRHc3ZTd4OHZ3PSIsDQogICAgICAgICAg
ICAgICAgICAgICLQmNC80Y8iOiAiZGF0YS50eHQiDQogICAgICAgICAgICAgICAgfQ0KICAgICAgICAgICAgfV0sDQogICAgIC
AgICAgICAi0JrQvtC90YLRgNCw0LPQtdC90YIiOiB7DQogICAgICAgICAgICAgICAgItCh0LLQrtCbIjogew0KICAgICAgICAg
ICAgICAgICAgICAi0JjQndCdIjogIjExMTExMTEyODMiLA0KICAgICAgICAgICAgICAgICAgICAi0JrQn9CfIjogIjAwMDAwMD
AwMCINCiAgICAgICAgICAgICAgICB9DQogICAgICAgICAgICB9LA0KICAgICAgICAgICAgItCd0LDRiNCw0J7RgNCz0LDQvdC4
0LfQsNGG0LjRjyI6IHsNCiAgICAgICAgICAgICAgICAi0KHQstCu0JsiOiB7DQogICAgICAgICAgICAgICAgICAgICLQmNCd0J
0iOiAiMTExMTExMTEzMSIsDQogICAgICAgICAgICAgICAgICAgICLQmtCf0J8iOiAiMDAwMDAwMDAwIg0KICAgICAgICAgICAg
ICAgIH0NCiAgICAgICAgICAgIH0sDQogICAgICAgICAgICAi0KLQuNC/IjogItCa0L7RgNGA0JjRgdGFIiwNCiAgICAgICAgIC
AgICLQn9GA0LjQvNC10YfQsNC90LjQtSI6ICLQkdC70LDQs9C+0LTQsNGA0L3QvtGB0YLRjCDQt9CwINC/0L7QvNC+0YnRjCDQ
siDQv9C+0LvRg9GH0LXQvdC40Lgg0YHQutC40LTQutC4INC90LAg0YLQvtCy0LDRgCINCiAgICAgICAgfQ0KICAgIH0NCn0NCg==
  1. Делаем URLencode:
ew0KICAgICLQmtC%2B0LzQsNC90LTQsCI6ICLQl9Cw0L%2FQuNGB0LDRgtGM0JTQvtC60YPQvNC10L3RgiIsDQogICAgItCf0L
DRgNCw0LzQtdGC0YAiOiB7DQogICAgICAgICLQlNC%2B0LrRg9C80LXQvdGCIjogew0KICAgICAgICAgICAgItCS0LvQvtC20L
XQvdC40LUiOiBbew0KICAgICAgICAgICAgICAgICLQpNCw0LnQuyI6IHsNCiAgICAgICAgICAgICAgICAgICAgItCU0LLQvtC4
0YfQvdGL0LXQlNCw0L3QvdGL0LUiOiAiei9EdThmTHVJTzdqOE83czdlRC9JT0hyNE9QdTVPRHc3ZTd4OHZ3PSIsDQogICAgIC
AgICAgICAgICAgICAgICLQmNC80Y8iOiAiZGF0YS50eHQiDQogICAgICAgICAgICAgICAgfQ0KICAgICAgICAgICAgfV0sDQog
ICAgICAgICAgICAi0JrQvtC90YLRgNCw0LPQtdC90YIiOiB7DQogICAgICAgICAgICAgICAgItCh0LLQrtCbIjogew0KICAgIC
AgICAgICAgICAgICAgICAi0JjQndCdIjogIjExMTExMTEyODMiLA0KICAgICAgICAgICAgICAgICAgICAi0JrQn9CfIjogIjAw
MDAwMDAwMCINCiAgICAgICAgICAgICAgICB9DQogICAgICAgICAgICB9LA0KICAgICAgICAgICAgItCd0LDRiNCw0J7RgNCz0L
DQvdC40LfQsNGG0LjRjyI6IHsNCiAgICAgICAgICAgICAgICAi0KHQstCu0JsiOiB7DQogICAgICAgICAgICAgICAgICAgICLQ
mNCd0J0iOiAiMTExMTExMTEzMSIsDQogICAgICAgICAgICAgICAgICAgICLQmtCf0J8iOiAiMDAwMDAwMDAwIg0KICAgICAgIC
AgICAgICAgIH0NCiAgICAgICAgICAgIH0sDQogICAgICAgICAgICAi0KLQuNC%2FIjogItCa0L7RgNGA0JjRgdGFIiwNCiAgIC
AgICAgICAgICLQn9GA0LjQvNC10YfQsNC90LjQtSI6ICLQkdC70LDQs9C%2B0LTQsNGA0L3QvtGB0YLRjCDQt9CwINC%2F0L7Q
vNC%2B0YnRjCDQsiDQv9C%2B0LvRg9GH0LXQvdC40Lgg0YHQutC40LTQutC4INC90LAg0YLQvtCy0LDRgCINCiAgICAgICAgfQ
0KICAgIH0NCn0NCg%3D%3D
  1. Формируем итоговую ссылку:
https://online.sbis.ru/opendoc.html?exec=ew0KICAgICLQmtC%2B0LzQsNC90LTQsCI6ICLQl9Cw0L%2FQuNGB0LDRg
tGM0JTQvtC60YPQvNC10L3RgiIsDQogICAgItCf0LDRgNCw0LzQtdGC0YAiOiB7DQogICAgICAgICLQlNC%2B0LrRg9C80LXQv
dGCIjogew0KICAgICAgICAgICAgItCS0LvQvtC20LXQvdC40LUiOiBbew0KICAgICAgICAgICAgICAgICLQpNCw0LnQuyI6IHs
NCiAgICAgICAgICAgICAgICAgICAgItCU0LLQvtC40YfQvdGL0LXQlNCw0L3QvdGL0LUiOiAiei9EdThmTHVJTzdqOE83czdlR
C9JT0hyNE9QdTVPRHc3ZTd4OHZ3PSIsDQogICAgICAgICAgICAgICAgICAgICLQmNC80Y8iOiAiZGF0YS50eHQiDQogICAgICA
gICAgICAgICAgfQ0KICAgICAgICAgICAgfV0sDQogICAgICAgICAgICAi0JrQvtC90YLRgNCw0LPQtdC90YIiOiB7DQogICAgI
CAgICAgICAgICAgItCh0LLQrtCbIjogew0KICAgICAgICAgICAgICAgICAgICAi0JjQndCdIjogIjExMTExMTEyODMiLA0KICA
gICAgICAgICAgICAgICAgICAi0JrQn9CfIjogIjAwMDAwMDAwMCINCiAgICAgICAgICAgICAgICB9DQogICAgICAgICAgICB9L
A0KICAgICAgICAgICAgItCd0LDRiNCw0J7RgNCz0LDQvdC40LfQsNGG0LjRjyI6IHsNCiAgICAgICAgICAgICAgICAi0KHQstC
u0JsiOiB7DQogICAgICAgICAgICAgICAgICAgICLQmNCd0J0iOiAiMTExMTExMTEzMSIsDQogICAgICAgICAgICAgICAgICAgI
CLQmtCf0J8iOiAiMDAwMDAwMDAwIg0KICAgICAgICAgICAgICAgIH0NCiAgICAgICAgICAgIH0sDQogICAgICAgICAgICAi0KL
QuNC%2FIjogItCa0L7RgNGA0JjRgdGFIiwNCiAgICAgICAgICAgICLQn9GA0LjQvNC10YfQsNC90LjQtSI6ICLQkdC70LDQs9C
%2B0LTQsNGA0L3QvtGB0YLRjCDQt9CwINC%2F0L7QvNC%2B0YnRjCDQsiDQv9C%2B0LvRg9GH0LXQvdC40Lgg0YHQutC40LTQu
tC4INC90LAg0YLQvtCy0LDRgCINCiAgICAgICAgfQ0KICAgIH0NCn0NCg%3D%3D
1
0
Оставьте свой отзыв:
ОТПРАВИТЬ