Este manual foi elaborado com intuito de auxiliar no processo de integração dos arquivos RH disponibilizadas na API HUMANUS, com importação no sistema EMSys.
O que é uma API?
O conceito de API nada mais é do que uma forma de comunicação entre sistemas. Ou seja, elas permitem a integração entre dois sistemas, em que um deles fornece informações e serviços que podem ser utilizados pelo outro, sem a necessidade de algum dos sistemas conhecer detalhes de implementação do software.
Configuração
Para utilizar esta integração, o primeiro passo é realizar as configurações no menu: Sistemas → Parâmetros do Sistemas → RH - Humanus, e selecionar a FLAG Utiliza API - Humanus e preencher todos os campos, conforme animação abaixo.
Realizar o preenchimento no parâmetros sistemas.
Observação: Os dados de acesso para utilização da API, serão disponibilizados pela equipe da humanus.
IMPORTANTE
É de extrema importância realizar o preenchimento de todos os campos, para depois Clicar em Confirmar.
Realizado toda configuração acima, agora é possível solicitar os arquivos para equipe Humanus.
Solicitação do arquivo via API
Para solicitação de requisições do arquivo RH via API, seguir os passos abaixo corretamente.
Será realizado uma requisição na API - Humanus, no qual irá buscar um arquivo de lotes sobre a competência informada.
Caminho: Gerencial → Administrativo → Integração RH → Importar Dados RH
1ª Passo: Clicar no botão Buscar.
2ª Passo: Digite o mês/ano da competência e o período de pagamento.
3ª Passo: Clique em consultar.
4ª Passo: Selecionar as Espécies conforme a necessidade de cada cliente.
5ª Passo: Clique em Confirmar.
Após clicar em CONFIRMAR a solicitação aguardar o retorno da Humanus. A Humanus retornará a solicitação e o sistema irá apresentar a seguinte mensagem:
Sua solicitação foi registrada com sucesso na API da Humanus. Será exibido um número de protocolo da solicitação e o status: Requisição Efetuada.
Conforme imagem abaixo:
Quando apresentar a mensagem e clicar em OK o sistema fará a busca automática do arquivo. Nesse momento poderá ser feito outras operações no EMSys até que o arquivo esteja pronto pra importação.
Após a disponibilização do arquivo pela Humanus, o mesmo poderá ser importado no EMSys. Não é preciso ficar aguardando um terceiro encaminhar o arquivo, basta aguardar a execução do processo no próprio sistema. Acompanhe as instruções abaixo.
Assim que o usuário clicar em Buscar será encaminhado a solicitação, o Status ficará Em processamento, até o retorno do arquivo em lote.
Depois que o arquivo for encaminhado para a base EMSys, o Status será alterado para Concluída. Agora é possível Importar o arquivo descrito logo abaixo no tópico: Importar Arquivo.
Histórico Arquivo Humanus - API
É possível consultar o status de cada solicitação enviada â Humanus. Para isso acesse a tela de Histórico de Arquivo Humanus - API.
Caminho: Gerencial → Administrativo → Integração RH → Histórico Arquivo Humanus - API
- Digite o Período de Solicitação
- Digite a Competência no formato mês/ano.
- Clique em Pesquisar
No exemplo abaixo é possível visualizar o Status de uma solicitação: Requisição em Andamento.
Importar Arquivo
Quando o arquivo estiver pronto para Importação o sistema irá apresentar um POP UP, no canto inferior direito da tela.
Ao clicar no Pop UP, será direcionado para tela Histórico Arquivo Humanus. Selecione o arquivo com Status Concluída e Clique em Importar Arquivo.
Ao clicar em importar Arquivo será direcionado para Tela Integração RH já com a leitura do XML realizada, bastando a Conferencia dos valores para a importação dos movimentos no sistema.
Antes de clicar em Importar faça a conferencia dos débito e crédito.