Настройки Corteos ЭЦП в формате VK HR Tek
- Михаил Радченко
Помимо подключения базового мода “Электронная подпись для командировочных документов”(регулирует бизнес-процесс и управляет общими настройками процесса электронного подписания) необходимо также подключить мод, отвечающий за способ подписания. В зависимости от способа при его подключении также могут быть добавлены дополнительные настройки.
В этой статье мы рассмотрим подключение мода подписания в формате VK HR Tek:
Электронное подписание через VK HR Tek – в связке с основным модом ЭЦП позволяет применять конкретный вид подписания на документа – внешний сервис КЭДО VK HR Tek
Логика работы с VK HR Tek реализована следующим образом: бизнес-процесс и все действия, необходимые для старта электронного подписания, осуществляются на стороне Corteos, а сам процесс подписания - на стороне внешнего сервиса, в данном случае на стороне VK HR Tek.
Для корректно работы заказчику необходимо заключить договор с VK HR Tek, настроить там процесс подписания и получить набор необходимых для подключения параметров.
Компания Corteos не участвует во взаимоотношениях VK HR Tek и заказчика.
Оглавление:
Подключение мода VK HR Tek, в отличие от ПЭП, добавляет в административный интерфейс дополнительные настройки, которые становятся доступны пользователям клиента с ролью тревел-менеджер в том же разделе, что и общие настройки ЭЦП: Меню – Расширения – ЭЦП: настройки.
В частности, мод добавляет следующие разделы:
VK: Сопоставление сценариев, типов заявки и дополнительных атрибутов - позволяет получить id типов заявок а стороне VK HR Tek и связать их со сценариями подписания Кортеос, а также указать id специального атрибута для добавления в заявку
VK: Настройки - Общие настройки интеграции с API VK HR Tek
VK: Сопоставление организаций и настроек API - отвечает за сопоставление id “суперпользователя” и id компании на стороне VK HR Tek с организациями в Corteos для корректного осуществления запросов к API в случае наличия нескольких организаций на стороне заказчика
Далее рассмотрим каждый раздел подробнее.
VK: Настройки
В этом разделе необходимо указать основные данные, необходимые для корректного обращения к API VK HR Tek:
Токен авторизации - токен для доступа к API, предоставляется со стороны VK HR Tek
Адрес API - Endpoint API VK HR Tek - https://public-api.vkdoc.mail.ru/api/v1
X-User-Id пользователя - id пользователя, от лица которого будут создаваться все заявки на стороне VK HR Tek
Независимо от того, кто является участником заявки (командировки или заявки на расход), ее создателем, или кто запускает подписание, заявка в VK HR Tek всегда создается от лица пользователя, чей X-User-Id указан в настройках. Заказчику необходимо организовать создание такого пользователя на стороне VK HR Tek, проконтролировать предоставление ему необходимых прав и получить его X-User-Id
ID компании - значение атрибута legal_id, предоставляется со стороны VK HR Tek
Причина отмены - id причины отмены заявок, предоставляется со стороны VK HR Tek
Текущая реализация предполагает использование одной универсальной причины отмены заявок. Заказчику необходимо договориться с VK HR Tek о добавлении такой причины и о получении ее идентификатора
Интервал переопроса (часы) - интервал, с которым будет происходить фоновое обращение к API VK HR Tek с запросом на получение данных заявки. Также обращение происходит при каждом открытии командировки/заявки на расход.
VK: Сопоставление сценариев, типов заявки и дополнительных атрибутов
При переходе в этот раздел пользователь попадает в список имеющихся сценариев с возможностью отредактировать настройки каждого сценария. Список формируется автоматически, исходя из заведенных сценариев:
При переходе в конкретный сценарий, открывается редактор сопоставления:
Разберем подробно его возможности:
Прежде всего мы можем обратиться к API VK HR Tek, чтобы получить список доступных для создания заявок и их event_type_id, необходимого для сопоставления типа заявки VK HR Tek и сценария подписания Corteos. Для этого нам необходимо заполнить поля:
X-User-Id - id пользователя, от лица которого будут создаваться заявки на стороне VK HR Tek
Company_id - значением legal_id, полученным от VK HR Tek
После чего необходимо нажать кнопку “Отправить запрос”, результатам чего, станет получение списка доступных для создания типов заявок и их названий:
Полученное значение event_type_id необходимо вставить в поле ID типа заявки VK в редакторе соответствующего сценария:
Также в этом редакторе есть другие значения/настройки:
ID сценария - id сценария подписания Corteos
Название сценария - название сценария подписания Corteos
Отправлять в запросе на загрузку документов атрибут даты начала командировки - при включении этого переключателя появляется поле для указания ID атрибута для добавления в заявку на стороне VK. На текущий момент реализована только передача в качестве атрибута даты начала командировки (для командировки - это дата начала контейнера, для заявки на расход - это дата создания)
ID атрибута - поле для указания id атрибута
VK: Сопоставление организаций и настроек API
В этом разделе возможно сопоставление X-User-Id и ID компании (legal_id) с организациями Corteos. Актуально для заказчиков, которые используют в Corteos несколько организаций и создание заявок на подписание в VK должно происходить от лица разных “суперпользователей”:
