# HRlink КЭДО

Кадровый электронный документооборот — документы, сотрудники, заявления

## Сценарии

### Документы без подписи
Агент покажет, какие кадровые документы зависли без подписи и за кем из сотрудников числится задержка.

### Сверка реестра сотрудников
Агент сверит сотрудников по юрлицам, подразделениям и должностям и найдёт пропуски в карточках.

### Заявления и график отпусков
Агент соберёт поданные заявления и график отпусков и покажет, чьи отпуска начинаются на ближайшей неделе.

### Ознакомление с ЛНА
Агент сверит реестр локальных нормативных актов с документами сотрудников и назовёт тех, кто ещё не ознакомлен.

## Как подключить

### Проверьте роль «Кадровик» в своём юрлице
Токен выдаётся только сотруднику с ролью «Кадровик» (HR) в карточке сотрудника. Без неё реестры сотрудников и документов отвечают 403, а сам пункт выдачи токена в меню не появляется.

### Запишите адрес своего тенанта HRlink
Это адрес, по которому вы входите в кабинет, вида company.hr-link.ru — HRlink выдаёт его при покупке лицензии. У каждой компании он свой, общий portal.hr-link.ru чужому тенанту не подойдёт.

### Выпустите API-токен в меню профиля
Иконка с инициалами в правом верхнем углу → «Получить API-токен», в диалоге нажмите «Скопировать». Токен действует один год с момента выпуска — после этого запросы начнут отвечать 401.

### Узнайте clientId одним запросом к API
Вызовите GET /api/v2/currentUser на своём адресе с заголовком User-Api-Token и возьмите currentUser.clientUsers[].client.id — это UUID вида 668a634a-c4e9-4416-a481-656c3f17ea06.

## Частые вопросы

### Как подключить HRlink КЭДО?
Тремя полями: clientId, API-токен и адрес тенанта. Токен выпускает сотрудник с ролью «Кадровик» в меню профиля — «Получить API-токен», действует он год. clientId возьмите из ответа GET /api/v2/currentUser, а адрес укажите, если ваш тенант отличается от portal.hr-link.ru.

### Что агент видит в HRlink?
Кадровые документы и их печатные формы, заявления, сотрудников, юрлица, подразделения и должности, типы документов, реестр ЛНА и график отпусков.

### Пишет ли агент в HRlink?
Нет: подключение работает на чтение. Агент собирает и сверяет данные, но не создаёт документы и не подписывает их за сотрудников.

### Почему реестры отвечают 403?
У сотрудника, чьим токеном подключён HRlink, нет роли «Кадровик» в юрлице. Без неё пункт выдачи токена не появляется в меню, а реестры сотрудников и документов закрыты.

[Открыть HRlink КЭДО](https://portal.hr-link.ru)
