Histórico da Página

...

Produto:

Solucoes_totvs_cross

SolucaoCross	TOTVS RH

Linha de Produto:

Linhas_totvs

Segmento	Distribuição
Region	Construção Projetos
Linha	Linha Protheus

Segmento:

Segmentos_totvs

Segmento	RH

Módulo:

SIGAGPE

Função:

GPEM940

Ticket:

Requisito/Story/Issue (informe o requisito relacionado) :

DRHCALCPRT-5186

DRHCALCPRT-5176

DRHCALCPRT-5726

DRHCALCPRT-5188

DRHCALCPRT-6262

02. SITUAÇÃO/REQUISITO

Criar uma rotina que fará a integração de informações do Protheus com a Swile.

...

Foi efetuado a criação da rotina GPEA950 para efetuar o cadastro de grupos de benefícios no Protheus, com o código do grupo na Swile e o vínculo de benefícios de VA, VR e VT.

Aviso

title	Observação

Na Fase 1, o grupo de benefícios criado não será integrado com a Swile.

Dessa forma, antes de proceder com a integração de funcionários é necessário acessar o portal da Swile e criar manualmente um grupo de nome "PROTHEUS" (sem aspas) para cada CNPJ da empresa. Todos os funcionários serão vinculados ao grupo de nome "PROTHEUS" (sem aspas).

Foi efetuado a criação da rotina GPEM940 para efetuar a integração com a Swile dos itens abaixo:

- Filiais (tabela SM0);
- Grupos de benefícios (tabela RUA);
- Funcionários (tabela SRA);
- Pedidos (tabela XXXSR0).

A rotina é do tipo Wizard e possui cinco passos:

Na Fase 1, todos os funcionários serão integrados no grupo de nome "PROTHEUS" (sem aspas), portanto antes de efetuar a integração é necessário que seja criado manualmente esse grupo no portal da Swile.

Deck of Cards

startHidden	false
id	WIZARD

Card

default	true
id	wizard1
label	1-Observações
title	Observações

Essa tela exibe um breve descritivo da rotina e contém um botão que direciona para esta documentação do TDN.

Card

id	wizard3
label	3-Opções
title	Opções

Essa tela exibe a lista de opções existentes para integração com a Swile do tipo checkbox e deve ser selecionada as opções que serão integradas.

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 benefícios, 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 efetuar o filtro na 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.

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 a Swile.

Aviso

title	Importante

Foi efetuado a criação da rotina GPEM940A para permitir a visualização das informações dos lotes de integração com a Swile, bem como consultar o retorno efetuado pela API de integração da Swile.

A rotina irá exibir os registros da tabela RUC:

Ao posicionar em um registro e clicar no botão "Visualizar" será aberto as informações detalhadas do lote, como a informação que foi enviada para a Swile e a validação retornada pela API de integração da Swile:

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 DD/MM/2022 e da execução do UPDDISTR com o dicionário diferencial para os releases iguais ou superiores a versão 12.1.27.

Toggle Cloak

id	upddistr

Clique aqui para exibir ou esconder o conteúdo.

Cloak

visible	true
id	upddistr

Foi efetuado a criação de índices no dicionário SIX, conforme estrutura abaixo:

INDICE	ORDEM	CHAVE	SHOWPES
RUA	1	RUA_FILIAL+RUA_CODIGO	S
RUA	2	RUA_FILIAL+RUA_SWILE	S
RUB	1	RUB_FILIAL+RUB_CODGRP+RUB_TPVALE+RUB_FILBEN+RUB_CODIGO	S
RUC	1	RUC_FILIAL+DTOS(RUC_DATINT)+RUC_HORINT	S

Foi efetuado a criação de tabelas no dicionário SX2, conforme estrutura abaixo:

X2_CHAVE	X2_NOME	X2_MODO	X2_MODOUN	X2_MODOEMP
RUA	Grupo de Benefícios - SWILE	C	E	E
RUB	Benefícios associados ao grupo	C	E	E
RUC	Lote de integração Swile	C	C	C

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
RFP	13	RFP_CODSWI	C	10	Cd.Ben.SWILE	Cód. Benef. SWILE	Código do Benefício na SWILE
RUA	01	RUA_FILIAL	C	2	Filial	Filial	Filial do sistema
RUA	02	RUA_CODIGO	C	3	Cód. Grupo	Código do Grupo	Código do Grupo de Benefícios
RUA	03	RUA_DESC	C	40	Descrição	Descrição do Grupo	Descriçao do Grupo de Beneficios
RUA	04	RUA_SWILE	C	10	Grupo SWILE	Cód. Grupo no SWILE	Nome do Grupo de benefícios no SWILE
RUB	01	RUB_FILIAL	C	2	Filial	Filial	Filial do sistema
RUB	02	RUB_CODGRP	C	3	Cód.. Grupo	Código do Grupo	Código do Grupo de Beneficio
RUB	03	RUB_FILBEN	C	8	Filial Benef	Filial do Benefício	Filial dos Benefícios
RUB	04	RUB_TPVALE	C	1	Tp. Benef.	Tipo de Benefício	Tipo de Benefício
RUB	05	RUB_CODIGO	C	3	Cód. Benef.	Código do Benefício	Informe o código do Benefício
RUB	06	RUB_DESCRI	C	40	Descrição	Descriçao do Benefício	Descriçao do Benefício
RUB	07	RUB_VALOR	N	12	Valor	Valor do Benefício	Valor unitário do Benefício
RUC	01	RUC_FILIAL	C	2	Filial	Filial	Filial do lote
RUC	02	RUC_TIPO	C	1	Tipo API	Tipo API	Tipo da API
RUC	03	RUC_DATINT	D	8	Data Integr.	Data Integração	Data da integração
RUC	04	RUC_HORINT	C	8	Hora Integr.	Hora Integração	Hora da integração
RUC	05	RUC_STATUS	C	1	Status	Status Integração	Status da integração
RUC	06	RUC_LOTE	M	10	Lote	Lote Integração	JSON do lote integrado
RUC	07	RUC_RETORN	M	10	Retorno	Retorno Swile	Retorno do lote pela Swile
RUC	08	RUC_USER	C	6	Usuário	Usuário	Usuário responsável pela geração do lote

Foi efetuado a criação de parâmetros no dicionário SX6, conforme estrutura abaixo:

X6_VAR	X6_TIPO	X6_DESCRIC
MV_APISW1	C	URL base do ambiente de integração com Swile
MV_APISW2	C	Usuário do ambiente de integração com Swile
MV_APISW3	C	Senha do ambiente de integração com Swile

Foi efetuado a criação de relacionamentos no dicionário SX9, conforme estrutura abaixo:

X9_DOM	X9_IDENT	X9_CDOM	X9_EXPDOM	X9_EXPCDOM	X9_LIGDOM	X9_LIGCDOM	X9_CONDSQL	X9_USEFIL
RUA	001	RUB	RUA_CODIGO	RUB_CODGRP	1	N		S

...

Nota

title	Observação técnica

As informações enviadas para a Swile 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:

"name": M0_NOMECOM,

"document": M0_CGC,

"street": M0_ENDENT,

"number": M0_ENDENT,

"complement": M0_COMPENT,

"neighborhood": M0_BAIRENT,

"city": M0_CIDENT,

"state": M0_ESTENT,

"country": "Brasil",

"zipcCde": M0_CEPENT.

Card

id	grupos
label	Grupos de benefícios
title	Grupos de benefícios

Será enviado informações a partir da tabela RUA, conforme filiais selecionadas no botão "Filtro de Filiais" e filtro realizado através do botão "Filtro de Grupos de benefícios".

As seguintes informações serão enviadas:

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:

"name": RA_NOMECMP ou RA_NOME,
"document": RA_CIC,
"externalID": M0_CODIGO+RA_FILIAL+RA_MAT,
"phoneNumber": (+RA_DDDCELU+)+RA_NUMCELU,
"email": RA_EMAIL,
"workGroupName": "PROTHEUS" (Obs.: na fase 1 será enviado o valor fixo PROTHEUS, portanto é necessário criar um grupo manualmente com essa descrição no portal da Swile),
"corporateBranchDocument": M0_CGC,
"gender": se RA_SEXO igual a "M" será enviado "MALE, se RA_SEXO igual a "F" será enviado "FEMALE", caso contrário será enviado "UNDEFINED",
"birthDate": RA_NASC,
"status": se não estiver demitido ou se estiver demitido mas com data de demissão posterior à data atual será enviado "ACTIVE", caso contrário será enviado "INACTIVE",
"bankAccount": {
"bankCode": RA_BCDEPSA (três primeiros dígitos),
"agency": RA_BCDEPSA (a partir do quarto dígito até o fim), "accountNumber": RA_CTDEPSA
}

Card

id	pedidos
label	Pedidos
title	pedidos

Será enviado informações a partir da tabela XXX SR0, conforme filiais selecionadas no botão "Filtro de Filiais" e filtro realizado através do botão "Filtro de Pedidos".

As seguintes informações serão enviadas:

As opções de integração irão consumir as seguintes APIs do P&M:

Opção	API P&M
Filiais	/private/corporate/branch/add
Grupos de cargo	/private/workgroup/add
Funcionários	/private/employee/add
Pedidos	/private/order/create

...

Árvore de páginas

Versões comparadas

Versão antiga 6

Nova versão 7

Chave

02. SITUAÇÃO/REQUISITO