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

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

тело запроса

{
  "externalId": "16",
  "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"
          }
        }
      ]
    }
  ]
}


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

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