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

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

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

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

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

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

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

Комментарий

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

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

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

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

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

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

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

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

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

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