Схема процесса интеграции


Загрузка дней для планирования

Создать задачу массовой синхронизации данных

Метод:  POST https://{host}/api/v1/clients/{clientId}/bulkDataSyncTasks

Ссылка на документацию OpenApi: https://docs.myhrlink.ru/public/openapi/hr-link/#tag/otherDataSync/operation/createBulkDataSyncTask

Загрузить дни для планирования может как Администратор, так и Кадровик (Настройщик не может(question) ) нужно ли это указывать ?

Описание переменных:

ПеременнаяОписаниеОбязательность

tenantHost

Хост тенанта, на который должен быть выполнен запрос

да

clientId

ИД клиента HRlinkда
externalId

Внешний идентификатор сотрудника.

Доступные для планирования дни можно загрузить всем сотрудникам пользователя. Но при планировании будут использованы дни по основному месту работу. Если основное место работы не задано, то (warning)  ...

Как задать основное место работы?

да
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": "{{ИД задачи массовой синхронизации данных}}"
    }
}

Загрузка региональных календарей сотрудников

Опциональный шаг.

Описать на отдельной странице.

  1. Загрузка календаря.
  2. Назначение календаря сотруднику.

Где используются календари в системе?

Разрешение планирования на год


Сотрудники планируют отпуска

Руководители согласуют


Загрузка отпусков из внешней системы в HRlink


Выгрузка спланированных в HRlink отпусков.