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.2205.130
ou superiores.

02. VISÃO GERAL

Ter de forma nativa no produto a possibilidade de carga e integração dos dados pessoais dos funcionários para nossa solução Performance &

...

Metas (P&M). Assim, o sincronismo dos funcionários será de forma automatizada e irá otimizar o esforço que antes era necessário para sequência do processo de avaliação, PDI e demais rotinas dentro no P&M.

03. EXEMPLO DE UTILIZAÇÃO

Será possível realizar a carga e integração de forma online dos dados contratuais e movimentações dos funcionários que estão no ERP e que são necessárias para a apuração do pagamento de PLR.

04. PARAMETRIZAÇÃO

Deck of Cards

id	1

Card

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

Acesse o menu Serviços Globais | Segurança | PerfisSelecione 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 Performace e Metas- Integração Performance e Metas / Feedz

Image Added

Image Added

Mais informações acesse: Chaves de IntegraçãoImage Removed

Card

default	true
id	2
label	Perfomance e Performance & Metas
title	Perfomance e Metas

Acessando Administração de Pessoal / | Integração Perfomance e Metas Performance e Metas / Feedz, podemos fazer a integração filtrando por funcionário ou , por periodo período de admissão .ou por período dos históricos selecionados, conforme tela abaixo:

Image AddedImage Removed

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

Image Modified

AtençãoATENÇÃO:

Não é permitido a mesma descrição de seção, mesmo que o código seja diferente. Regra estabelecida pela P&M.
Multiplos VinculosMúltiplos Vínculos: a P&M permite apenas um cadastro por pessoa, sendo assim, ao integrar mais de um funcionário com o mesmo código de pessoa, o P&M irá sobrepor e prevalecerá o ultimo cadastro integrado para o mesmo código de pessoa. No RM , sendo que, na Folha de Pagamento a ordem de envio é a data de admissão para o mesmo código pessoa, se e caso a data de admissao for admissão seja igual, vai depender qual o banco irá mandar por ultimodependerá da ordem do banco de dados.

Maiores informações acessar o link abaixo: https://tdn.totvs.com/pages/viewpage.action?pageId=676047532 Mais informações acesse: Integração de cadastros básicos de pessoas

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

Disponível nas versões

integrationId

Identificador único de integração do objeto no sistema de origem com o P&M

PFUNC.CODCOLIGADA

A partir da versão 1

name

Nome

PPESSOA.NOME

A partir da versão 1


socialName	Nome de preferência (apelido)	PPESSOA.NOMESOCIAL

A partir da versão 1


email	Email	PPESSOA.EMAIL

A partir da versão 1


admissionDate	Data de admissão	PFUNC.DATAADMISSAO

A partir da versão 1

lastRaiseDate

Data de último aumento

PFHSTSAL.DATAMUDANCA

A partir da versão 1

birthDate

Data de aniversário

PPESSOA.DTNASCIMENTO

A partir da versão 1

demissionDate

Data de demissão

PFUNC.DATADEMISSAO

A partir da versão 2

experienceEndDate

Data do fim do período de experiência

PFUNC.FIMPRAZOCONTR

A partir da versão 2

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 caua,

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

A partir da versão 2

hiringTypeIntegrationId

Identificador único de integração do regime de contratação

A partir da versão 2

PFUNC.CODTIPO
departmentIntegrationId	Identificador único de integração da área da pessoa	PFUNC.CODSECAO

A partir da versão 1


positionIntegrationId	Identificador único de integração do cargo da pessoa	PFUNC.CODFUNCAO

A partir da versão 1A partir da versão 1

positionLevelIntegrationId

Identificador único de integração do nível cargo da pessoa

PFUNCAO.CARGO

PFUNC.CODNIVELSAL
facilityIntegrationId	Identificador único de integração da unidade da pessoa

A partir da versão 1

PFUNC.CODFILIAL
managerIntegrationId	Identificador único de integração do líder imediato da pessoa

A partir da versão 1

Código da Pessoa do chefe imediato, verificando a estrutura de Chefe/Supervisor
ou Hierarquia por Posição (quando ativada).

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

Disponível nas versões


integrationId	Identificador único de integração do objeto no sistema de origem com o P&M	PFUNCAO.CODIGO

A partir da versão 1

name

Nome

PFUNCAO.NOME

A partir da versão 1

positionGroupIntegrationId

Identificador único de integração do grupo de cargo do cargo

PFUNCAO.

CODCOLIGADAA partir da versão 1

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 NÍVEIS DE CARGOS

Campo	Descrição	Campo RM

Disponível nas versões

integrationId

Identificador único de integração do objeto no sistema de origem com o P&M

VNIVELFUNCAO.CODNIVEL

A partir da versão 1


name	Nome	VNIVELFUNCAO.NOMENIVEL

A partir da versão 1

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 GRUPOS DE CARGOS

Campo	Descrição	Campo RM

Disponível nas versões

integrationId

Identificador único de integração do objeto no sistema de origem com o P&M

VGRUPOOCUPACIONAL

PCARGO.

CODGRUPOOCUPA partir da versão 1

CODIGO
name	Nome

VGRUPOOCUPACIONAL

PCARGO.

NOMEGRUPOOCUPA partir da versão 1

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.4 - DADOS ENVIADOS NO ENDPOINT DE UNIDADES

Campo	Descrição	Campo RM

Disponível nas versões

integrationId

Identificador único de integração do objeto no sistema de origem com o P&M

GFILIAL.CODFILIAL

A partir da versão 1


name	Nome	GFILIAL.NOME

A partir da versão 1

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.5 - DADOS ENVIADOS NO ENDPOINT DE ÁREAS

Campo	Descrição	Campo RM

Disponível nas versões

integrationId

Identificador único de integração do objeto no sistema de origem com o P&M

PSECAO.CODIGO

A partir da versão 1


name	Nome	PSECAO.DESCRICAO

A partir da versão 1

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.6 - DADOS ENVIADOS NO ENDPOINT DE REGIMES DE CONTRATAÇÕES

Campo	Descrição	Campo RM

Disponível nas versões

integrationId

Identificador único de integração do objeto no sistema de origem com o P&M

A partir da versão 1

PTPFUNC.CODCLIENTE
name	Nome

A partir da versão 1

PTPFUNC.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

3 - HISTÓRICO DE REGISTROS AUXILIARES POR PESSOAS

3.1 - DADOS ENVIADOS NO ENDPOINT DE MOVIMENTAÇÃO DE PESSOAS PARA CARGOS

Campo	Descrição	Campo RM

Disponível nas versões


integrationId	Identificador único de integração do objeto no sistema de origem com o P&M	PFHSTFCO.CODCOLIGADA

A partir da versão 1


positionIntegrationId	Identificador único de integração do cargo da pessoa	PFHSTFCO.CODFUNCAO

A partir da versão 1


personIntegrationId	Identificador único de integração da pessoa	PFUNC.CODPESSOA

A partir da versão 1

changeDate

Data de alteração da pessoa para o cargo

PFHSTFCO.DTMUDANCA

A partir da versão 1

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

3.2 - DADOS ENVIADOS NO ENDPOINT DE MOVIMENTAÇÃO DE PESSOAS PARA NÍVEIS DE CARGOS

Campo	Descrição	Campo RM

Disponível nas versões


integrationId	Identificador único de integração do objeto no sistema de origem com o P&M	PFHSTFCO.CODCOLIGADA

A partir da versão 1

positionLevelIntegrationId

Identificador único de integração do nível de cargo da pessoa

PFHSTFCO.CODNIVEL

A partir da versão 1


personIntegrationId	Identificador único de integração da pessoa	PFUNC.CODPESSOA

A partir da versão 1


changeDate	Data de alteração da pessoa para o nível de cargo	PFHSTFCO.DTMUDANCA

A partir da versão 1

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

3.3 - DADOS ENVIADOS NO ENDPOINT DE MOVIMENTAÇÃO DE PESSOAS PARA GRUPOS DE CARGOS

Campo	Descrição	Campo RM

Disponível nas versões


integrationId	Identificador único de integração do objeto no sistema de origem com o P&M	PFHSTFCO.CODCOLIGADA

A partir da versão 1

positionGroupIntegrationId

Identificador único de integração do grupo de cargo da pessoa

VGRUPOOCUPACIONAL.CODGRUPOOCUP

A partir da versão 1

personIntegrationId

Identificador único de integração da pessoa

PFUNC.CODPESSOA

A partir da versão 1

changeDate

Data de alteração da pessoa para o grupo de cargo

PFHSTFCO.DTMUDANCA

A partir da versão 1

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

3.4 - DADOS ENVIADOS NO ENDPOINT DE MOVIMENTAÇÃO DE PESSOAS PARA UNIDADES

Campo	Descrição	Campo RM

Disponível nas versões


integrationId	Identificador único de integração do objeto no sistema de origem com o P&M	PFHSTSEC.CODCOLIGADA

A partir da versão 1


facilityIntegrationId	Identificador único de integração da unidade da pessoa	GFILIAL.CODFILIAL

A partir da versão 1

personIntegrationId

Identificador único de integração da pessoa

PFUNC.CODPESSOA

A partir da versão 1


changeDate	Data de alteração da pessoa para a unidade	PFHSTSEC.DTMUDANCA

A partir da versão 1

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

3.5 - DADOS ENVIADOS NO ENDPOINT DE MOVIMENTAÇÃO DE PESSOAS PARA ÁREAS

Campo	Descrição	Campo RM

Disponível nas versões

integrationId

Identificador único de integração do objeto no sistema de origem com o P&M

PFHSTSEC.CODCOLIGADA

A partir da versão 1

departmentIntegrationId

Identificador único de integração da área da pessoa

PFHSTSEC.CODSECAO

A partir da versão 1

personIntegrationId

Identificador único de integração da pessoa

PFUNC.CODPESSOA

A partir da versão 1


changeDate	Data de alteração da pessoa para a área	PFHSTSEC.DTMUDANCA

A partir da versão 1

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

4 - AFASTAMENTOS POR PESSOAS

4.1 - DADOS ENVIADOS NO ENDPOINT DE AFASTAMENTOS POR PESSOAS

Campo	Descrição	Campo RM

Disponível nas versões


integrationId	Identificador único de integração do objeto no sistema de origem com o P&M	PFHSTAFT.CODCOLIGADA

A partir da versão 1


personIntegrationId	Identificador único de integração da pessoa	PFUNC.CODPESSOA

A partir da versão 1

type

Tipo do afastamento, podendo ser:

Acidente de trabalho = 1
Doença ocupacional = 2
Doença = 3
Licença maternidade = 4
Licença paternidade = 5
Licença não remunerada = 6

DE/PARA:

Caso o tipo de afastamento seja T-Af.Ac.Trabalho, retorna Acidente de trabalho = 1.

Caso o tipo de afastamento seja O - Doença Ocupacional, retorna Doença ocupacional = 2.

Caso o tipo de afastamento seja P - Af.Previdência, retorna Doença = 3.

Caso o tipo de afastamento seja E - Licença Mater. ou W - Licença Mater. Compl. 180 dias, retorna Licença maternidade = 4.

Caso o tipo de afastamento seja Y - Licença Paternidade, retorna Licença paternidade = 5.

Caso o tipo de afastamento seja L - Licença s/venc, retorna Licença não remunerada = 6.

Valores diferentes dos citados acima, retorna tipoAfastamento = 0.

PFHSTAFT.TIPO

A partir da versão 1


startDate	Data de início do afastamento	PFHSTAFT.DTINICIO

A partir da versão 1

endDate

Data de término do afastamento

PFHSTAFT.DTFINAL

A partir da versão 1

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

5 - FALTAS POR PESSOAS

5.1 - DADOS ENVIADOS NO ENDPOINT DE FALTAS POR PESSOAS

Campo	Descrição	Campo RM

Disponível nas versões

integrationId

Identificador único de integração do objeto no sistema de origem com o P&M

A partir da versão 1

PFHSTFALTA. CODCOLIGADA
personIntegrationId	Identificador único de integração da pessoa

A partir da versão 1

PFUNC.CODPESSOA
year	Ano de ocorrência da falta

A partir da versão 1

PFHSTFALTA.ANOCOMPFALTA
month	Mês de ocorrência da falta

A partir da versão 1

PFHSTFALTA.MESCOMPFALTA
daysNotWorked	Total de dias não trabalhados para o ano e mês informados

A partir da versão 1

CALCULADO PELO SISTEMA

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

6 - CONSULTA A SITUAÇÃO DOS LOTES ENVIADOS

6.1 - DADOS ENVIADOS NO ENDPOINT DE LISTA DE PROCESSOS

Parâmetro

Descrição

orderCampo pelo qual o resultado será ordenadopageSizeQuantidade de registros que retornão por páginapageNúmero da página que deseja obter os dados

Retorno

Descrição

processId

Identificador do processo do lote

serviceNameNome do endpoint que iniciou o processostartDateData de início do processostopDateData de conclusão da execução do processostatusStatus da execução do processo (0 = Não iniciado, 1 = Executando, 2 = Concluído, 3 = Houve erro de validação)

6.2 - DADOS ENVIADOS NO ENDPOINT DE CONSULTA DE PROCESSO

Parâmetro

Descrição

processIdIdentificador do processo do lote retornado pelos endpoints de envio de dados

Retorno

Descrição

processIdIdentificador

do

processo do

lote

serviceNameNome do endpoint que iniciou o processostartDateData de início do processostopDateData de conclusão da execução do processostatusStatus da execução do processo (0 = Não iniciado, 1 = Executando, 2 = Concluído, 3 = Houve erro de validação) errorMessages.codeCódigo do erro de validação utilizado para obter mais detalhes na tabela de erros de validação deste documentoerrorMessages.integrationIdIdentificador de integração do registro que ocorreu o erro de validaçãoerrorMessages.messageO motivo pelo qual ocorreu o erro de validação

Atalhos

Páginas filhas

Versões comparadas

Versão antiga 8

Nova versão Atual

Chave

01. VERSÕES

02. VISÃO GERAL

03. EXEMPLO DE UTILIZAÇÃO

04. PARAMETRIZAÇÃO