Histórico da Página

Versões
Visão Geral
Exemplo de utilização
Tabelas utilizadas

01. VERSÕES

Informações

icon	false

A partir dos patches:

12.1.2310

ou superiores.

02. VISÃO GERAL

Ter uma funcionalidade nativa que automatize a carga e integração dos dados pessoais dos funcionários no sistema Feedz. Isso garantirá sincronização automática para processos como avaliação de desempenho e PDI, agilizando as operações e proporcionando maior integração entre os sistemas.

03. EXEMPLO DE UTILIZAÇÃO

Será possível realizar a carga e integração de forma online dos dados contratuais dos funcionários que estão no ERP para o sistema Feedz.

...

- Registros Auxiliares: Departamento, Cargo e Unidade
- Pessoas: Gestor direto e Colaborador
  - Nome
  - Nome Social
  - E-mail
  - Data de admissão
  - Nascimento
  - Data de demissão
  - Tipo/Motivo de demissão

OBSERVAÇÃO:

Para garantir o envio correto da tag <managerIntegrationId>, é fundamental que o chefe/supervisor associado à estrutura da seção tenha informações registradas na tabela PFUNC.

04. PARAMETRIZAÇÃO

Deck of Cards

id	1

Card

id	1
label	Parametrização
title	Parametrização

1) Acesse o menu Serviços Globais | Segurança | Perfis, selecione o sistema Folha de pagamento, edite o perfil desejado, vá em acesso aos menus e permita o acesso 01.05.01 - Integração Performance e Metas / Feedz:

Image Added

Utiliza token por filial: Com esse parâmetro será possível fazer com que o RM transmita as informações de funcionário conforme sua filial cadastrada para o ambiente vinculado da feedz correspondente (conforme Token indicado), marcando o parâmetro, o sistema irá habilitar a Aba Token X Filiais para possibilitar as vinculações.

Image AddedImage Removed

Concatenar Descrição do Cargo (Descrição + Código): Ao selecionar esse parâmetro, o sistema irá combinar a descrição da função com o seu código correspondente.

Por exemplo, se o código da função for "0001" e a descrição for "Gerente", após ativar esse parâmetro, o sistema enviará para a Feedz a informação "Gerente 0001".

Importante ressaltar que, caso o parâmetro não esteja marcado e houver Cargos com a mesma descrição, ocorrerá um erro na integração. Isso acontece devido à descrição ser um elemento-chave na Feedz.

Concatenar Descrição do Departamento (Descrição + Código): Ao selecionar esse paraâmetroparâmetro, o sistema incluirá tanto a descrição da seção quanto o seu código correspondente.

Por exemplo, se o código da seção for "01.01" e a descrição for "Administrativa", ao ativar esse parâmetro, o sistema enviará para a Feedz a informação "Administrativa 01.01".

Importante ressaltar que, caso o parâmetro não esteja marcado e houver Departamentos com a mesma descrição, ocorrerá um erro na integração. Isso acontece devido à descrição ser um elemento-chave na Feedz.

Mais informações acesse: https://ajuda.feedz.com.br/pt-BR/articles/8206093-como-integrar-o-protheus-com-a-feedz

Card

default	true
id	2
label	Feedz
title	Feedz

Concatenar Descrição da Unidade (Descrição + Código): Ao selecionar esse parâmetro, o sistema incluirá tanto a descrição (GFILIAL.NOME) da filial quanto o seu código correspondente.

Por exemplo, se o código da filial "1" e a descrição for "TOTVS - Filial Belo Horizonte", ao ativar esse parâmetro, o sistema enviará para a Feedz a informação "TOTVS - Filial Belo Horizonte1".

Importante ressaltar que, caso o parâmetro não esteja marcado e houver Filiais com a mesma descrição, ocorrerá um erro na integração. Isso acontece devido à descrição ser um elemento-chave na Feedz.

Nota

title	PONTOS IMPORTANTES DA INTEGRAÇÃO:

No campo de descrição, a presença de caracteres especiais [`, ', ", =, <, >] resultará em erro.
Sempre que o funcionário for enviado novamente, ele será substituído na FEEDZ.
Quando há mais de um chefe ou supervisor na mesma seção, é considerado o chefe com a menor chapa.
São considerados tanto o chefe quanto o supervisor. O supervisor é enviado apenas se não houver chefe na seção ou na hierarquia.

Mais informações acesse:

Ao acessar o menu Administração de Pessoal | Integração Performance e Metas / Feedz, você terá a possibilidade de realizar a integração de forma mais específica. Isso pode ser feito por meio da aplicação de filtros, onde poderá utilizar os parâmetros "Seleção de Funcionários" e/ou "Filtrar por Período de Admissão". Conforme apresentado na tela abaixo:

Image Removed

Nota

title	Importante!

Selecione somente coligadas parametrizadas para o envio Feedz. Mais detalhes na Aba Parametrização.

Após a execução será apresentado um log de erros ou de execução.

Image Removed

ATENÇÃO:

Caso haja a mesma descrição de seção, será necessário habilitar o parâmetro "Concatenar Descrição do Departamento (Descrição + Código)" (detalhes na aba 'Parametrização').

Sobre Múltiplos Vínculos: a plataforma Feedz permite apenas um registro por pessoa. Portanto, ao integrar vários funcionários com o mesmo código de pessoa ou e-mail, a Feedz sobrescreverá e adotará o último cadastro integrado para o mesmo código de pessoa ou e-mail. Sendo que na Folha de Pagamento, a ordem de envio é baseada na data de admissão para o mesmo código de pessoa. Se a data de admissão for igual, dependerá da ordem do banco de dados.

Na integração, o caractere de apóstrofo será removido do nome, uma vez que a plataforma Feedz não suporta esse caractere.

Mais informações acesse: https://ajuda.feedz.com.br/pt-BR/articles/8206093-como-integrar-sistemas-ode-gestao-protheusempresarial-com-a-feedz

Card

id	3
label	De/Para
title	De/Para

Card

id	3
label	De/Para
title	De/Para

1 - PESSOAS

1.1 - DADOS ENVIADOS NO ENDPOINT DE PESSOAS

Campo	Descrição	Campo RM
integrationId	Identificador único de integração do objeto no sistema de origem com o Feedz	PFUNC.CODPESSOA
name	Nome	PPESSOA.NOME
socialName	Nome de preferência	PPESSOA.NOMESOCIAL
email	Email	PPESSOA.EMAIL
admissionDate	Data de admissão	PFUNC.DATAADMISSAO
lastRaiseDate	Data de último aumento	PFHSTSAL.DATAMUDANCA
birthDate	Data de aniversário	PPESSOA.DTNASCIMENTO
demissionDate	Data de demissão	PFUNC.DATADEMISSAO
experienceEndDate	Data do fim do período de experiência	PFUNC.FIMPRAZOCONTR
dismissalType	Tipo de demissão: 1 - Pedido de desligamento 2 - Sem justa causa 3 - Com justa causa DE/PARA: Caso o tipo de demissão seja 3 - Inic.Empregado com justa causa ou 4 - Inic.Empregado sem justa causa, retorna 1 - Pedido de desligamento. Caso o tipo de demissão 2 - Inic.Empregador sem justa causa retorna 2 - Sem justa causa. Caso o tipo de demissão 1 - Inic.Empregador com justa causa, retorna 3 - Com justa causa. Valores diferentes dos citados acima, retorna 2 - Sem justa causa.	PFUNC.TIPODEMISSAO
hiringTypeIntegrationId	Identificador único de integração do regime de contratação	PFUNC.CODTIPO
departmentIntegrationId	Identificador único de integração da área da pessoa	PFUNC.CODSECAO
positionIntegrationId	Identificador único de integração do cargo da pessoa	PFUNC.CODFUNCAO
positionLevelIntegrationId	Identificador único de integração do nível cargo da pessoa	PFUNC.CODNIVELSAL
facilityIntegrationId	Identificador único de integração da unidade da pessoa	PFUNC.CODFILIAL
managerIntegrationId	Identificador único de integração do líder imediato da pessoa	Código da Pessoa do chefe imediato, verificando a estrutura de Chefe/Supervisor ou Hierarquia por Posição (quando ativada).
registration	Chapa do funcionário	PFUNC.CHAPA
cpf	CPF do funcionário	PPESSOA.CPF

Retorno

	Descrição
Valor string	O retorno é uma string que é o identificador do processo que será utilizado no endpoint de consulta para checar o status do processamento do lote

2 - REGISTROS AUXILIARES

2.1 - DADOS ENVIADOS NO ENDPOINT DE CARGOS

Campo	Descrição	Campo RM
integrationId	Identificador único de integração do objeto no sistema de origem com o Feedz	PFUNCAO.CODIGO
name	Nome	PFUNCAO.NOME
positionGroupIntegrationId	Identificador único de integração do grupo de cargo do cargo	PFUNCAO.CARGO

Retorno

	Descrição
Valor string	O retorno é uma string que é o identificador do processo que será utilizado no endpoint de consulta para checar o status do processamento do lote

2 - REGISTROS AUXILIARES

2.2 - DADOS ENVIADOS NO ENDPOINT DE UNIDADES

Campo	Descrição	Campo RM
integrationId	Identificador único de integração do objeto no sistema de origem com o Feedz	GFILIAL.CODFILIAL
name	Nome	GFILIAL.NOME

Retorno

	Descrição
Valor string	O retorno é uma string que é o identificador do processo que será utilizado no endpoint de consulta para checar o status do processamento do lote

2 - REGISTROS AUXILIARES

2.3 - DADOS ENVIADOS NO ENDPOINT DE DEPARTAMENTO

Campo	Descrição	Campo RM
integrationId	Identificador único de integração do objeto no sistema de origem com o P&M	PSECAO.CODIGO
name	Nome	PSECAO.DESCRICAO

Retorno

	Descrição
Valor string	O retorno é uma string que é o identificador do processo que será utilizado no endpoint de consulta para checar o status do processamento do lote

Card

id	4
label	Erros de validação e seus códigos
title	Erros de validação e seus códigos

Card

id	3
label	De/Para
title	De/Para

Lista de erros de validação e seus códigos

Alguns erros podem acontecer durante o processamento do lote enviado ou durante a validação dos itens do lote enviado, sendo eles:

Código	Mensagem	Detalhes
4998	Id do processo não encontrado	Significa que o processId informado na requisição de consulta de lotes está incorreto.
4999	Ocorreu um erro inesperado!	Representa erros genéricos ou inesperados que podem acontecer no servidor ou que podem ser gerados por algum aspecto incorreto não previsto do lote enviado.
5000	Token inválido ou expirado! / Bearer token não informado.	Isso indica que o token não foi informado na requisição ou informado não é válido. É necessário conferir se o token informado é igual à chave API na plataforma Feedz. Em caso afirmativo, é necessário gerar outra chave.
5000	Body vazio	Significa que foi enviada uma requisição para gravar um lote, mas sem nenhum dado.
5001	O total de itens enviados no corpo da requisição excede o limite de 100 registros. Todos os registros foram ignorados no processamento.	Ocorre ao enviar um lote com mais de 100 registros.
5003	A pessoa NPE (IntegrationId = IDN) está referenciando um gestor que não existe. Essa pessoa não será importada.	Esse erro ocorre ao tentar cadastrar um colaborador, vinculando a um gestor que ainda não foi cadastrado.
5004	A pessoa NPE (IntegrationId = IDN) está referenciando ela mesmo como chefe. Essa pessoa não será importada.	Esse erro ocorre ao tentar cadastrar um colaborador, vinculando ela mesma como gestora (integrationId = managerIntegrationId).
5005	A pessoa NPE (IntegrationId = IDN) está referenciando um departamento que não existe. Essa pessoa não será importada.	Esse erro ocorre ao tentar cadastrar um colaborador, vinculando a um departamento que ainda não foi cadastrado.
5006	A pessoa NPE (IntegrationId = IDN) está referenciando uma unidade que não existe. Essa pessoa não será importada.	Esse erro ocorre ao tentar cadastrar um colaborador, vinculando a uma unidade que ainda não foi cadastrada.
5008	A pessoa NPE (IntegrationId = IDN) está referenciando um cargo que não existe. Essa pessoa não será importada.	Esse erro ocorre ao tentar cadastrar um colaborador, vinculando a um cargo que ainda não foi cadastrado.
5009	O ID de integração (IntegrationId) é obrigatório e não foi informado para a Pessoa NPE. Essa pessoa não será importada.	Ocorre ao enviar uma pessoa e não informar se id de integração.
5011	O nome (Name) é obrigatório e não foi informado para a Pessoa (IntegrationId = IDN). Essa pessoa não será importada.	Ocorre ao enviar uma pessoa e não informar seu nome.
512	O e-mail (Email) é obrigatório e não foi informado para a Pessoa 'NPE' (IntegrationId = IDN). Essa pessoa não será importada.	Ocorre ao enviar uma pessoa e não informar seu e-mail.
5013	A pessoa 'NPE' (IntegrationId = IDN) possui o mesmo e-mail de outra pessoa da lista de pessoas enviadas ou da base. Essa pessoa não será importada.	Essa validação existe para evitar cadastrar pessoas duplicadas na base. Assim não é possível cadastrar dois e-mails iguais para integrationIds diferentes e vice versa.
5014	A pessoa 'NPE' (IntegrationId = IDN) deve ter o nome digitado somente com caracteres com nome, sobrenome e apenas 1(um) espaço entre eles.	Esse erro ocorre ao informar um nome inválido.
5015	A pessoa 'NPE' (IntegrationId = IDN) não pode ter o apelido igual ao nome.	Ocorre quando o name é igual ao socialName.
5016	O email fornecido 'EML' para a pessoa 'NPE' (IntegrationId = IDN) não está em um formato válido.	Ocorre ao enviar uma pessoa com o e-mail em formato inválido.
5017	O registro com o nome 'NRA' não foi salvo durante o processamento porque o campo 'IntegrationId' não foi informado."	Ocorre ao enviar qualquer registro auxiliar e não informar o integrationId.
5018	O registro com o código 'IDN' não foi salvo durante o processamento porque o campo 'Name' não foi informado.	Ocorre ao enviar qualquer registro auxiliar e não informar o nome.
5030	Quando informado a data de demissão deve ser também informado o motivo (dismissalType).	Ocorre ao enviar data de demissão e não informar o motivo.
5031	Deve ser informado o motivo da demissão (dismissalType) apenas quando for informado a data de demissão.	Ocorre ao enviar motivo da demissão e não informar a data de demissão.
5032	A data de admissão não pode ser maior que a data de demissão.	Ocorre ao enviar uma data de admissão posterior à data de demissão.
5048	O ID de integração do líder (managerIntegrationId = MII) informado para a pessoa (personIntegrationId = IDN) não existe.	Ocorre ao tentar vincular pessoa e líder pela rota persons-bind e não ter esse líder cadastrado previamente na plataforma.
5049	O ID de integração da pessoa (personIntegrationId = IDN) informada não existe.	Ocorre ao tentar vincular pessoa e líder pela rota persons-bind e não ter esse colaborador cadastrado previamente na plataforma.
5050	Uma pessoa (personIntegrationId = IDN) não pode ser líder de sí próprio	Ocorre ao tentar vincular uma pessoa a ela mesma como líder (personIntegrationId = managerIntegrationId) através da rota persons-bind.

Card

default	true
id	4
label	Integração
title	Integração

Através do menu Administração de Pessoal | TOTVS RH Performance e Metas / Feedz, é possível realizar a integração dos dados dos funcionários de forma nativa no produto, utilizando os filtros disponíveis na tela.

Image Added

Na tela acima, é possível parametrizar para enviar os Funcionários e Cadastros Auxiliares ou realizar a Associação de Líderes. É obrigatório escolher uma das duas opções.

Ao selecionar Funcionários e Cadastros Auxiliares, o sistema gerará todos os funcionários de acordo com a parametrização de Quebra de Seção e Seleção de Funcionários. Além disso, serão gerados os cadastros de Função/Cargo, Filiais/Unidades e Seções/Departamentos que estão relacionados aos funcionários selecionados.

Ao selecionar a Associação de Líderes, o sistema associará automaticamente os chefes parametrizados nas seções do cadastro de Chefe/Supervisor aos subordinados alocados nessas mesmas seções.

OBSERVAÇÃO: Se houver mais de um chefe ou supervisor na mesma seção, o sistema considerará o chefe com a menor chapa.

Com o recurso de Agendamento de tarefas, você pode programar integrações de entidades para ocorrerem automaticamente, sem a necessidade de interação do usuário, tornando o processo mais dinâmico e produtivo. Isso funciona com o JobServer configurado para execução em modo 3 Camadas. Para mais informações sobre a configuração, clique aqui.

Image Added

ATENÇÃO: Para evitar impacto na performance, recomenda-se que o agendamento seja programado para, no máximo, duas vezes ao dia.

Atalhos

Páginas filhas

Versões comparadas

Versão antiga 17

Nova versão 67

Chave

01. VERSÕES

02. VISÃO GERAL

03. EXEMPLO DE UTILIZAÇÃO

04. PARAMETRIZAÇÃO