As informações enviadas para o P&M são geradas conforme o detalhamento abaixo: | WIZARD | | wizard1 | 1-Observações | Observações | | 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. |
Essa tela exibe um breve descritivo da rotina e contém um botão que direciona para esta documentação do TDN.  Image Removed | wizard2 | 2-Configuração | Configuração | Essa tela exibe duas perguntas para configuração da integração: - "Verificação registro ativo": essa opção tem o intuito de definir como o sistema efetuará a validação se determinado registro está ativo, uma vez que apenas registros ativos serão enviados ao Performance & Metas. Ao selecionar a opção "Somente pelo campo campo MSBLQL (se houver). caso o campo MSLBL exista na tabela, será considerado apenas os registros ativos; se for selecionado a opção "Campo MSBLQL (se houver) + vínculo com registro ativo da SRA", além da verificação do campo MSBLQL, para um registro ser considerado como ativo terá que ter vínculo com registros ativos da tabela SRA, ou seja, funcionários ativos ou que foram demitidos a partir de determinada data para frente, configurada na próxima pergunta;
- "Data de corte demissão": define a data de corte de demissão para que um funcionário seja considerado ativo ou não, ou seja, funcionário demitidos a partir da data configurada serão considerados ativos, enquanto que funcionários demitidos antes da data configurada não serão considerados como ativos.
 Image Removed
| Card |
|---|
| id | wizard3 |
|---|
| label | 3-Opções |
|---|
| title | Opções |
|---|
| Essa tela exibe a lista de opções existentes para integração com o Performance & Metas do tipo checkbox e deve ser selecionado as opções que serão integradas. Atualmente, há as seguintes opções para integração: - Filiais;
- Grupos de cargo;
- Cargos;
- Departamentos;
- Funcionários.
 Image Removed
| Card |
|---|
| id | wizard4 |
|---|
| label | 4-Filtro |
|---|
| title | Filtro |
|---|
| Essa tela exibe botões para a definição de filtros para a integração, separados pelos registros que podem ser integrados, ou seja, há um botão de filtro para filiais, outro botão para grupos de cargo, etc.. O botão de filtro de filiais sempre será exibido, independente se a opção de integração de filiais esteja ou não selecionada, pois o filtro de filial será utilizado para a integração de todas as opções. Já os outros botões serão desativados para clique caso a respectiva opção de integração não esteja selecionada. No filtro de filial, será exibido uma MarkBrowse para seleção de filiais, enquanto que nos demais filtros será possível definir um filtro sobre qualquer campo da respectiva tabela, conforme necessidade.  Image Removed
| Card |
|---|
| id | wizard5 |
|---|
| label | 5-Processamento |
|---|
| title | Processamento |
|---|
| Essa tela exibe um descritivo e um botão, que ao ser clicado iniciará a integração com o Performance & Metas.  Image Removed | 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 | 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.
| Informações |
|---|
| No Protheus não é tratado Níveis de Cargo, desta forma, não será possível realizar o controle desta informação. |
|
| 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 | mov_filiais |
|---|
| label | Movimentação de filiais |
|---|
| title | Movimentação de filiais |
|---|
| Será enviado informações a partir da tabela SRE, conforme filiais selecionadas no botão "Filtro de Filiais" e filtro realizado através do botão "Filtro de Movimentação de filiais". As seguintes informações serão enviadas:
"integrationId": M0_CODIGO+RE_FILIALP+RE_MATP+RE_DATA, "personIntegrationId": M0_CODIGO+RDZ_CODRD0, "facilityIntegrationId": M0_CODIGO+RE_FILIALP, "changeDate": RE_DATA.
| Informações |
|---|
| O histórico de movimentação de filiais será enviado ao P&M quando houver transferência de grupo de empresas e/ou de filial. |
|
| Card |
|---|
| id | mov_grupos |
|---|
| label | Movimentação de grupos de cargo |
|---|
| title | Movimentação de grupos de cargo |
|---|
| Será enviado informações a partir da tabela SR7, conforme filiais selecionadas no botão "Filtro de Filiais" e filtro realizado através do botão "Filtro de Movimentação de grupos de cargo". As seguintes informações serão enviadas:
"integrationId": M0_CODIGO+R7_FILIAL+R7_MAT+R7_DATA+R7_SEQ, "personIntegrationId": M0_CODIGO+RDZ_CODRD0, "positionGroupIntegrationId": M0_CODIGO+Q0_FILIAL+Q3_GRUPO, 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, "changeDate": R7_DATA.
| Informações |
|---|
| O histórico de movimentação de grupo de cargo será enviado ao P&M quando houver alteração de cargo e o novo cargo estiver vinculado a um grupo de cargo diferente do anterior. |
|
| Card |
|---|
| id | mov_cargos |
|---|
| label | Movimentação de cargos |
|---|
| title | Movimentação de cargos |
|---|
| Será enviado informações a partir da tabela SR7, conforme filiais selecionadas no botão "Filtro de Filiais" e filtro realizado através do botão "Filtro de Movimentação de cargos". As seguintes informações serão enviadas:
"integrationId": M0_CODIGO+R7_FILIAL+R7_MAT+R7_DATA+R7_SEQ, "personIntegrationId": M0_CODIGO+RDZ_CODRD0, "positionIntegrationId": M0_CODIGO+Q3_FILIAL+R7_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, "changeDate": R7_DATA.
| Informações |
|---|
| O histórico de movimentação de cargos será enviado ao P&M quando houver alteração de cargo. |
|
| Card |
|---|
| id | mov_departamentos |
|---|
| label | Movimentação de departamentos |
|---|
| title | Movimentação de departamentos |
|---|
| Será enviado informações a partir da tabela SRE, conforme filiais selecionadas no botão "Filtro de Filiais" e filtro realizado através do botão "Filtro de Movimentação de departamentos". As seguintes informações serão enviadas:
"integrationId": M0_CODIGO+RE_FILIALP+RE_MATP+RE_DATA, "personIntegrationId": M0_CODIGO+RDZ_CODRD0, "positionIntegrationId": M0_CODIGO+QB_FILIAL+RE_DEPTOP, 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, "changeDate": RE_DATA.
| Informações |
|---|
| O histórico de movimentação de departamentos será enviado ao P&M quando houver transferência de departamento. |
|
| Card |
|---|
| id | afastamentos |
|---|
| label | Afastamentos |
|---|
| title | Afastamentos |
|---|
| Será enviado informações a partir da tabela SR8, conforme filiais selecionadas no botão "Filtro de Filiais" e filtro realizado através do botão "Filtro de Afastamentos". As seguintes informações serão enviadas:
"integrationId": M0_CODIGO+R8_FILIAL+R8_MAT+R8_DATAINI, "personIntegrationId": M0_CODIGO+RDZ_CODRD0, "type": RCM_TIPOPM, "startDate": R8_DATAINI, "endDate": RE_DATAFIM. |
| Card |
|---|
| id | faltas |
|---|
| label | Faltas |
|---|
| title | Faltas |
|---|
| Será enviado informações a partir da tabela SRD, conforme filiais selecionadas no botão "Filtro de Filiais" e filtro realizado através do botão "Filtro de Faltas" para as verbas dos IDs de cálculo 0054, 0055, 0203, 0242 ou 0243. As seguintes informações serão enviadas:
"integrationId": M0_CODIGO+RD_FILIAL+RD_MAT+RD_DATARQ, "personIntegrationId": M0_CODIGO+RDZ_CODRD0, "year": RD_DATARQ, "month": RD_DATARQ, "daysNotWorked": RD_HORAS.
| Informações |
|---|
| As verbas do histórico que estejam em horas serão convertidas para dias conforme a configuração do campo RA_HRSDIA. A quantidade de faltas enviada ao P&M será a quantidade inteira. Por exemplo, se houver 5,5 dias de faltas, será integrado ao P&M 5 dias. |
|
| 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.
|
|
As opções de integração irão consumir as seguintes APIs do P&M: | Opção | API P&M |
|---|
| 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 | | Movimentação de filiais | /api/v1/facility-history | | Movimentação de grupos de cargo | /api/v1/position-group-history | | Movimentação de cargos | /api/v1/position-history | | Movimentação de departamentos | /api/v1/department-history | | Afastamentos | /api/v1/absences | | Faltas | /api/v1/days-not-worked | | Líder dos funcionários | /api/v1/persons/bind |
Após a geração e envio de um lote de registros para o P&M, 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 pelo P&M | | REF_TIPO | Tipo da API: 1=Filiais 2=Grupos de cargo 3=Cargos 4=Departamentos 5=Funcionários 6=Grupos de contrato 7=Movimentação de cargos 8=Movimentação de departamentos 9=Movimentação de filiais A=Movimentação de grupos de cargo B=Afastamentos C=Faltas 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 pelo P&M | | REF_USER | Código do usuário responsável pela integração |
|
