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

СБИС.ИнформацияОСлужебныхЭтапах

СБИС.ИнформацияОСлужебныхЭтапах

Команда СБИС.ИнформацияОСлужебныхЭтапах возвращает список «наших организаций», по которым есть необработанные служебные этапы.

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

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

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

  • "НашаОрганизация": массив объектов (может отсутствовать)
  • "ПрекратитьЗапросы": строка "Да"/"Нет"
  • "ЧислоНеобработанныхЭтапов": строка, которая содержит число необработанных на момент запроса служебных документов для текущего пользователя

Комментарий

  • Рекомендуется передавать «Да» в «Фильтр.ТолькоНаличиеСобытий», так как это существенно снижает нагрузку на сайт online.sbis.ru и минимизирует время выполнения метода.
  • Если метод вернул пустой список организаций или не вернул его совсем, следует на 1-5 минут приостановить запросы.
  • Значение «ЧислоНеобработанныхЭтапов» является ориентировочным. Метод «СБИС.ИнформацияОСлужебныхЭтапах» может вернуть положительное значение, а последующий метод, «СБИС.СписокСлужебныхЭтапов» — пустой список. Если передать «Да» в «Фильтр.ТолькоНаличиеСобытий», отобразится количество организаций, по которым есть необработанные служебные документы.
  • Значение «Да» в поле «ПрекратитьЗапросы» означает, что:
    • следует прекратить вызовы для текущего пользователя, так как у него недостаточно прав для подписания служебных документов;
    • пользователь не входит в число сотрудников, назначенных для обработки служебных событий на «наших организациях».

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

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

Если у пользователя настроены права только на «Просмотр», то в результате вызова метода «СБИС.ИнформацияОСлужебныхЭтапах» будет возвращено пустое значение, даже при наличии необрабортанных служебных этапов.

Внимание!

Результат запроса существенно зависит от заполнения полей «НашаОрганизация.СвЮЛ.КодФилиала».

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

Запрос списка «наших организаций», у которых необходимо выполнить обработку служебных этапов.

Запрос наличия событий по конкретной «нашей организации» без подсчета числа событий.

Примеры ответов

Ответ с информацией о двух организациях, по которым требуется подписание служебных документов.

Ответ с информацией об отсутствии необработанных служебных этапов.

Ответ с информацией об отсутствии необработанных служебных этапов из-за невозможности пользователем обрабатывать служебные документы.