Відпустка (vacation)¶

Відпустка - це задача, яка дозволяє співробітнику отримати відпустку на певний період часу. Вона створюється на основі шаблону відпустки, який визначає тип відпустки, тривалість та інші параметри.

Налаштування доступних типів відпусток, а також стандартних підписантів і набір документів для підпису доступний лише через веб-інтерфейс Вчасно.Кадри. API дозволяє лише створювати задачі на основі вже налаштованих шаблонів відпусток.

Як налаштувати шаблони відпусток?.

Доступні шаблони відпусток можна отримати через ендпоінт https://kadry.vchasno.ua/api/public/v1/vacation/template. Далі можна створити задачу "Відпустка" на основі обраного шаблону через ендпоінт https://kadry.vchasno.ua/api/public/v1/vacation. Необхідно передати ID шаблону відпустки, а також ID співробітника, для якого створюється задача. Опціональним полем є external_id, яке може бути використано для ідентифікації задачі в зовнішніх системах.

Після створення задачі "Відпустка", автоматично створяться документи для підпису, які можна переглянути через ендпоінт https://kadry.vchasno.ua/api/public/v1/vacation/{task_id}/document. На даному етапі ці документи ще не були надіслані на підпис, і їх можна редагувати, наприклад, змінювати підписантів або змінювати файл документу.

Зміна файлу на підпис¶

При надсиланні документів на підпис, система атоматично згенерує файл заяви та наказу на основі шаблонів і підписантів. Це можна змінити, завантаживши свій файл до надсилання на підпис через ендпоінт https://kadry.vchasno.ua/api/public/v1/vacation/{task_id}/document/{document_id}/upload.

Зміна підписантів¶

До моменту надсилання документів, можна додати або видалити підписантів через ендпоінт https://kadry.vchasno.ua/api/public/v1/vacation/{task_id}/document/{document_id}/signer. Ці ендаоінти оперують ID співробітників, і приймають тільки співробітників, які мають статус working.

Надсилання документів на підпис¶

В рамках задачі "Відпустка" можна надіслати до двох документів: Заяву та/або Наказ. Якщо присутні обидва документи, то їх можна надіслати на підпис одночасно, або окремо. Для цього використовується ендпоінт https://kadry.vchasno.ua/api/public/v1/vacation/{task_id}/send-documents. При послідовному надсиланні, спочатку надсилається Заява, і тільки після повного підписання, є можливість надіслати Наказ. При надсиланні Наказу, необходно передати номер наказу (order_number), а також періоди, за які надається відпустка (periods).

Очікувана послідовність дій для задачі "Відпустка"¶

Отримати доступні шаблони відпусток
Створити задачу "Відпустка", передавши ID шаблону та ID співробітника
Отримати документи для підпису
При необхідності, змінити файл документу
Додати або видалити підписантів
Надіслати документи на підпис, передавши необхідні параметри для Наказу, якщо він є

Типи відпусток¶

Тип відпустки (task template type)	Тип залишків (absence type)	Тип періоду за замовчуванням	Назва
vacation_annual	annual	Робочий рік	Щорічна основна відпустка (ст. 6 Закону України "Про відпустки")
vacation_annual_hazardous	annual_hazardous	Робочий рік	Щорічна додаткова відпустка за роботу із шкідливими та важкими умовами праці (ст. 7 Закону України "Про відпустки")
vacation_annual_special_work	annual_special_work	Робочий рік	Щорічна додаткова відпустка за особливий характер праці (ст. 8 Закону України "Про відпустки")
vacation_social_maternity_leave	social_maternity_leave	Календарний рік	Відпустка у зв’язку з вагітністю та пологами (ст. 17 Закону України "Про відпустки")
vacation_social_child_care	social_child_care	Календарний рік	Відпустка для догляду за дитиною до досягнення нею трирічного віку (ст. 18 Закону України "Про відпустки")
vacation_social_parental	social_parental	Календарний рік	Додаткова соціальна відпустка працівникам, які мають дітей або повнолітню дитину з інвалідністю (ст. 19 Закону України "Про відпустки")
vacation_social_child_birth	social_child_birth	Календарний рік	Відпустка при народженні дитини (ст. 19¹ Закону України "Про відпустки")
vacation_social_adoption	social_adoption	Календарний рік	Відпустка у зв’язку з усиновленням дитини (ст. 18¹ Закону України "Про відпустки")
vacation_social_pco	vacation_social_pco	Календарний рік	Додаткова відпустка учаснику бойових дій відповідно до ст. 16¹ Закону України "Про відпустки"
vacation_social_chornobyl	vacation_social_chornobyl	Календарний рік	Відпустка для людей, які постраждали внаслідок Чорнобильської катастрофи (ст. 20 Закону України "Про відпустки")
vacation_social_revolution_dignity	vacation_social_revolution_dignity	Календарний рік	Додаткова відпустка постраждалому учаснику Революції Гідності (ст. 16² Закону України "Про відпустки")
vacation_donor_rest_day	vacation_donor_rest_day	Календарний рік	День відпочинку за здачу крові (ст. 9 Закону України "Про донорство крові та її компонентів" та ч. 2 ст. 20 Закону № 931)
vacation_study_educational	study_educational	Календарний рік	Додаткова відпустка у зв’язку з навчанням (ст. 13, 14, 15 Закону України "Про відпустки")
vacation_study_creative	study_creative	Календарний рік	Творча відпустка (ст. 16 Закону України "Про відпустки")
vacation_study_athletic	study_athletic	Календарний рік	Відпустка для підготовки та участі у змаганнях (ст. 16¹ Закону України "Про відпустки")
vacation_unpaid	unpaid	Календарний рік	Відпустка без збереження заробітної плати (ст. 25 Закону України "Про відпустки")
vacation_unpaid_agreed	unpaid_agreed	Календарний рік	Відпустка без збереження заробітної плати (за згодою сторін) (ст. 26 Закону України "Про відпустки")
vacation_unpaid_martial_law	unpaid_martial_law	Календарний рік	Відпустка без збереження заробітної плати на період дії воєнного стану (ст. 26 Закону України "Про відпустки")