Continuamos ampliando os recursos da API pública v2 no RO App. Agora, pela API, você pode trabalhar com a escala de trabalho e a folha de ponto dos funcionários para sincronizar esses dados com outros sistemas e não precisar inseri-los manualmente.
Escala de trabalho e folha de ponto via API
Uma nova seção Employee Hours foi adicionada à API pública, com endpoints para a escala de trabalho e a folha de ponto.
Tanto para a escala de trabalho quanto para a folha de ponto, agora você pode:
obter dados de um período de até 92 dias;
obter dados de todos os funcionários para uma data específica;
obter dados de um funcionário específico para uma data selecionada;
criar ou substituir completamente os dados de um funcionário para uma data selecionada;
excluir os dados de um funcionário para uma data selecionada.
Observação: a escala de trabalho pode ser alterada tanto para dias passados quanto futuros, enquanto a folha de ponto só pode ser alterada para dias passados e para o dia atual, já que registra o tempo efetivamente trabalhado.
Para um dia de trabalho, você pode enviar vários intervalos – por exemplo, se um funcionário trabalha em uma localização na primeira metade do dia e em outra na segunda. Para um dia não trabalhado, você pode indicar o tipo: férias, licença médica ou folga, e também marcar se ele é remunerado.
Os dados podem ser filtrados por funcionários, localizações e tipo de dia.
Saiba mais sobre os endpoints da escala de trabalho e da folha de ponto na documentação da API pública.
Como os novos endpoints vão ajudar o seu negócio
Por exemplo, com eles você pode:
sincronizar a escala de trabalho com sistemas de RH e serviços de planejamento de turnos;
transferir automaticamente a escala de trabalho e a folha de ponto de sistemas externos para o RO App;
enviar dados sobre o tempo de trabalho para sistemas de folha de pagamento e contabilidade;
criar relatórios próprios sobre a carga de trabalho dos funcionários em diferentes localizações.
Acesso aos endpoints
A chave de API pertence a um funcionário específico do RO App e tem as mesmas permissões de acesso que ele. Para obter os dados, o funcionário precisa ter permissão para visualizar a jornada de trabalho dos funcionários e, para alterá-los – permissão para editar a escala de trabalho ou a folha de ponto.
Se você tiver dúvidas, sugestões ou comentários sobre a API pública e os webhooks do RO App, entre em contato conosco pelo chat de suporte.