| Passo a passo: | A integração entre o Protheus e Feedz ocorre para envio dos dados abaixo:
- Filiais (SM0)
- Funcionários (SRA)
- Participantes (também conhecido como Pessoas - RD0 e RDZ)
- Cargos (SQ3)
- Departamentos (SQB)
- Grupos de Contrato (SX5 - Tabela 1C)
- Líder dos Funcionários (utilizado quando o cliente tem controle de Hierarquia por uso do App MEU RH ou Portal GCH - SRA + RD0 + RDZ)
As informações enviadas do Protheus para a Feedz, estarão presentes em uma tabela chamada REF, e os dados integrados (com falha ou sucesso) via rotina de Carga Inicial ou Schedule, podem ser visualizados na rotina de Consulta de Lotes.
Para que os Funcionários possam ser integrados, é obrigatório que exista na SRA:
> Email
> Cargo
> Departamento
> CPF
Dicas:
→ Nos casos em que o cliente nos procura com erros na integração que não sejam do lado do Protheus ou dúvidas sobre a plataforma Feedz de modo geral, devemos orientar que ele procure o seu Agente de Sucesso Feedz.
→ Existem casos em que o cliente acaba tendo falhas cadastrais na Integração, como por exemplo, foi enviado um funcionário com email incorreto ou email de outra pessoa. Nestes casos, podemos orientar que ele ajuste manualmente os registros na Feedz e processe novamente a integração do Funcionário pela rotina do Protheus, mas se mesmo assim o problema persistir e chegarmos à um nível que não temos mais o que avaliar/orientar da nossa parte, devemos entrar em contato com o time de Suporte da Feedz via chat.
→ Os clientes possuem ambiente Teste chamado 'Sandbox' e a Produção. Caso ocorram falhas na integração relacionadas à URL ou token, é legal orientar que ele valide se está utilizando os dados do ambiente correto.
→ A Feedz não trabalha com múltiplos vínculos, então nestes casos, devemos orientar o cliente a integrar somente um dos registros do funcionário.
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 Feedz + token de acesso. O cliente conseguirá esses dados através do seu Agente de Sucesso Feedz, 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://integrations.feedz.dev/protheus-feedz-etl/
> Token: eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJwcm9maWxlX2lkIjo3MjM2MiwiY29tcGFueV9pZCI6MTAyLCJ0aW1lc3RhbXAiOjE3MTA3ODc3MjZ9.8Pb8BM_t2hQ9fNPdL-BUnAgMTMnAqbh8xj3vStEGRg0
Os parâmetros que devem ser preenchidos com estes dados são:
→ MV_APIFEE1
→ MV_APIFEE2 |
Para que seja possível o envio dos dados, configuração da amarração dos Cargos e Departamentos (explicaremos mais adiante sobre isso) e consulta das informações integradas com sucesso ou não, é necessária a inclusão de algumas rotinas no meu 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 Feedz. 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 quatro novas rotinas, que são:
→ De x Para de Cargos (GPEA944B)
→ De x Para de Departamentos (GPEA944C)
→ Integração (GPEM939)
→ Consulta (GPEM939B)
Quando finalizar a inserção dos quatro menus, clique em 'Gerar' - 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 nesta etapa.
Caso tenha dificuldades na criação da nova pasta e menus, veja este vídeo: |
Dentro do SIGAGPE, teremos que ajustar dados nas tabelas auxiliares S043 e S049, no menu Atualizações - Definições de Cálculo - Manutenção Tabelas.
Na S043, devemos preencher a coluna 'Tipo P&M/Feedz'.
Na S049, devemos preencher a coluna 'Agrupador P&M/Feedz'.
OBS: em ambos casos, o cliente deve decidir sobre qual a forma que considera mais adequada para preenchimento das tabelas. |
O De x Para de Cargos é utilizado quando o cliente utiliza a tabela SQ3 com algum nível de exclusividade.
A Feedz não aceita a integração de dois Cargos com o mesmo nome existindo em Filiais diferentes, por este motivo, devemos utilizar esta rotina para 'amarrar' estes dados, de modo que uma única informação seja integrada para a Feedz.
No exemplo a seguir, tenho um Cargo com descrição 'Analista de Suporte' nas filiais M SP 01 e M SP 02.
Neste caso, os Cargos tem o mesmo nível/são exatamente iguais, portanto, antes de processar a integração farei a amarração destes dados.
Acessando a rotina De x Para de Cargos, clique em Incluir para iniciar o vínculo entre os dados.
Insira o código e descrição como preferir, e clique em Outras Ações - Vincular Cargos. Selecione os Cargos que são equivalentes e clique em Salvar.
Após isso, será demonstrada na parte inferior os Cargos vinculados a este cadastro de De x Para, e você pode vincular quantos cargos forem necessários. Finalizando a seleção, basta clicar em Confirmar.
Com isso, teremos nosso cadastro de De x Para do Cargo 'Analista de Suporte' criado e pronto para ser integrado.
A mesma regra é utilizada para os cadastros de Departamentos da tabela SQB, ou seja, caso exista qualquer nível de exclusividade, se faz obrigatório o cadastro de De x Para de Departamentos.
No exemplo a seguir, tenho um Departamento com descrição 'Suporte' nas filiais M SP 01 e M SP 02.
Neste caso, os Departamentos tem o mesmo nível/são exatamente iguais, portanto, antes de processar a integração farei a amarração destes dados.
Acessando a rotina De x Para de Departamentos, clique em Incluir para iniciar o vínculo entre os dados.
Insira o código e descrição como preferir, e clique em Outras Ações - Vincular Departamentos. Selecione os Departamentos que são equivalentes e clique em Salvar.
Após isso, será demonstrada na parte inferior os Departamentos vinculados a este cadastro de De x Para, e você pode vincular quantos departamentos forem necessários. Finalizando a seleção, basta clicar em Confirmar.
Com isso, teremos nosso cadastro de De x Para do Departamento 'Suporte' criado e pronto para ser integrado.
OBS: o De x Para de Cargos e Departamentos só é obrigatório se as tabelas SQ3 ou SQB tiverem algum nível de exclusividade. Caso alguma tabela totalmente Compartilhada, não é necessário nenhum tipo de cadastro de De x Para, por exemplo: se a SQ3 for CCC e a SQB for EEE, não é necessário o De x Para de Cargos, apenas o de Departamentos. |
Agora estamos prontos para iniciar nossas integrações \õ/
Para isso, vamos acessar a rotina Integração - Avançar até o passo 2 - Configuração.
Nos parâmetros, teremos:
→ Verificação registro ativo: caso NÃO queira integrar demitidos, selecione a opção 'Somente pelo campo MSBLQL (se houver)'. Se quiser integrar demitidos, selecione então a opção 'Campo MSBLQL (se houver) + vínculo com registro ativo da SRA', com isso, será habilitada a pergunta 'Data de corte demissão'. As demissões anteriores à data informada nesta pergunta não serão integradas para a Feedz.
→ Verificação retorno da integração: caso queira visualizar o log de integração em tela, selecione a opção 'Aguardar o retorno da integração', com isso, será habilitada a pergunta 'Tempo limite (em minutos)'. Nela devemos informar o tempo que queremos aguardar para que seja gerado o log em tela. Caso NÃO queira aguardar o retorno da integração e consultar os dados enviados posteriormente na rotina de Consulta, basta deixar selecionada a opção 'Não aguardar o retorno da integração'.
Avançando para o passo 3 - Opções, teremos a listagem dos dados que podemos integrar para a Feedz.
É 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 Líderes.
Inicialmente, podemos selecionar as opções Filiais, Cargos, Departamentos e Grupos de Contrato e Avançar.
No passo 4 - Filtro, devemos minimamente fazer o filtro de Filiais para conseguir avançar.
Por fim, no passo 5 - Processamento, efetue a integração com a Feedz.
Ao finalizar a integração, será gerado o Log de Ocorrências em tela, onde é possível consultar quais filtros foram utilizados e se os dados foram integrados corretamente ou não.
Se todos os itens listados anteriormente foram integrados com sucesso, na sequência você pode integrar os Funcionários.
Para isso, retorne na rotina de Integração, no passo 3 - Opções, selecione 'Funcionários', no passo 4 - Filtro, selecione a Filial que o funcionário pertence e a matrícula se necessário (caso não seja uma integração geral da Filial) e conclua a integração. Se o cadastro do Funcionário tiver todos os dados necessários, no Log de Ocorrências será possível verificar a integração concluída com sucesso.
OBS: caso a tabela SQ3 ou SQB sejam totalmente compartilhadas, na rotina de Integração - passo 2 - Configuração, será demonstrada a pergunta 'Descrição Cargo/Departamento' com duas opções:
→ Somente Descrição: será integrada apenas a descrição do cadastro, por exemplo: Analista de RH (Cargo) ou Recursos Humanos (Departamento).
→ Descrição + Código: será integrado o código + descrição do cadastro, por exemplo: 01 - Analista de RH (Cargo) ou 00000001 - Recursos Humanos (Departamento).
OBS2: caso o cliente utilize o App MEU RH ou Portal GCH e tenha cadastro de Hierarquias, na rotina de Integração - passo 2 - Configuração, será demonstrada a pergunta 'Código da Visão', onde deverá ser selecionada qual cadastro de Visão existente no módulo 70 - Arquitetura Organizacional, será utilizado. |
A rotina de Consulta das Integrações é extremamente necessária quando:
- o cliente utiliza Schedule para integração diária dos dados entre Protheus x Feedz
- para integrações manuais de registros que ainda estão com status 'Pendente', devido o Schedule ainda não ter sido executado, através da opção 'Consultar Status'
- quando não é esperado o retorno da integração com o Log de Ocorrências em tela.
Para consultar uma integração feita, selecione o registro e clique em Visualizar, com isso, será possível ver detalhadamente qual dado foi integrado, o status, dia/hora da integração e retorno da API.
No grid da rotina, os registros são classificados em cores diferentes, e para entender o que cada cor significa, você pode consultar a Legenda. |
A utilização de Schedule na integração entre Protheus x Feedz é completamente opcional, ficando a critério do cliente utilizar ou não.
Para utilização, será necessário cadastro do agendamento do job GPEM939C para atualização do status da integração dos dados e do job GPEM939D para integração automática dos dados.
Para cadastrar o Schedule, será necessário acessar o Configurador - Ambiente - Schedule - Schedule.
Devemos inicialmente cadastrar um Agent na opção de mesmo nome, levando em consideração:
• IP = como faremos apenas testes em ambiente interno, podemos informar localhost
• Porta = se trata da nossa porta TCP, contida no arquivo appserver.ini do nosso ambiente
Após o cadastro, nosso Agent deve ficar com status Habilitado para o correto funcionamento.
OBS: cadastre o Agent vinculado ao Grupo de Empresas em que a integração foi toda configurada.
Na sequência, vamos cadastrar nossos jobs através da opção Agendamentos - Cadastro.
Faça a inclusão de um novo registro para a rotina GPEM939C vinculado à Empresa/Filiais necessárias, bem como as recorrências (de quanto em quanto tempo o job será executado) e salve.
Por fim, faça uma inclusão para a rotina GPEM939D vinculada à Empresa/Filiais necessárias, bem como os parâmetros e recorrências, e salve. |
|
|
