Команда СБИС.СписокСертификатов возвращает список действительных неквалифицированных серверных сертификатов. В зависимости от настроек фильтрации возвращаются собственные или делегированные сертификаты.
Адрес для выполнения запроса: https://online.sbis.ru/service/?srv=1
Параметры строки запроса
- "Фильтр": объект:
- "Сертификат": объект, необязательный:
- "ФИО": строка, подписант
- "Должность": строка
- "ИНН": строка, значение соответствует
- "КодСтраны": строка, код страны в стандарте ISO 3166-1 alpha-2
- "Название": строка, название организации
- "Отпечаток": строка, отпечаток
- "СерийныйНомер": строка, серийный номер
- "Квалифицированный": строка "Да"/"Нет"
- "Ключ": объект:
- "Тип": строка, описание и возможные значения
- "Сертификат": объект, необязательный:
Результат запроса
- "Сертификат": массив объектов:
- "ФИО": строка
- "Должность": строка
- "ИНН": строка, значение соответствует
- "КодСтраны": строка, код страны в стандарте ISO 3166-1 alpha-2
- "Название": строка
- "Отпечаток": строка
- "СерийныйНомер": строка, серийный номер
- "Квалифицированный": строка "Да"/"Нет"
- "ДействителенС": строка в формате "ДД.ММ.ГГГГ ЧЧ.ММ.СС"
- "ДействителенПо": строка в формате "ДД.ММ.ГГГГ ЧЧ.ММ.СС"
- "Ключ": объект:
- "Активирован": строка "Да"/"Нет"
- "СпособАктивации": строка, описание и возможные значения см. в разделе "Работа с контрагентами"
- "Тип": строка, описание и возможные значения
Комментарий
В результате вызова СБИС.СписокСертификатов сертификатов (собственных и делегированных), доступных текущему пользователю, применяется фильтр с параметрами, указанными в запросе.
Если в фильтре указано «ФИО»:
- текущего пользователя — вернется список сертификатов, выданных этому пользователю. Список делегированных сертификатов не попадет в выдачу.
- другого сотрудника (доверителя) — вернется список сертификатов, делегированных текущему пользователю сотрудником, ФИО которого указано в запросе.
Чтобы получить полный список доступных пользователю сертификатов для подписания, указывать ФИО сотрудника не нужно. Достаточно отправить запрос без указания фильтра.
Аналогично работает фильтр с параметром «Должность». Однако если в списке доступных сертификатов есть ЭП, выданная сотруднику с должностью «Исполнительный директор», а в фильтре в поле «Должность» указано значение «Директор», то в результатах запроса будет возвращен пустой список.
Настройки прав доступа
Для выполнения команды СБИС.СписокСертификатов у пользователя внешнего API-интерфейса в кабинете СБИС должны быть права на работу с документами (уровень доступа «Просмотр», «Полный» или «Администрирование»).