Схема процесса интеграции
Метод: POST https://{host}/api/v1/clients/{clientId}/bulkDataSyncTasks
Ссылка на документацию OpenApi: https://docs.myhrlink.ru/public/openapi/hr-link/#tag/otherDataSync/operation/createBulkDataSyncTask
Загрузить дни для планирования может как Администратор, так и Кадровик (Настройщик не может ) нужно ли это указывать ?
Описание переменных:
| Переменная | Описание | Обязательность |
|---|---|---|
tenantHost | Хост тенанта, на который должен быть выполнен запрос | да |
clientId | ИД клиента HRlink | да |
| externalId | Внешний идентификатор сотрудника. Доступные для планирования дни можно загрузить всем сотрудникам пользователя. Но при планировании будут использованы дни по основному месту работу. Если основное место работы не задано, то Как задать основное место работы? | да |
| legalEntityExternalId | Внешний идентификатор юрлица сотрудника. | нет |
| availableVacationsPlanning[] | Массив с данными для планирования. В массиве можно передать значения для нескольких лет. В системе будут обновлены только дни указанного года. | нет |
| planningYear | Год, на который будут планироваться отпуска | нет |
| basicVacationDayCount | Количество дней основного отпуска, доступных для планирования. Если данные не будут переданы, то они будут записаны как null. | нет |
| additionalVacationDayCount | Количество дней дополнительного отпуска, доступных для планирования. Если данные не будут переданы, то они будут записаны как null. | нет |
curl --location 'https://{{tenantHost}}/api/v1/clients/{{clientId}}/bulkDataSyncTasks' \
--header 'Impersonated-User-Id: {{clientUserExternalId}}' \
--header 'Impersonated-User-Id-Type: EXTERNAL_ID' \
--data '{
"type": "CUSTOM_STRUCTURES",
"data": [
{
"externalId": "{{Внешний ИД сотрудника}}",
"legalEntityExternalId": "{{Внешний ИД юрлица}}",
"availableVacationsPlanning": [
{
"planningYear": 2026,
"basicVacationDayCount": 28,
"additionalVacationDayCount": 3
}
]
}
]
}' |
Пример ответа
{
"result": true,
"bulkDataSyncTask": {
"id": "{{ИД задачи массовой синхронизации данных}}"
}
} |
Опциональный шаг.
Описать на отдельной странице.
Где используются календари в системе?
Сотрудники планируют отпуска
Руководители согласуют
Загрузка отпусков из внешней системы в HRlink
Выгрузка спланированных в HRlink отпусков.