# HRlink КЭДО

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

## Scenarios

### Documents left unsigned
The agent shows which HR documents are stuck without a signature and which employees the delay sits with.

### Checking the employee register
The agent cross-checks employees against legal entities, departments and positions and finds the gaps in their records.

### Applications and the vacation schedule
The agent collects submitted applications and the vacation schedule and shows whose time off starts in the coming week.

### Acknowledgement of internal policies
The agent compares the register of local regulations with employee documents and names everyone who has not acknowledged them yet.

## How to connect

### Check you hold the HR role in the legal entity
The token is issued only to a user with the «Кадровик» (HR) role in their employee card. Without it the employee and document registries return 403, and the token menu item does not appear.

### Write down your HRlink tenant address
It is the address you sign in at, shaped like company.hr-link.ru — HRlink assigns it when the licence is bought. Each company has its own; the shared portal.hr-link.ru will not match another tenant.

### Issue the API token from the profile menu
Click the initials icon in the top right corner, choose «Получить API-токен» (Get API token) and press «Скопировать» (Copy) in the dialog. The token is valid for one year; after that requests start returning 401.

### Get the clientId with a single API call
Call GET /api/v2/currentUser on your tenant address with the User-Api-Token header and take currentUser.clientUsers[].client.id — a UUID such as 668a634a-c4e9-4416-a481-656c3f17ea06.

## FAQ

### How do I connect HRlink HR EDF?
With three fields: clientId, an API token and the tenant address. The token is issued by an employee with the HR officer role from the profile menu — Get API token — and it is valid for a year. Take clientId from the response of GET /api/v2/currentUser, and enter the address if your tenant differs from portal.hr-link.ru.

### What does the agent see in HRlink?
HR documents and their printable forms, applications, employees, legal entities, departments and positions, document types, the register of local regulations and the vacation schedule.

### Does the agent write to HRlink?
No: the connection is read-only. The agent gathers and reconciles data, but it does not create documents and does not sign them on behalf of employees.

### Why do the registers return 403?
The employee whose token connects HRlink has no HR officer role in the legal entity. Without it the token issue item never appears in the menu, and the employee and document registers stay closed.

[Open HRlink КЭДО](https://portal.hr-link.ru)