СБИС.СписокСертификатов

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

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

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

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

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

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

Комментарий

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

Если в фильтре указано "ФИО":

• текущего пользователя — будет возвращен список сертификатов, выданных текущему пользователю (список делегированных сертификатов не попадет в выдачу).
• другого сотрудника (доверителя) — будет возвращен список сертификатов делегированных текущему пользователю от сотрудника, чье ФИО было указано в запросе.

Чтобы получить полный список доступных пользователю сертификатов для подписания, указывать ФИО сотрудника не нужно. Достаточно отправить запрос без указания фильтра.

Аналогично работает фильтр с параметром "Должность". Однако, если в списке доступных сертификатов есть ЭП, выданная сотруднику с должностью "Исполнительный директор", а в фильтре в поле "Должность" указано значение "Директор", то в результатах запроса будет возвращен пустой список.

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

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

​Пример запроса (без фильтра)

Пример запроса (с фильтром)

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