Присоединяйтесь!

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

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

Команда «СБИС.ПодготовитьДействие» подготавливает документ к переходу на следующий этап документооборота.

В формализованных документах метод:

  • указывает идентификаторы участников документооборота;
  • заполняет теги <Отправитель>, <Получатель>, <Подписант>;
  • формирует имя файла по формату.

Также «СБИС.ПодготовитьДействие» формирует извещения о получении и ответные документы, если этого требует регламент документооборота.

Адрес запроса: https://online.sbis.ru/service/?srv=1

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

  • "Документ": объект:
    • "Идентификатор"*: строка
    • "Редакция": объект:
      • "Идентификатор"*: строка
    • "Этап"*: объект:
      • "Название"**: строка, обязательна при обработке служебного этапа
      • "Идентификатор"**: строка. Может быть пустой для действия «Отправить» этапа «Отправка»
      • "Действие"*: объект:
    • "Вложение": массив объектов (вложений документа для раздельной обработки):
      • "Идентификатор": строка, идентификатор вложения
    • "ДопПоля": строка, дополнительные параметры метода

Результат

Команда возвращает массив объектов со структурой:

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

** — условно-обязательный параметр.

* — параметр для определения реквизитов при подписании, генерации и модификации документов.

Синий — только для чтения.

Комментарий

Алгоритм расчета криптографического хеша для подписываемых файлов определяется по данным сертификата, который зарегистрирован в личном кабинете. Чтобы определить сертификат, передайте поле «Отпечаток» в «Документ.Этап.Действие.Сертификат». Если «Отпечаток» отсутствует, хеш рассчитывается по ГОСТ Р 34.10-2012.

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

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

Cертификат будет выбран автоматически, если:

  • в запросе не переданы реквизиты подписанта;
  • в СБИС доступен один или несколько серверных неквалифицированных сертификатов;
  • регламент документооборота позволяет подписание неквалифицированными ключами.

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

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

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

Поля «Документ.Идентификатор» или «Документ.Редакция.Идентификатор» обязательно должны быть заполнены. Если заполнено поле:

  • «Документ.Идентификатор» — обрабатывается этап и действия последней редакции;
  • «Документ.Редакция.Идентификатор» — этап и действия конкретной редакции.

Чтобы обработать отдельные файлы, в объект «Документ» необходимо:

  • передать в поле «ДопПоля» значение «СложноеУтверждение»;
  • добавить идентификаторы обрабатываемых файлов в список «Вложение» (если они в этом списке отсутствуют).

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

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

Пример раздельной обработки файлов

Нашли неточность? Выделите текст с ошибкой и нажмите ctrl + enter.