Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

    • 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 obrigatórias:
      • 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, se houver um relacionamento com participante na tabela RDZ e caso tenha enviado previamente o cadastro das filiais, cargos, departamentos e grupos de contrato.
    • 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 cargos ou departamentos serem de modo exclusivo, será necessário realizar um cadastro de De x Para através das rotinas 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.
    • Na integração de líder dos funcionários, somente será enviado o líder caso ele esteja como matricula responsável de outro departamento, ou seja, diferente do que esta alocado


Nota
titleObservação técnica

As informações enviadas para a Feedz são geradas conforme o detalhamento abaixo:

Deck of Cards
startHiddenfalse
idjsons
Card
defaulttrue
idfiliais
labelFiliais
titleFiliais

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.

Card
idcargos
labelCargos
titleCargos

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+Q3_CC(Caso exista),

"name": Q3_DESCSUM, ou Q3_DESCSUM+M0_CODIGO+Q3_FILIAL+Q3_CARGO+Q3_CC(Caso exista), caso configurada opção de envio de descrição + código.

"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
iddepartamentos
labelDepartamentos
titleDepartamentos

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, ou Q3_DESCSUM+M0_CODIGO+QB_FILIAL+QB_DEPTO, caso configurada opção de envio de descrição + código.


  • 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
idcontratos
labelGrupos de contrato
titleGrupos 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
idfuncionarios
labelFuncionários
titleFuncioná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.

"registration": RA_MAT

"cpf": RA_CIC


Card
idlíder
labelLíder
titleLí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
titleObservaçã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/LYx9Hghttps://tdn.totvs.com/x/dfryHQ e https://tdn.totvs.com/pages/releaseview.action?pageId=500300689.

Na integração de líder dos funcionários, somente será enviado o líder caso ele esteja como matricula responsável de outro departamento, ou seja, diferente do que esta está alocado

Exemplo: 

Departamento: 000000001[Presidência]
Matriculas alocadas: 000001
Matricula responsável: 000001

Departamento: 000000002[Diretoria]
Matriculas alocadas: 000002
Matricula responsável: 000001

Departamento: 000000003[Tecnologia]
Matriculas alocadas: 000003
Matricula responsável: 000002

Nesse cenário hierárquico, para integrar o Líder de matricula 000001 que esta está alocado no departamento "Presidência" e responsável do departamento "Diretoria", no filtro de na integração com a Feedz caso seja realizado o filtro por matricula, deve ser selecionado alguma matricula que esta está alocada no departamento "Diretoria" , onde a matricula 000001 é responsável responsável e este que será enviado para Feedz como Líder na tag managerIntegrationId, o funcionário selecionado será enviado na tag personIntegrationId.





As opções de integração irão consumir as seguintes APIs da Feedz:

OpçãoAPI Feedz
Filiais

/api/v1/auxiliary-records/facilities

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:

CampoConteúdo
REF_FILIAL

Sempre em branco

REF_PRCID

Process ID do lote retornado pela Feedz

REF_TIPO

Tipo da API:

1=Filiais

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_RETORNRetorno do processamento realizado pela Feedz
REF_USERCódigo do usuário responsável pela integração
REF_TPINT2=Feedz

...