1. Создание календаря

https://docs.myhrlink.ru/public/openapi/hr-link/#tag/directoriesCalendar/operation/createCalendar

тело запроса

{
  "externalId": "16",
  "name": "Региональный календарь Республики Татарстан"
}
  • externalId - ID календаря из внешней системы
  • name - Название календаря

тело ответа

{
  "result": true,
  "calendar": {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "externalId": "16",
    "type": "CUSTOM",
    "name": "Республика Татарстан",
    "createdDate": "2019-08-24T14:15:22Z",
    "version": 1
  }
}

2. Наполнение календаря

https://docs.myhrlink.ru/public/openapi/hr-link/#tag/directoriesCalendar/operation/uploadYearsByExternalId 

тело запроса

{
  "years": [
    {
      "year": 2025,
      "dates": [
        {
          "month": 3,
          "day": 30,
          "type": "HOLIDAY"
        },
        {
          "month": 6,
          "day": 5,
          "type": "DAY_BEFORE_HOLIDAY"
        },
        {
          "month": 6,
          "day": 6,
          "type": "HOLIDAY"
        },
        {
          "month": 8,
          "day": 29,
          "type": "DAY_BEFORE_HOLIDAY"
        },
        {
          "month": 8,
          "day": 30,
          "type": "HOLIDAY"
        }
      ]
    }
  ]
}

 

Передаются только дни, переопределяющие или дополняющие основной производственный государственный календарь РФ. Итоговый производственный календарь будет содержать производственный календарь РФ, дополненный созданным календарем

Типы дней:

  • HOLIDAY - праздничный день
  • WORKDAY - рабочий день
  • DAYOFF - выходной
  • DAY_BEFORE_HOLIDAY - сокращенный предпраздничный день


тело ответа

{
  "result": true,
  "calendar": {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "externalId": "16",
    "type": "CUSTOM",
    "name": "Региональный календарь Республики Татарстан",
    "createdDate": "2025-04-02T11:45:45.926563Z",
    "version": 1
  }
}

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

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

Необходимо использовать дискриминатор CLIENT_USERS_V5

 тело запроса

{
  "type": "CLIENT_USERS_V5",
  "data": [
    {
      "lastName": "string",
      "firstName": "string",
      "patronymic": "string",
     //// пропущено /////
      "employees": [
        {
          "externalId": "string",
         //// пропущено ///
          "mainWorkplace": true,
          "calendar": {
            "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
            "externalId": "16"
          }
        }
      ]
    }
  ]
}


  • mainWorkplace - признак основного места работы (для использоваться в модуле отпусков)
  • calendar.id - ID календаря в HRlink (в примере выше - это 497f6eca-6276-4993-bfeb-53cbbbba6f08) может отсутствовать, если передан
  • calendarExternalId. calendarExternalId - внешний идентификатор календаря, который был задан при его создании. (в примере выше - это "16")

Если значение ИД календаря null или не передано, то для сотрудника используется производственный календарь РФ.

История версий дискриминатора

  • CLIENT_USERS - Пользователи клиента версии 1.
  • CLIENT_USERS_V2 - Относительно версии 1 появилась возможность указания количества доступных дней отпуска.
  • CLIENT_USERS_V3 - Относительно версии 2 появилась возможность указания табельного номера сотрудника.
  • CLIENT_USERS_V4 - Относительно версии 3 появилась возможность указания признака основного места работы.
  • CLIENT_USERS_V5 - Относительно версии 4 появилась возможность указания данных о календаре, на основании которого сформирован график работы сотрудника.
  • No labels