Мы продолжаем расширять возможности публичного API v2 в RO App. Теперь через API можно работать с графиком работы и табелем рабочего времени сотрудников, чтобы синхронизировать эти данные с другими системами и не вносить их вручную.
График работы и табель через API
В публичном API появился новый раздел Employee Hours с эндпоинтами для графика работы и табеля рабочего времени.
И для графика, и для табеля теперь вы можете:
получать данные за период до 92 дней;
получать данные всех сотрудников на конкретную дату;
получать данные конкретного сотрудника на выбранную дату;
создавать или полностью заменять данные сотрудника на выбранную дату;
удалять данные сотрудника на выбранную дату.
Обратите внимание: график работы можно изменять как на прошедшие, так и на будущие дни, а табель – только на прошедшие дни и сегодня, ведь он фиксирует фактически отработанное время.
Для рабочего дня можно передавать несколько интервалов – например, если сотрудник первую половину дня работает в одной локации, а вторую – в другой. Для нерабочего дня можно указать его тип: отпуск, больничный или выходной, а также отметить, является ли он оплачиваемым.
Данные можно фильтровать по сотрудникам, локациям и типу дня.
Подробнее об эндпоинтах для графика работы и табеля рабочего времени – в документации публичного API.
Как новые эндпоинты помогут вашему бизнесу
Например, с их помощью можно:
синхронизировать график работы с HR-системами и сервисами планирования смен;
автоматически переносить график и табель из внешних систем в RO App;
передавать данные о рабочем времени в системы расчёта зарплаты и бухгалтерского учёта;
создавать собственные отчёты о загруженности сотрудников в разных локациях.
Доступ к эндпоинтам
API-ключ принадлежит конкретному сотруднику RO App и имеет те же права доступа, что и он. Чтобы получать данные, сотрудник должен иметь право на просмотр расписания сотрудников, а чтобы изменять их – право на редактирование графика работы или табеля.
Если у вас есть вопросы, предложения или комментарии по публичному API и вебхукам RO App, напишите нам в чат поддержки.