...
Установить состояние возможности планирования отпусков
| Метод | Ссылка на документацию OpenAPI |
|---|---|
PUT https://{host}/api/v1/clients/{clientId}/vacations/setPlanningState | https://docs.myhrlink.ru/public/openapi/hr-link/#tag/vacationScheduleManage/operation/setPlanningState |
Дополнительная информация
- Опциональный шаг.
- Если необходимо в текущем году запретить Сотрудникам и Руководителям изменять отпуска, то требуется выполнить этот шаг.
- После наступления нового календарного года изменение отпусков будет автоматически недоступно для Сотрудника и Руководителя.
- Завершить планирование может только Администратор.
- Пользователь должен иметь право VACATIONS_CHANGE_PLANNING_STATE на уровне пользователя клиента или на уровне активного сотрудника.
Описание переменных
| Переменная | Описание | Обязательность |
|---|---|---|
tenantHost | Хост тенанта, на который должен быть выполнен запрос | да |
clientId | ИД клиента HRlink | да |
| planningState | Состояние планирования отпусков в системе HRlink. Может принимать два состояния:
| да |
| planningYear | Год, на который устанавливается настройка планирования.
| нет |
| Code Block | ||||
|---|---|---|---|---|
| ||||
curl --request PUT \
--url 'https://{{tenantHost}}/api/v1/clients/{clientId}/vacations/setPlanningState?planningState=DISABLED&planningYear=2026' \
--header 'Impersonated-User-Id: {{clientUserExternalId}}' \
--header 'Impersonated-User-Id-Type: EXTERNAL_ID' \
--header 'master-api-token: master_token_value
|
...
| No Format |
|---|
{
"result": true
} |
ШАГ 4. Выгрузить спланированные
...
отпуска из HRlink
Получить данные о запланированных отпусках сотрудников
...
| No Format |
|---|
{
"result": true,
"employeePlannedVacationPeriods": [
{
"id": "{{Внутренний ИД сотрудника}}",
"externalId": "{{Внешний ИД сотрудника}}",
"periods": [
{
"vacationType": "Основной",
"vacationStatus": "Ожидает согласования",
"dateFrom": "2026-09-15",
"dateTo": "2026-09-28"
},
{
"vacationType": "Дополнительный",
"vacationStatus": "Согласовано",
"dateFrom": "2026-10-01",
"dateTo": "2026-10-03"
}
]
}
]
} |
Загрузка отпусков из внешней системы в HRlink
...
ШАГ 5. Загрузить обновленные периоды запланированных отпусков в HRlink
Создать задачу массовой синхронизации данных
| Метод | Ссылка на документацию OpenAPI |
|---|---|
POST https://{host}/api/v1/clients/{clientId}/bulkDataSyncTasks type = CLIENT_USER_VACATIONS | https://docs.myhrlink.ru/public/openapi/hr-link/#tag/otherDataSync/operation/createBulkDataSyncTask |
Дополнительная информация
- Отпуска загружаются по физ.лицам, т.е. по пользователям HRlink. Все сотрудники пользователя будут иметь одинаковые отпуска.
- Загрузить запланированные отпуска может как Администратор, так и Кадровик (настройщик не может)
- Пользователь должен иметь право BULK_DATA_SYNC_TASKS_CREATE и право VACATIONS_CREATE_AND_UPDATE на уровне пользователя клиента или на уровне активного сотрудника.
- Информация о доступных днях для планирования необходима для возможности планирования отпусков в HRlink.
Описание переменных
| Переменная | Описание | Обязательность |
|---|---|---|
tenantHost | Хост тенанта, на который должен быть выполнен запрос | да |
clientId | ИД клиента HRlink | да |
| vacations{} | Данные для фильтрации периодов планируемых отпусков.
| да |
| startDateFrom | Начало периода, в который должно попадать начало запрашиваемого планируемого отпуска. | нет |
| startDateTo | Конец периода, в который должно попадать начало запрашиваемого планируемого отпуска | нет |
| status | Статус запрашиваемых планируемых отпусков сотрудников. | нет |
| employees[] | Список сотрудников, по которым необходимо получить отпуска.
| да |
id | ID сотрудника в системе HRlink. | нет |
| externalId | ID сотрудника во внешней системе. | нет |
| department[] | Список отделов, по которым необходимо получить отпуска.
| да |
id | ID отдела в системе HRlink. | нет |
| externalId | ID отдела клиента во внешней системе. | нет |
| legalEntity[] | Список юрлиц, по которым необходимо получить отпуска.
| да |
id | ID юрлица клиента в системе HRlink. | нет |
| externalId | ID юрлица клиента во внешней системе. | нет |
| limit | Количество возвращаемых при запросе элементов.
| нет |
| offset | Количество элементов, которые нужно пропустить при выборке. | нет |
| withoutDismissedEmployees | Вернуть ответ без уволенных сотрудников?
| нет |
| Code Block | ||||
|---|---|---|---|---|
| ||||
curl --request POST \
--url 'https://{{tenantHost}}/api/v1/clients/{{clientId}}/bulkDataSyncTasks' \
--header 'Impersonated-User-Id: {{clientUserExternalId}}' \
--header 'Impersonated-User-Id-Type: EXTERNAL_ID' \
--data '{
"type": "EMPLOYEE_VACATIONS_PLANNING",
"data": [
{
"externalId": "{{Внешний ИД сотрудника}}",
"legalEntityExternalId": "{{Внешний ИД юрлица}}",
"availableVacationsPlanning": [
{
"planningYear": 2026,
"basicVacationDayCount": 28,
"additionalVacationDayCount": 3
}
]
}
]
}'
|
Пример ответа
| No Format |
|---|
{
"result": true,
"employeePlannedVacationPeriods": [
{
"id": "{{Внутренний ИД сотрудника}}",
"externalId": "{{Внешний ИД сотрудника}}",
"periods": [
{
"vacationType": "Основной",
"vacationStatus": "Ожидает согласования",
"dateFrom": "2026-09-15",
"dateTo": "2026-09-28"
},
{
"vacationType": "Дополнительный",
"vacationStatus": "Согласовано",
"dateFrom": "2026-10-01",
"dateTo": "2026-10-03"
}
]
}
]
} |