API, производственный календарь, обновление, Хантфлоу, выходные дни, больничные, отпускные

Новинка! API производственного календаря

Используйте новый метод API Хантфлоу в своих проектах и сервисах

API — это способ обмена информацией между сервисами. У Хантфлоу есть мощный API, который позволяет настроить интеграцию с практическим любым внутренним сервисом или мессенджером компании: от SAP и интранета до Slack и Telegram.

Эйчары и кадровые специалисты часто пользуются специальным производственным календарем, в котором указаны рабочие и выходные дни — он нужен для подсчета KPI, постановки дедлайнов, расчета больничных и зарплат.

В самом Хантфлоу производственный календарь России, Казахстана, Республики Беларусь и Украины используется для формирования статистики внутри сервиса. Например, срок закрытия вакансии считался и в календарных, и в рабочих днях — это важно, чтобы получать корректную информацию.

Рассчитывать и использовать число рабочих дней очень важно в самых разных проектах и задачах. Теперь вместо того, чтобы разрабатывать логику и поддерживать актуальность своего сервиса — используйте наш новый API производственного календаря.

Примеры использования производственного календаря

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

В разных странах праздники и их даты отличаются. Это важно учитывать, если вы работаете с клиентами или поставщиками из других стран. Поэтому в Хантфлоу есть календари для России, Украины, Республики Беларусь и Казахстана.

GET /production_calendar вернет список производственных календарей для разных стран

{
"items": [
{
"id": 1,
"name": "Russian Federation"
},
...
]
}

GET /production_calendar/{calendar_id} вернёт календарь с идентификатором {calendar_id}

{
"id": 1,
"name": "Russian Federation"
}


Получение нерабочих дней за период

Эта функция пригодится, если вам нужно подсчитать количество выходных дней в определенном периоде времени: например, при определении успешности выполнения KPI, расчете отпускных или больничных.

GET /production_calendar/{calendar_id}/days/{deadline} вернет информацию о нерабочих днях до даты {deadline} в формате YYYY-MM-DD, согласно календарю {calendar_id}.

API даст ответ в таком формате:

{
"total_days": 36,
"not_working_days": 28,
"items": ["2019-01-01", ... ]
}

У этого запроса есть и массовая версия:

POST /production_calendar/{calendar_id}/days

В теле запроса необходимо передать JSON вида:

[
{"deadline": "2019-04-20"},
{"deadline": "2019-05-20" "start": "2018-05-20"}
]


Расчет даты в будущем с учетом нерабочих дней

Если вам нужно узнать, какая дата наступит, например, через 30 рабочих дней, вы легко сможете отправить запрос и получить ответ от API Хантфлоу. Эта функция пригодится при определении дедлайнов и KPI.

GET /production_calendar/{calendar_id}/deadline/{days} — вернет дату в будущем, через {days} рабочих дней, согласно календарю {calendar_id}.

POST /production_calendar/{calendar_id}/deadline — массовая версия этого запроса.

В теле запроса необходимо передать JSON вида:

[
{"days": 10},
{"days": 20},
{"days": 30, "start": "2007-09-01"}
]


Расчет даты в прошлом с учетом нерабочих дней

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

GET /production_calendar/{calendar_id}/start/{days} — вернет дату в прошлом, через {days} рабочих дней, согласно календарю {calendar_id}.

Для массового расчета дней используйте эту версию запроса: POST /production_calendar/{calendar_id}/start.

В теле запроса необходимо передать JSON вида:

[
{"days": 10},
{"days": 20},
{"days": 30, "deadline": "2017-09-01"}
]

Читайте полную документацию на Github.


С Хантфлоу скучные задачи и рутина остаются в прошлом →