Page History

...

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

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

...

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

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

• Разрешить планирование может только Администратор.
  • Пользователь должен иметь право VACATIONS_CHANGE_PLANNING_STATE на уровне пользователя клиента или на уровне активного сотрудника.

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

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

...

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

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

• Опциональный шаг.
  • Если необходимо в текущем году запретить Сотрудникам и Руководителям изменять отпуска, то требуется выполнить этот шаг.
  • После наступления нового календарного года изменение отпусков будет автоматически недоступно для Сотрудника и Руководителя.
• Завершить планирование может только Администратор.
  • Пользователь должен иметь право VACATIONS_CHANGE_PLANNING_STATE на уровне пользователя клиента или на уровне активного сотрудника.

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

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

...

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

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

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

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

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

...

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

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

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

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

• Загрузить запланированные отпуска возможно на любой год, вне зависимости от настройки разрешения планирования отпусков и наличия доступных дней отпуска у сотрудника.
• В одной задаче массовой синхронизации возможно загрузить не более 500 пользователей

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

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

...