Painel | ||||||
---|---|---|---|---|---|---|
| ||||||
|
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.
Nota |
---|
Observação: Os dados de acesso para utilização da API, serão disponibilizados pela equipe da humanus. |
Aviso | ||
---|---|---|
| ||
É 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.
Informações |
---|
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.
Dica |
---|
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.