Introdução – Integrador Gupy
O Integrador Gupy é um processo responsável por viabilizar a comunicação automatizada entre a plataforma Gupy e os sistemas corporativos da empresa, como o ERP Protheus da TOTVS, garantindo a troca segura e padronizada de informações ao longo das etapas de Recrutamento & Seleção e Admissão. Essa integração é baseada no uso de APIs públicas e Webhooks disponibilizados pela Gupy, permitindo que eventos originados na plataforma sejam consumidos e processados de forma estruturada pelos sistemas integrados.
No contexto da integração com o Protheus, o integrador atua como uma camada intermediária que recebe, valida e transforma os dados provenientes da Gupy — como informações de candidatos, evolução no processo seletivo e dados admissionais — para o formato e regras exigidas pelo ERP. Esse mecanismo assegura que as informações estejam alinhadas aos cadastros e processos de RH do Protheus, viabilizando a continuidade do fluxo até etapas como admissão, cadastro funcional e demais rotinas administrativas.
A comunicação entre as plataformas ocorre por meio de autenticação via token de acesso e da configuração de webhooks na Gupy, que disparam eventos específicos conforme ações realizadas no processo seletivo. Esses eventos são encaminhados ao integrador, que realiza o tratamento dos payloads e a posterior integração com o Protheus, respeitando as boas práticas recomendadas pela Gupy e os padrões de integração adotados pela TOTVS.
Esse processo tem como principal objetivo reduzir atividades manuais, evitar retrabalho e garantir a consistência das informações entre a Gupy e o Protheus, proporcionando maior eficiência operacional, confiabilidade dos dados e rastreabilidade das informações ao longo de todo o ciclo de e admissão de colaboradores. Além disso, o modelo de integração foi projetado para ser flexível e escalável, permitindo ajustes conforme regras de negócio específicas e futuras evoluções tanto da plataforma Gupy quanto do ERP Protheus.
Aplicação Rotina de integração
🔹 1 Aplicação do Fontes e ou Patch
Os Fontes serão disponibilizados pelo nosso time.
Para clientes T-Cloud, deve utilizar a primeira opção, já para clientes com servidor local, utilizar a segunda opção. Aplique o patch conforme o manual oficial da TOTVS:
🔗 Manual TOTVS T-CLOUD
🔹 2. Execução do Compatibilizador UPDGUPY1
⚠️ Antes de executar:
-
Realize o backup dos seguintes diretórios:
(Os diretórios acima correspondem à instalação padrão do Protheus. Ajuste conforme a estrutura utilizada pela sua empresa.)
-
Execute a rotina em modo exclusivo.
Nenhum usuário deve estar conectado ao sistema durante a execução. -
Verifique os índices personalizados (nickname):
Caso o compatibilizador precise criar índices, ele utilizará as ordens originais do Protheus.
Se os índices personalizados não estiverem identificados por nickname, eles podem ser sobrescritos. -
Desative a Integridade Referencial antes da execução do compatibilizador.
🔹 3. Adição do Menu de Chamada da Rotina
Acesse:
Configurador → Ambiente → Cadastros → Menus
Passo a passo:
-
Clique em “Todos os menus” para desmarcar todas as opções.
-
Marque apenas a caixinha do módulo desejado e clique em OK.
-
No painel esquerdo, selecione a pasta raiz do módulo onde deseja adicionar o menu.
-
Na coluna central, clique em Adicionar.
-
No painel direito, selecione a pasta/subpasta desejada e clique em Novo item.
-
Preencha os campos conforme abaixo:
| Campo | Valor sugerido |
|---|---|
| Descrição | Integração Gupy |
| Programa |
GUPY10
|
| Módulo | Gestao Pessoal → Miscelânea → Integrações |
| Tipo | Função de Usuário |
-
Clique em OK.
-
Em Arquivo, defina:
-
Se for sobrescrever o menu padrão, digite o nome do módulo (ex:
SIGAGPE) e clique em Gerar. -
Se for criar um novo menu, informe o nome desejado e clique em Gerar.
-
-
Clique em Fechar.
🔹 4. Acesso e Conferência
Acesse a rotina criada no menu Gestao Pessoal → Miscelânea → Integrações → Integração Gupy
e verifique se os dados e serviços estão sendo executados corretamente.
Rest Api Protheus
É fundamental que o serviço rest Protheus esteja ativo para receber os dados da Gupy.
De acordo com as politicas de segurança do Protheus, será necessário passar um usuario com acesso as rotinas envolvidas no processo.
Na aplicação dos fontes já é contemplado o endpoint GupyFuncionarios onde e possivel realizar e entrega dos dados.
A esturura padrao de Json envida pela Gupy para o integrador esta disponivel no link abaixo:
Abaixo temos exemplo do envio do post com atutenticação BASIC conforme usuario Protheus.
3 - Integrando no Protheus
Apos o receber os dados atraves da a api rest, na tela de integração Gupy será exibida as linhas de cada matricula de funcionario.
No primeiro momento o registro recebe o status "Amarelo" "Aguardando integração". Nesse momento o usuario deve acessar a opção "Integrar" para que o registro seja processado.
Será apresentando a seguinte tela e basta clicar em ok e aguardar a confirmação do processo.
Apos a conclusao, o processo pode receber dois Status, "Vermelho" "Integrção com Erro" ou "Verde" "Integrado com sucesso".
Na opção Visualizar é possivel consultar os motivos de "Erro de Integração" ou "Sucesso de integração.
