INTEGRAÇÃO DE FUNCIONÁRIOS COM A API ATSLOG

Especificação – Produto: ATSLOG

Requisitos da Integração

A API da ATSLOG será consumida por meio de métodos REST, com autenticação baseada em token. A integração envolve a comunicação de dados relacionados aos colaboradores entre a plataforma Globus e o ATSLOG, de acordo com os parâmetros abaixo.

Métodos da API a Serem Utilizados

Login (Autenticação)

URL: https://servicedesk.atslog.com.br:8088/login

Método: POST (Enviar)

Exemplo: Usuário e Senha:

 {

  "user": "atslog.teste",

  "pass": "teste@123"

}

Para atender o processo acima, foi implementado uma Tela de Parametrização ATSLOG, conforme apresentação abaixo.

***IMPORTANTE***

O token tem validade de 02 horas. Após esse período, será necessário um novo login para obter um token válido.

1. Parametrização da API

Caminho: FLP à Integração à ATSLOG à Parâmetros API

Foi implementada uma tela de parametrização para facilitar a comunicação entre o Globus e o ATSLOG. A tela permitirá que o usuário insira as informações necessárias para gerar o token de autenticação e realizar a integração de dados.

Campos da Tela de Parametrização:

• Empresa: Informar a empresa a ser atualizada.
• Filial: Informar a filial a ser atualizada.
• Endereço de Webservice: Informar o endereço do webservice fornecido pela ATSLOG.
• Usuário: Informar o usuário fornecido pela ATSLOG.
• Senha: Informar a senha definida com a ATSLOG.

A comunicação com a API requer que, a cada nova chamada, seja verificado a validade do token. Caso o token esteja expirado, um novo login será realizado para gerar um novo token.

2. Parametrização da Função Fixa no módulo controle

Caminho: CRT à Cadastros à Agrupamento para Função Fixa

Para que o envio para o ATSLOG seja realizado corretamente é necessário cadastrar as funções desejadas na opção Frequência.

Veja: Funções associadas para Motoristas 9 e 188.

3. Inclusão de Funcionários na ATSLOG

 Ao cadastrar um funcionário ou gerar uma informação relacionada a ele (como férias, afastamentos, etc.), constará uma mensagem informativa ao usuário se ele deseja enviar as informações para o ATSLOG.

Opção SIM: O cadastro será enviado imediatamente para a ATSLOG.

Opção NÃO: O cadastro não será enviado e o usuário poderá enviá-lo posteriormente, através da implementação da tela nova “Integração Funcionários – ATSLOG".

Apresentação da Tela: “Integração Funcionários – ATSLOG"

Exemplo 1: de Inclusão de Funcionário:

Ao cadastrar um novo funcionário, como no exemplo da admissão, será utilizado o método POST para enviar os dados para a ATSLOG.

Campos de Dados a Serem Enviados:

Nome, CPF, endereço, CNH, matrícula, cargo, setor, e outros campos conforme exigência do parceiro.

Exemplo 2: de Inclusão de Funcionário:

Ao cadastrar um novo funcionário, como no exemplo do afastamento, será utilizado o método POST para enviar os dados para a ATSLOG.

Exemplo 3: de Inclusão de Funcionário:

Ao cadastrar um novo funcionário, como no exemplo de quitação, será utilizado o método POST para enviar os dados para a ATSLOG.

Exemplo 3: de Inclusão de Funcionário:

Ao cadastrar um novo funcionário, como no exemplo de quitação simulada, será utilizado o método POST para enviar os dados para a ATSLOG.

Exemplo 4: de Inclusão de Funcionário:

Ao cadastrar um novo funcionário, como no exemplo de passivo trabalhista, será utilizado o método POST para enviar os dados para a ATSLOG.

Exemplo 5: de Inclusão de Funcionário:

Ao cadastrar um novo funcionário, como no exemplo de ficha médica, será utilizado o método POST para enviar os dados para a ATSLOG.

Exemplo 6: de Inclusão de Funcionário:

Ao cadastrar um novo funcionário, como no exemplo de efetivação de candidatos, será utilizado o método POST para enviar os dados para a ATSLOG.

Exemplo 7: de Inclusão de Funcionário:

Ao cadastrar um novo funcionário, como no exemplo de férias, será utilizado o método POST para enviar os dados para a ATSLOG.

3. Disponibilidade de Funcionários na ATSLOG

A tela de Integração de Funcionários ATSLOG permitirá que o usuário envie informações relacionadas a funcionários posteriormente, com status específico, como férias, admissão, afastamento, rescisão e quitação.

A. Campos da Tela de Disponibilidade:

1- Empresa:

O usuário deve selecionar a empresa que será atualizada no sistema ATSLOG. 

Importante: A empresa selecionada determinará a base de dados para o envio das informações.

2 - Filiais Disponíveis:

Aqui o usuário seleciona as filiais que terão seus registros atualizados.

Importante: Somente as filiais escolhidas terão os dados de seus funcionários enviados para o ATSLOG.

3 - Período:

Definir o intervalo de tempo no qual os registros de funcionários serão enviados.

Importante: O envio será condicionado ao período de inserido na Tela.

4.1 - Admissão/Alteração:

Incluir funcionários que foram admitidos ou que passaram por alterações em seu cadastro dentro do período especificado.

Exemplo: Cadastro de novos colaboradores ou para ajustes no cadastro de funcionários existentes, como mudança de algum campo na tela “Cadastro de Funcionários”.

4.2 - Desligados:

Incluir funcionários que foram desligados da empresa durante o período indicado.

Exemplo: Registrar rescisões contratuais ou pedidos de demissão, garantindo que o ATSLOG tenha as informações corretas sobre os colaboradores desligados.

4.3 - Afastados:

Incluir funcionários que se encontram afastados no período determinado.

Exemplo: Esta opção é importante para registrar colaboradores em licenças, como atestados médicos, afastamentos por motivos pessoais ou outros tipos de ausência prolongada, cadastrada na tela.

4.4 - Férias:

Incluir funcionários que estão de férias no período selecionado.

Exemplo: Permite o envio dos dados dos colaboradores em férias, garantindo que a ATSLOG tenha uma visão precisa da situação de cada funcionário, evitando impactos negativos na folha de pagamento.

5 - Botão Pesquisar:

Realiza a busca das informações com base nos critérios preenchidos nos campos da tela.

6 - Botão Limpar:

Remove todos os dados inseridos na tela, restaurando-a ao estado inicial, conforme o padrão Globus.

7 - Campo de Apresentação:

Exibe os nomes dos funcionários selecionados, de acordo com o período definido na busca, e os status, Admissão/Alteração, Desligados, Afastados e Férias e a descrição nos campos:

• Enviar, opção Caixa de Seleção
• Filial
• Código
• Chapa
• Nome
• Função
• Admissão
• Alteração
• Retorno

8 – Botão Enviar

Enviará as informações dos colaboradores selecionados no campo para ATSLOG.

4. Inclusão de Funcionários Integração de Funcionários ATSLOG

Exemplo: Rotina Afastamento

Veja: Colaborador constará na tela de Integração Funcionários – ATSLOG.

Nesse momento vamos enviar o funcionário para ATSLOG.

Exemplo: Cadastro Funcionário

Alteramos o campo cadastro de Horário eSocial

 Veja: Colaborador constará na tela de Integração Funcionários – ATSLOG com a opção de Alteração.

Nesse momento vamos enviar o funcionário para ATSLOG.

5. Gravação de Log 

Os processos nas rotinas gerarão registros de log no sistema, nas seguintes situações:

• Optou por não enviar os dados para ATSLOG – Tela Integração de Funcionários ATSLOG

6. Cancelamento/Exclusão da Rotina.

Caso a rotina seja cancelada ou excluída, o envio para o ATSLOG também será registrado.

Exemplo Cancelamento de Quitação:

Exemplo Excluir Afastamento:

                                                                 ***IMPORTANTE***

Processo no Grid de Integração quando não seleciona o registro para envio: Mensagem "Sem dados de funcionários em férias selecionados para envio" 

Atualmente, quando um usuário acessa a tela de integração seleciona um período e opção e não seleciona registros do trabalhador de "Envio", o sistema irá apresentar uma mensagem como exemplo abaixo.

#IA