Интеграция со СБИС

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

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

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

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

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

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

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

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

Комментарий

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

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

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

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

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

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

{
  "jsonrpc": "2.0",
  "method": "СБИС.СписокСертификатов",
  "params": {
    "Фильтр": {}
  },
  "id": 0
}

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

{
  "jsonrpc": "2.0",
  "method": "СБИС.СписокСертификатов",
  "params": {
    "Фильтр": {
      "Сертификат": {
        "ИНН": "1111654353"
      }
    }
  },
  "id": 0
}

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

{
  "jsonrpc": "2.0",
  "result": {
    "Сертификат": [
      {
        "ДвоичныеДанные": "",
        "ДействителенПо": "13.04.2018 11.10.00",
        "ДействителенС": "13.04.2015 11.00.00",
        "Должность": "Тестовая",
        "ИНН": "1111654353",
        "КодСтраны": "RU",
        "Издатель": "CA-SBIS-TEST",
        "Квалифицированный": "Нет",
        "Ключ": {
          "Активирован": "Да",
          "СпособАктивации": "Активирован",
          "Тип": "Серверный"
        },
        "Название": "Тестовый Отправитель",
        "Отпечаток": "369C84029CE42EB9E469D8585813DB05AFE21A7B",
        "СерийныйНомер": "7F6D3179000100000597",
        "ФИО": "Иванов Иван Иванович"
      }
    ]
  },
  "id": 0
}