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

Общие правила планирования нужны

админу Кадровику доступны любые изменения, согласование и т.д. в любом периоде. независимо от разрешения планирования
Разрешить планирование только Админ
- добавить особенности по этой сторе [US] HRL-8465 Ограничить возможность изменять прошедшие отпуска Сотрудником/Руководителем
после завершения планирования (шаг Х) сотрудники не смогут, руковдители смогут....
для планирвания необходимы дост дни для планирвания
планирование осуществляется с учетом регионального календаря сотрудника, если он был загружен сотруднику (Шаг Х)
планирование осуществляется только по осн и доп отпуску
планирование осуществляется по всем сотрудникам пользователя (развернуть + про согласование)
справочник типов отпусков пока не используется...планируется в будущем
при необходимости, можно загрузить изменения отпусков из внешней системы в Линк (шаг х)

Шаги процесса

ШАГ 1. Загрузить доступные дни для планирования на год

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

Метод

Ссылка на документацию OpenAPI

POST https://{host}/api/v1/clients/{clientId}/bulkDataSyncTasks

type = EMPLOYEE_VACATIONS_PLANNING

https://docs.myhrlink.ru/public/openapi/hr-link/#tag/otherDataSync/operation/createBulkDataSyncTask

Дополнительная информация

Загрузить дни для планирования может как Администратор, так и Кадровик (Настройщик не может ) нужно ли это указывать ?
- Пользователь должен иметь право BULK_DATA_SYNC_TASKS_CREATE на уровне пользователя клиента или на уровне активного сотрудника.
Информация о доступных днях для планирования необходима для возможности планирования отпусков в HRlink.

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

Переменная	Описание	Обязательность
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": "EMPLOYEE_VACATIONS_PLANNING",
    "data": [
       {
           "externalId": "{{Внешний ИД сотрудника}}",
           "legalEntityExternalId": "{{Внешний ИД юрлица}}",
           "availableVacationsPlanning": [
              {
               "planningYear": 2026,
               "basicVacationDayCount": 28,
               "additionalVacationDayCount": 3
              }
           ]
       }
    ]
}'

Пример ответа

{
    "result": true,
    "bulkDataSyncTask": {
        "id": "{{ИД задачи массовой синхронизации данных}}"
    }
}

ШАГ 1.1 Загрузить региональные календарей сотрудников

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

Если календари были загружены ранее и регулярно обновляются у сотрудников, то этот шаг можно пропустить.

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

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

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

ШАГ 2. Разрешить планирование отпусков на год

Установить состояние возможности планирования отпусков

Метод

Ссылка на документацию 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. Может принимать два состояния: ENABLED - Планирование разрешено. DISABLED - Планирование запрещено.	да
planningYear	Год, на который устанавливается настройка планирования. Допустимо указывать значение только текущего или следующего года. Если год не задан, то по умолчанию, настройка устанавливается на текущий год.	нет

curl --request PUT \
--url 'https://{{tenantHost}}/api/v1/clients/{clientId}/vacations/setPlanningState?planningState=ENABLED&planningYear=2026' \
--header 'Impersonated-User-Id: {{clientUserExternalId}}' \
--header 'Impersonated-User-Id-Type: EXTERNAL_ID' \
--header 'master-api-token: master_token_value

Пример ответа

{
    "result": true
}

ШАГ 3. Завершить планирование отпусков на год

Установить состояние возможности планирования отпусков

Метод

Ссылка на документацию 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. Может принимать два состояния: ENABLED - Планирование разрешено. DISABLED - Планирование запрещено.	да
planningYear	Год, на который устанавливается настройка планирования. Допустимо указывать значение только текущего или следующего года. Если год не задан, то по умолчанию, настройка устанавливается на текущий год.	нет

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

Пример ответа

{
    "result": true
}

ШАГ 4. Выгрузить спланированные отпуска из HRlink

Получить данные о запланированных отпусках сотрудников

Метод

Ссылка на документацию OpenAPI

POST https://{host}/api/v1/clients/{clientId}/employees/getPlannedVacationPeriod

https://docs.myhrlink.ru/public/openapi/hr-link/#tag/vacationScheduleGet/operation/getPlannedVacationPeriod

Дополнительная информация

Получить спланированные периоды отпусков может как Администратор, так и Кадровик.
- Пользователь должен иметь право EMPLOYEE_PLANNED_VACATIONS на уровне пользователя клиента или на уровне активного сотрудника.

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

Переменная	Описание	Обязательность
tenantHost	Хост тенанта, на который должен быть выполнен запрос	да
clientId	ИД клиента HRlink	да
vacations{}	Данные для фильтрации периодов планируемых отпусков. Даты начала и конца периода либо заданы обе, либо не заданы совсем.	да
startDateFrom	Начало периода, в который должно попадать начало запрашиваемого планируемого отпуска.	нет
startDateTo	Конец периода, в который должно попадать начало запрашиваемого планируемого отпуска	нет
status	Статус запрашиваемых планируемых отпусков сотрудников.	нет
employees[]	Список сотрудников, по которым необходимо получить отпуска. Если массив пуст, то в ответе будут присутствовать все доступные сотрудники, с учетом иных фильтров. Если массив задан, то передано одно из значений ID сотрудника, или внутренний, или внешний.	да
id	ID сотрудника в системе HRlink.	нет
externalId	ID сотрудника во внешней системе.	нет
department[]	Список отделов, по которым необходимо получить отпуска. Если массив пуст, то в ответе будут присутствовать все сотрудники из доступных отделов, с учетом иных фильтров. Если массив задан, то передано одно из значений ID отдела, или внутренний, или внешний.	да
id	ID отдела в системе HRlink.	нет
externalId	ID отдела клиента во внешней системе.	нет
legalEntity[]	Список юрлиц, по которым необходимо получить отпуска. Если массив пуст, то в ответе будут присутствовать все сотрудники из доступных юрлиц, с учетом иных фильтров. Если массив задан, то передано одно из значений ID юрлица, или внутренний, или внешний.	да
id	ID юрлица клиента в системе HRlink.	нет
externalId	ID юрлица клиента во внешней системе.	нет
limit	Количество возвращаемых при запросе элементов. Максимальное значение - 100 Значение по умолчанию - 10	нет
offset	Количество элементов, которые нужно пропустить при выборке.	нет
withoutDismissedEmployees	Вернуть ответ без уволенных сотрудников? По умолчанию, уволенные сотрудники вернутся в ответе.	нет

curl --request POST \
--url 'https://{{tenantHost}}/api/v1/clients/{clientId}/employees/getPlannedVacationPeriod' \
--header 'Impersonated-User-Id: {{clientUserExternalId}}' \
--header 'Impersonated-User-Id-Type: EXTERNAL_ID' \
--header 'master-api-token: master_token_value
--data '{
  "vacations": {
    "startDateFrom": "2026-01-01",
    "startDateTo": "2026-12-01",
    "status": "ALL"
  },
  "employees": [
    {
      "externalId": "{{Внешний ИД сотрудника}}"
    }
  ],
  "department": [
    {
      "externalId": "{{Внешний ИД отдела}}"
    }
  ],
  "legalEntity": [
    {
      "externalId": "{{Внешний ИД юрлица}}"
    }
  ],
  "limit": null,
  "offset": null,
  "withoutDismissedEmployees": true
}'

Пример ответа

{
  "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"
        } 
      ]
    }
  ]
}

ШАГ 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	ID сотрудника в системе HRlink.	нет
externalId	ID сотрудника во внешней системе.	нет
department[]	Список отделов, по которым необходимо получить отпуска. Если массив пуст, то в ответе будут присутствовать все сотрудники из доступных отделов, с учетом иных фильтров. Если массив задан, то передано одно из значений ID отдела, или внутренний, или внешний.	да
id	ID отдела в системе HRlink.	нет
externalId	ID отдела клиента во внешней системе.	нет
legalEntity[]	Список юрлиц, по которым необходимо получить отпуска. Если массив пуст, то в ответе будут присутствовать все сотрудники из доступных юрлиц, с учетом иных фильтров. Если массив задан, то передано одно из значений ID юрлица, или внутренний, или внешний.	да
id	ID юрлица клиента в системе HRlink.	нет
externalId	ID юрлица клиента во внешней системе.	нет
limit	Количество возвращаемых при запросе элементов. Максимальное значение - 100 Значение по умолчанию - 10	нет
offset	Количество элементов, которые нужно пропустить при выборке.	нет
withoutDismissedEmployees	Вернуть ответ без уволенных сотрудников? По умолчанию, уволенные сотрудники вернутся в ответе.	нет

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
              }
           ]
       }
    ]
}'

Пример ответа

{
  "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"
        } 
      ]
    }
  ]
}