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

СБИС.ПодготовитьДействие

СБИС.ПодготовитьДействие

Команда СБИС.ПодготовитьДействие подготавливает документ к выполнению перехода на следующий этап документооборота: в формализованных документах заполняет идентификаторы участников документооборота и теги <Отправитель>, <Получатель>, <Подписант>, формирует правильное (по формату) имя файла, если требуется, генерирует извещения о получении и ответные документы.

Адрес для выполнения запроса: https://online.sbis.ru/service/?srv=1

Параметры запроса

  • "Документ": объект:
    • "Идентификатор"*: строка
    • Редакция": объект
      • "Идентификатор"*: строка
    • "Этап"*: объект:
      • "Название"*: строка, обязательна при обработке служебного этапа
      • "Идентификатор"*: строка, обязательна для всех этапов. Может быть пустым для действия "Отправить" этапа "Отправка"
      • "Действие"*: объект
        • "Название"*: строка, список допустимых значений
        • "Комментарий"*: строка, обязательна не для всех действий
        • "Сертификат": объект
          • "ФИО"*: строка
          • "Должность"*: строка
          • "ИНН"*: строка
          • "Название": строка
          • "Отпечаток": строка

Результат запроса

Синие — параметры, возвращаемые с сервера (поля, доступные только для чтения).

  • "Документ": объект:
    • "Идентификатор": строка
    • "Направление": строка
    • "НашаОрганизация": объект
      • ...
    • "Контрагент": объект
      • ...
    • "Подразделение": объект
      • ...
    • "Ответственный": объект
      • ...
  • "Этап": массив объектов
    • "Название": строка
    • "Идентификатор": строка
    • "Служебный": строка "Да"/"Нет"
    • "Действие": массив объектов
      • "Название": строка
      • "ТребуетПодписания": строка "Да"/"Нет
      • "ТребуетКомментария": строка "Да"/"Нет
      • "Сертификат": массив объектов
        • "ФИО": строка
        • "Должность": строка
        • "ИНН": строка
        • "ОГРНИП": строка.
        • "Название": строка
        • "Отпечаток": строка
        • "Квалифицированный": строка "Да"/"Нет
        • "ДействителенС": дата и время
        • "ДействителенПо": дата и время
        • "Ключ": объект
          • "Активирован": строка "Да"/"Нет"
          • "СпособАктивации": строка
          • "Тип": строка
    • "Вложение": массив объектов
      • "Название": строка
      • "Идентификатор": строка
      • "Модифицирован": строка
      • "Файл": объект
  • "Имя": строка
  • "Ссылка": строка

* — обязательные параметры

Внимание!

В результатах вызова метода СБИС.ПодготовитьДействие поле с криптографическим хешем (Вложение.Файл.Хеш) возвращается только для тех вложений, которые изменены или требуют подписания.

Комментарий

Не рекомендуется использовать названия этапов, так как данный способ не надежен и допускает подготовку к этапу неверной редакции (при адресации по идентификатору документа на момент вызова метода может появиться новая редакция документа) или одноименного этапа (если одноименные этапы были переназначены текущему или другому пользователю).

Вызов функции СБИС.ПодготовитьДействие ведёт к генерации (перегенерации) служебных документов и/или ответных титулов. Вложения, изменённые или сгенерированные в результате вызова метода, имеют атрибут Документ.Вложение.Модифицирован="Да". Прочие методы модификацию не производят и возвращают Модифицирован="Нет".

Если на вход функции СБИС.ПодготовитьДействие не передавались реквизиты подписанта и при этом есть один/несколько доступных серверных сертификатов, то сертификат будет выбран автоматически. Под реквизиты выбранного сертификата будут сгенерированы служебные вложения и/или внесены изменения в первичные документы. Реквизиты сертификата будут возвращены в Документ.Этап.Сертификат, которые необходимо передать в команде СБИС.ВыполнитьДействие.

Если у подписанта фамилия, имя и/или отчество состоит из нескольких раздельных слов, следует «соединить» их с помощью символа «_» (нижнее подчеркивание) и передать в поле "Сертификат.ФИО". При дальнейшем использовании символы подчеркивания будут заменены на пробелы.

Заполнение полей Документ.Идентификатор или Документ.Редакция.Идентификатор является обязательным. При заполнении поля Документ.Идентификатор обрабатывается этап и действия последней редакции. В случае, если заполнено поле Документ.Редакция.Идентификатор обрабатывается этап и действия конкретной редакции.

Рекомендуется передавать идентификатор этапа и идентификатор редакции.

Настройки прав доступа

Для выполнение команды СБИС.ПодготовитьДействие у пользователя внешнего API-интерфейса в кабинете СБИС должны быть настроены права на изменение документов (уровень доступа «Полный» или «Администрирование»).

Пример запроса

Пример ответа (успех)