Перейти до основного контенту

Оновлення публічного API v2: нові ендпоінти для графіка роботи та табеля робочого часу

Дізнайтеся про нові ендпоінти публічного API, які дозволяють працювати з графіком роботи та табелем робочого часу співробітників.

J
Автор: Julia

Ми продовжуємо розширювати можливості публічного API v2 в RO App. Тепер через API можна працювати з графіком роботи та табелем робочого часу співробітників, щоб синхронізувати ці дані з іншими системами та не вносити їх вручну.

Графік роботи і табель через API

У публічному API з'явився новий розділ Employee Hours з ендпоінтами для графіка роботи та табеля робочого часу.

І для графіка, і для табеля тепер ви можете:

  • отримувати дані за період до 92 днів;

  • отримувати дані всіх співробітників на конкретну дату;

  • отримувати дані конкретного співробітника на вибрану дату;

  • створювати або повністю замінювати дані співробітника на вибрану дату;

  • видаляти дані співробітника на вибрану дату.

Зверніть увагу: графік роботи можна змінювати як на минулі, так і на майбутні дні, а табель – лише на минулі дні та сьогодні, адже він фіксує фактично відпрацьований час.

Для робочого дня можна передавати кілька інтервалів – наприклад, якщо співробітник першу половину дня працює в одній локації, а другу – в іншій. Для неробочого дня можна вказати його тип: відпустка, лікарняний або вихідний, а також позначити, чи є він оплачуваним.

Дані можна фільтрувати за співробітниками, локаціями та типом дня.

Детальніше про ендпоінти для графіка роботи та табеля робочого часу – у документації публічного API.

Як нові ендпоінти допоможуть вашому бізнесу

Наприклад, з ними можна:

  • синхронізувати графік роботи з HR-системами та сервісами планування змін;

  • автоматично переносити графік і табель із зовнішніх систем у RO App;

  • передавати дані про робочий час у системи нарахування зарплати та бухгалтерського обліку;

  • створювати власні звіти про завантаженість співробітників у різних локаціях.

Доступ до ендпоінтів

API-ключ належить конкретному співробітнику RO App і має ті самі права доступу, що й він. Щоб отримувати дані, співробітник повинен мати право на перегляд робочого часу співробітників, а щоб змінювати їх – право на редагування графіка роботи або табеля.

Якщо у вас є запитання, пропозиції чи коментарі щодо публічного API та вебхуків RO App, зверніться до нас у чат підтримки.

Ви отримали відповідь на своє запитання?