| Passo a passo: | A integração entre o Protheus e Swile ocorre para envio de Benefícios calculados. Os dados integrados são:
- Filiais (SM0)
- Grupos de Benefícios (RUA)
- Funcionários (SRA)
- Pedidos (SR0)
Além das tabelas citadas acima, existe também a tabela RFP que armazena os Tipo de Benefício + Código Swile. Recomendamos por boas práticas que ela seja Exclusiva.
Para que o Funcionário seja integrado, é obrigatório que exista em seu cadastro:
> Email
> CPF
> Celular
OBS: para facilitar o entendimento, foram inseridos prints dos processos em todo o passo a passo. Todas as palavras em 'azul', representam uma imagem, para abri-la, basta clicar em cima da palavra com o hiperlink.
Exemplo da uma imagem anexada a nossa documentação aqui.
Para que a integração aconteça, é necessário que exista um ambiente criado na plataforma Swile e usuário/senha. O cliente conseguirá esses dados através do time Swile, ou seja, no momento de configurar a implantação no Protheus, ele já terá estes dados em mãos.
Para os testes do time de Suporte, serão utilizados os dados do ambiente TESTE abaixo:
> URL da Plataforma: https://qa.veedigital.com.br/FinancialBackend/rest
> Usuário: totvs.qa.flex
> Senha: !Qaz3edc
Os parâmetros que devem ser preenchidos com estes dados são:
→ MV_APISWI1
→ MV_APISWI2
→ MV_APISWI3
|
Para que seja possível o envio dos dados e consulta das informações integradas com sucesso ou não, é necessária a inclusão de algumas rotinas no menu do SIGAGPE.
Para isso, acesse o Configurador - Ambiente - Cadastros - Menus - desmarque todos os menus e selecione apenas o 'Gestão de Pessoal' - clique em OK.
Adicione todos os menus do SIGAGPE à direita da tela para que não tenhamos problema com as demais rotinas existentes no módulo.
Para melhor visualização, optei por criar uma nova 'pasta' de menu, chamada Swile. Você pode definir onde ela será criada, no meu exemplo, criei esta pasta dentro da opção 'Atualizações'. Para isso, basta posicionar em cima do menu já existente e clicar em 'Novo Grupo'. Será aberta uma nova janela, onde você deve informar o nome da nova pasta, após isso, dê um ok.
Após ter criado a nova pasta, posicione sobre ela e clique em 'Novo Item' para iniciarmos a criação dos menus.
Vamos criar três novas rotinas, que são:
→ Grupos de Benefícios (GPEA950)
→ Integração Swile (GPEM940)
→ Consulta de Lote de Integração (GPEM940A)
Quando finalizar a inserção dos três menus, clique em 'Gerar' - Informe o Arquivo SIGAGPE e Gerar novamente. Após finalizar, os menus já estarão disponíveis no SIGAGPE.
OBS: faça esta etapa com o Protheus fechado, utilize apenas o Configurador. |
A partir deste passo, teremos que fazer o cadastro dos benefícios que terão integração com a Swile, através das rotinas Cadastro de Vale Alimentação (GPEA013), Cadastro de Vale Refeição (GPEA012) e Meios de Transporte (GPEA140).
Como base para este teste, faremos a inclusão do benefício Vale Refeição , vinculado ao Código de Benefício Swile v51 - Refeição.
OBS: a listagem exibida no campo 'Código de Benefício Swile' é obtida através do cadastro efetuado no sistema da Swile. |
Na rotina de Grupos de Benefícios (GPEA950), faremos o cadastro do grupo de benefícios existentes no Protheus, para vincular com os dados do grupo cadastrado na Swile.
Para isso, clique em Incluir, informe um Código e Descrição a seu critério, e no campo 'Grupo SWILE', informe o nome do grupo de benefícios existentes na plataforma Swile (no caso do time de Suporte, para os nossos testes, podemos informar qualquer nome neste campo). Na sequência, clique em Outras Ações - Carregar Benefícios.
Nesta tela, você pode selecionar dentre os benefícios cadastrados no Protheus que possuam o campo 'Código de Benefício Swile', quais farão parte deste cadastro de Grupo de Benefícios. Após selecionar e salvar, na parte inferior da rotina serão mostrados os benefícios que serão vinculados à este Grupo de Benefícios, e estando tudo correto, basta Confirmar. |
Através da rotina Atualização de Vales (GPEA133), faremos o vínculo entre o Funcionário e o benefício que criamos, neste caso, o Vale Refeição.
Para isso, basta localizar o Funcionário e clicar em Manutenção. Posicione na aba correspondente ao benefício que será feito o vínculo, e informe os dados necessários nos campos 'Código' e 'Qt. Vale DUt.' e salve.
Neste momento, você já pode fazer o cálculo do benefício através da rotina Cálculo (GP131CALC) de acordo com sua necessidade. Após isso, retornando na rotina Atualização de Vale, podemos ver que o benefício foi calculado para o Funcionário. |
Agora estamos prontos para iniciar nossas integrações =D
Para isso, vamos acessar a rotina Integração Swile (GPEM940) - Avançar até o passo 2 - Opções.
Aqui, teremos a listagem dos dados que podemos integrar para a Swile, e a princípio, podemos ignorar os parâmetros relacionados à integração de pedidos.
É extremamente importante que a ordem de integração seja respeitada conforme consta na rotina, caso contrário, não será possível mais a frente a integração de Funcionários e Pedidos.
Inicialmente, podemos selecionar as opções Filiais e Grupos de Benefícios.
Após a integração dos dados acima, devemos retornar na rotina de Integração Swile e integrar os Funcionários.
Por fim, vamos integrar os Pedidos. Neste momento, é importante o correto preenchimento dos parâmetros, selecionando a Filial, informando as datas de Crédito do Benefício e Vencimento do Boleto, bem como selecionar a competência. Com isso, finalizamos a integração dos nossos dados com a Swile. |
Agora estamos prontos para iniciar nossas integrações =D
Para isso, vamos acessar a rotina Integração Swile (GPEM940) - Avançar até o passo 2 - Opções.
Aqui, teremos a listagem dos dados que podemos integrar para a Swile, e a princípio, podemos ignorar os parâmetros relacionados à integração de pedidos.
É extremamente importante que a ordem de integração seja respeitada conforme consta na rotina, caso contrário, não será possível mais a frente a integração de Funcionários e Pedidos.
Inicialmente, podemos selecionar as opções Filiais e Grupos de Benefícios.
Após a integração dos dados acima, devemos retornar na rotina de Integração Swile e integrar os Funcionários.
Por fim, vamos integrar os Pedidos. Neste momento, é importante o correto preenchimento dos parâmetros, selecionando a Filial, informando as datas de Crédito do Benefício e Vencimento do Boleto, bem como selecionar a competência. Com isso, finalizamos a integração dos nossos dados com a Swile. |
O Postman é uma ferramenta de mercado, onde conseguimos simular o envio de arquivos XML/JSON na integração via Mensagem Única (EAI), simulando integrações com o Protheus, ou seja, ao invés de termos que instalar o outro sistema e aprender como fazer o processo nele, usamos o Postman para simular os testes e validações necessárias. Link para baixar o Postman: https://www.postman.com/downloads/ Cabe ressaltar que usaremos o Postman apenas nos casos onde precisamos simular o consumo de dados no Quirons, por exemplo, se precisamos consumir os dados de um novo Centro de Custo cadastrado. - A API RESTful é uma interface que dois sistemas usam para trocar informações de forma segura pela internet.
- Os Métodos existentes em uma API são como as ações que esta API permite que sejam realizadas através dela:
- DELETE: Método específico para remoção de dados, ou seja, permite deletar dados através da API;
- GET: Método para uma requisição que busca dados, ou seja, ele é usado para consultar dados através da API, não altera informações, apenas as carrega;
- POST: Método para uma requisição que envia dados, ou seja, é usado para inserir informações através da API;
- PUT: Método para atualização de dados, pode ser utilizado quando se deseja atualizar uma informação já existente.
|
|
|
|
