Histórico da Página

...

02. SITUAÇÃO/REQUISITO

Criar uma rotina que fará a integração dos cadastros do Protheus com a Feedz e uma rotina que possibilite consultar as informações dos lotes de integrações com a Feedz.

03. SOLUÇÃO

...

...

FUNCIONALIDADE EM DESENVOLVIMENTO. NÃO ESTÁ LIBERADA.

Efetuado o desenvolvimento da integração com Feedz.

Aviso
title Observação
A melhoria depende da aplicação da atualização liberada no pacote de expedição do módulo RH a partir de XX09/XX06/2023 e da execução do UPDDISTR com o dicionário diferencial para os releases iguais ou superiores a versão 12.1.33033. Toggle Cloak id upddistr Clique aqui para exibir ou esconder o conteúdo. Cloak visible true id upddistr Foi efetuado a criação de campos no dicionário SX3 conforme estrutura abaixo: X3_ARQUIVO X3_ORDEM X3_CAMPO X3_TIPO X3_TAMANHO X3_TITULO X3_DESCRIC HELP REF 11 REF_SISTEMA C 1 Sistema Sistema Sistema Foi efetuado a criação de parâmetros no dicionário SX6, conforme estrutura abaixo: X6_VAR X6_TIPO X6_DESCRIC Exemplo de preenchimento MV_APIFEE1 C URL base do ambiente de integração com a Feedz Exemplo:https://integrations.feedz.com.br/protheus-feedz-etl/ MV_APIFEE2 C Token de autenticação para integração com a Feedz Observação O parâmetro MV_APIFEE1 precisa ser configurado conforme o formato de exemplo da tabela acima. As informações a serem preenchidas devem ser solicitada solicitadas ao responsável do contrato da Feedz.

Considerações importantes:

• • A integração com a Feedz é do tipo assíncrona, isto é, a Feedz fará o processamento das informações enviadas conforme a fila de processamento.
  • A integração somente envia informações da tabela do grupo de empresas em que o usuário está logado.
  • A Feedz exige que algumas informações sejam obrigatoriamente enviadas. Por esse motivo, para ser possível realizar a integração com a Feedz, é necessário que o cadastro grupos de cargo tenha sido realizado através da rotina TRMA030, uma vez que essa informação é obrigatória para a Feedz. Algumas outras informações também serão obrigatórias:
    • Um cargo somente será enviado se for preenchido o grupo no campo Q3_GRUPO e que esse grupo seja válido na tabela SQ0;Um funcionário somente será enviado se for preenchido o CPF no campo RA_CIC, e-mail no campo RA_EMAIL, se houver departamento preenchido no campo RA_DEPTO e que esse departamento seja válido na tabela SQB, se houver cargo preenchido no campo RA_CARGO e que esse cargo seja válido na tabela SQ3 e que o cargo tenha um grupo preenchido no campo Q3_GRUPO e que esse grupo seja válido na tabela SQ0 e que o funcionário tenha um relacionamento com participante na tabela RDZ.
      
  • A Feedz não permite que determinado cadastro tenha a mesma descrição de outro enviado anteriormente, mesmo possuindo códigos diferentes. Dessa forma, se os cadastros de grupos de cargo, cargos ou departamentos serem de modo exclusivo, será necessário realizar um cadastro de De x Para através das rotinas GPEA944A, GPEA944B ou GPEA944C.
  • Apenas o envio de funcionários irá validar a restrição de acesso por filiais.
  • Atente-se que o sistema não fará controle se determinado registro foi ou não integrado com sucesso na Feedz. Havendo necessidade de reenvio de informações para a Feedz por qualquer motivo, será efetuado envio dos registros de acordo com os filtros criados pelo usuário na rotina de integração, sendo possível reenviar todos os registros novamente ou apenas um ou alguns registros em específico.
  • Em caso do processamento das informações pela Feedz retornar erros de validação, atente-se que as mensagens apresentadas na integração são as retornadas pela Feedz.
  • As rotinas mencionadas devem ser incluídas manualmente no menu, caso não existam.

...

Nota
title Observação técnica
As informações enviadas para a Feedz são geradas conforme o detalhamento abaixo: Deck of Cards startHidden false id jsons Card default true id filiais label Filiais title Filiais Será enviado informações a partir da tabela SM0, conforme filiais selecionadas no botão "Filtro de Filiais". As seguintes informações serão enviadas: "integrationId": M0_CODIGO+M0_CODFIL, "name": M0_FILIAL. Será enviado informações a partir da tabela SQ0, conforme filiais selecionadas no botão "Filtro de Filiais" e filtro realizado através do botão "Filtro de Grupos de cargo". As seguintes informações serão enviadas: Se modo de acesso compartilhado, será enviado os dados abaixo: "integrationId": M0_CODIGO+Q0_FILIAL+Q0_GRUPO, "name": Q0_DESCRI. Se modo de acesso exclusivo, será enviado os dados abaixo (conforme cadastro do De X Para): "integrationId": M0_CODIGO+REN_FILIAL+REN_CODIGO, "name": REN_DESC. Card id grupos label Grupos de cargo title Grupos de cargo Card id cargos label Cargos title Cargos Será enviado informações a partir da tabela SQ3, conforme filiais selecionadas no botão "Filtro de Filiais" e filtro realizado através do botão "Filtro de Cargos". As seguintes informações serão enviadas: Se modo de acesso compartilhado, será enviado os dados abaixo: "integrationId": M0_CODIGO+Q3_FILIAL+Q3_CARGO, "name": Q3_DESCSUM, "positionGroupIntegrationId": M0_CODIGO+Q0_FILIAL+Q0_GRUPO. Se modo de acesso exclusivo, será enviado os dados abaixo (conforme cadastro do De X Para): "integrationId": M0_CODIGO+REN_FILIAL+REN_CODIGO, "name": REN_DESC. Card id departamentos label Departamentos title Departamentos Será enviado informações a partir da tabela SQB, conforme filiais selecionadas no botão "Filtro de Filiais" e filtro realizado através do botão "Filtro de Departamentos". As seguintes informações serão enviadas: Se modo de acesso compartilhado, será enviado os dados abaixo: "integrationId": M0_CODIGO+QB_FILIAL+QB_DEPTO, "name": QB_DESCRIC. Se modo de acesso exclusivo, será enviado os dados abaixo (conforme cadastro do De X Para): "integrationId": M0_CODIGO+REN_FILIAL+REN_CODIGO, "name": REN_DESC. Card id contratos label Grupos de contrato title Grupos de contrato Será enviado informações a partir da tabela SX5, da tabela genérica 1C. As seguintes informações serão enviadas: "integrationId": M0_CODIGO+X5_FILIAL+X5_CHAVE, "name": X5_DESCRI; Card id funcionarios label Funcionários title Funcionários Será enviado informações a partir da tabela SRA, conforme filiais selecionadas no botão "Filtro de Filiais" e filtro realizado através do botão "Filtro de Funcionários". As seguintes informações serão enviadas: "integrationId": M0_CODIGO+RDZ_CODRD0, "name": RA_NOMECMP ou RA_NOME, "socialName": RA_NSOCIAL, "email": RA_EMAIL, "admissionDate", RA_ADMISSA, "lastRaiseDate": R3_DATA, "birthDate": RA_NASC, "demissionDate": RA_DEMISSA, "experienceEndDate": RA_VCTEXP2 ou RA_VCTOEXP, "dismissalType": de acordo com o campo "Tipo P&M" da tabela S043; "hiringTypeIntegrationId": de acordo com o campo "Agrupador P&M" da tabela S049,  "departmentIntegrationId": M0_CODIGO+QB_FILIAL+QB_DEPTO, se tabela SQB em modo compartilhado, ou M0_CODIGO+REN_FILIAL+REN_CODIGO, se tabela SQB em modo exclusivo conforme cadastro do De x Para, "positionIntegrationId": M0_CODIGO+Q3_FILIAL+Q3_CARGO, se tabela SQ3 em modo compartilhado, ou M0_CODIGO+REN_FILIAL+REN_CODIGO, se tabela SQ3 em modo exclusivo conforme cadastro do De x Para, "facilityIntegrationId": M0_CODIGO+RA_FILIAL. Card id líder label Líder title Líder Será enviado informações a partir da tabela SRA, conforme filiais selecionadas no botão "Filtro de Filiais" e filtro realizado através do botão "Filtro de Funcionários". As seguintes informações serão enviadas: "personIntegrationId": M0_CODIGO+RDZ_CODRD0, "managerIntegrationId": M0_CODIGO+RDZ_CODRD0. Informações title Observação A estrutura hierárquica possui a mesma configuração que é utilizada no Portal de Gestão de Capital Humano e no Meu RH, através da configuração de departamentos, postos e visão. Para mais informações, consulte as documentações a seguir: https://tdn.totvs.com/x/LYx9Hg , https://tdn.totvs.com/x/dfryHQ e https://tdn.totvs.com/pages/releaseview.action?pageId=500300689. As opções de integração irão consumir as seguintes APIs da Feedz: Opção API Feedz Filiais /api/v1/auxiliary-records/facilities Grupos de cargo /api/v1/auxiliary-records/position-groups Cargos /api/v1/auxiliary-records/positions Departamentos /api/v1/auxiliary-records/departments Grupos de contrato /api/v1/auxiliary-records/hiring-types Funcionários /api/v2/persons Líder dos funcionários /api/v1/persons/bind Após a geração e envio de um lote de registros para a Feedz, será retornado para o Protheus um UUIID de identificação do lote de processamento e esse ID será salvo na tabela REF conforme exemplo abaixo: Campo Conteúdo REF_FILIAL Sempre em branco REF_PRCID Process ID do lote retornado pela Feedz REF_TIPO Tipo da API: 1=Filiais 2=Grupos de cargo 3=Cargos 4=Departamentos 5=Funcionários 6=Grupos de contrato D=Líder dos funcionários REF_DATINT Data da integração REF_HORINT Hora da integração REF_STATUS Status da integração: 0=Não iniciado 1=Executando 2=Concluído 3=Houve erro de validação X=Não encontrado REF_LOTE JSON do lote REF_RETORN Retorno do processamento realizado pela Feedz REF_USER Código do usuário responsável pela integração REF_SISTEMATPINT 2=Feedz

04. DEMAIS INFORMAÇÕES

Atualizador de dicionário e base de dados - UPDDISTR.

...