Árvore de páginas

Versões comparadas

Chave

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

01. DADOS GERAIS

Produto:

Solucoes_totvs_cross
SolucaoCrossTOTVS RH

Linha de Produto:

Linhas_totvs
SegmentoDistribuição
RegionConstrução Projetos
LinhaLinha Protheus

Segmento:

Segmentos_totvs
SegmentoRH

Módulo:SIGAGPE
Função:

GPEA012

GPEA140

GPEA950

GPEM940

GPEM940A

Ticket:


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

DRHCALCPRT-5186

DRHCALCPRT-5176

DRHCALCPRT-5726

DRHCALCPRT-5188

DRHCALCPRT-6262

DRHCALCPRT-6376

DRHCALCPRT-5175

DRHCALCPRT-6424

DRHCALCPRT-9198


02. SITUAÇÃO/REQUISITO

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

03. SOLUÇÃO

Aviso
titleAtenção

FUNCIONALIDADE EM DESENVOLVIMENTO. NÃO ESTÁ DISPONÍVEL PARA USO.

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 XXX);
    • Funcionários (tabela SRA);
    • Pedidos (tabela XXX).

A rotina é do tipo Wizard e possui cinco passos:

...

startHiddenfalse
idWIZARD

...

defaulttrue
idwizard1
label1-Observações
titleObservações

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

Image Removed

...

idwizard3
label3-Opções
titleOpçõ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. 

Image Removed

...

idwizard4
label4-Filtro
titleFiltro

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

Image Removed

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.

...

idwizard5
label5-Processamento
titleProcessamento

...

Efetuado o desenvolvimento da integração com a Swile.

...


Aviso
titleObservação

A melhoria depende da aplicação da atualização liberada no pacote de expedição do módulo RH a partir de DD30/MM01/2022 2023 e da execução do UPDDISTR com o dicionário diferencial para diferencial para os releases iguais ou superiores a versão 12.1.2733.


Toggle Cloak
idupddistr
Clique aqui para exibir ou esconder o conteúdo.

Cloak
visibletrue
idupddistr

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

INDICEORDEMCHAVESHOWPES
RUA1RUA_FILIAL+RUA_CODIGOS
RUA2RUA_FILIAL+RUA_SWILES
RUB1RUB_FILIAL+RUB_CODGRP+RUB_TPVALE+RUB_FILBEN+RUB_CODIGOS
RUC1RUC_FILIAL+DTOS(RUC_DATINT)+RUC_HORINTS


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

X2_CHAVEX2_NOMEX2_MODOX2_MODOUNX2_MODOEMP
RUAGrupo de Benefícios - SWILECEE
RUBBenefícios associados ao grupoCEE
RUCLote de integração SwileCCC


Foi efetuado a criação de campos no dicionário SX3 conforme estrutura abaixo:

X3_ARQUIVOX3_ORDEMX3_CAMPOX3_TIPOX3_TAMANHOX3_TITULOX3_DESCRICHELP
RFP13RFP_CODSWIC10Cd.Ben.SWILECód. Benef. SWILE

Código do Benefício na SWILE

RUA01RUA_FILIALC2FilialFilial

Filial do sistema

RUA02RUA_CODIGOC3Cód. GrupoCódigo do Grupo

Código do Grupo de Benefícios

RUA03RUA_DESCC40DescriçãoDescrição do Grupo

Descriçao do Grupo de Beneficios

RUA04RUA_SWILEC10Grupo SWILECód. Grupo no SWILE

Nome do Grupo de benefícios no SWILE

RUB01RUB_FILIALC2FilialFilial

Filial do sistema

RUB02RUB_CODGRPC3Cód.. Grupo Código do Grupo

Código do Grupo de Beneficio

RUB03RUB_FILBENC8Filial BenefFilial do Benefício

Filial dos Benefícios

RUB04RUB_TPVALEC1Tp. Benef.  Tipo de Benefício

Tipo de Benefício

RUB05RUB_CODIGOC3Cód. Benef. Código do Benefício

Informe o código do Benefício

RUB06RUB_DESCRIC40Descrição   Descriçao do Benefício

Descriçao do Benefício

RUB07RUB_VALORN12Valor       Valor do Benefício

Valor unitário do Benefício

RUC01RUC_FILIALC2FilialFilial

Filial do lote

RUC02RUC_TIPOC1Tipo APITipo API

Tipo da API

RUC03RUC_DATINTD8Data Integr.Data Integração

Data da integração

RUC04RUC_HORINTC8Hora Integr.Hora Integração

Hora da integração

RUC05RUC_STATUSC1StatusStatus Integração

Status da integração

RUC06RUC_LOTEM10LoteLote Integração

JSON do lote integrado

RUC07RUC_RETORNM10RetornoRetorno Swile

Retorno do lote pela Swile

RUC08RUC_USERC6UsuárioUsuá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_VARX6_TIPOX6_DESCRICExemplo de preenchimento
MV_APISW1APISWI1CURL base do ambiente de integração com Swile.https://prod.veedigital.com.br/FinancialBackend/rest
MV_APISW2APISWI2CUsuário do ambiente de integração com Swileusuario
MV_APISW3APISWI3CSenha do ambiente de integração com Swilesenha
Observação

As informações de acesso ao ambiente da Swile devem ser solicitadas ao responsável do contrato da Swile.


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

X9_DOMX9_IDENTX9_CDOMX9_EXPDOMX9_EXPCDOMX9_LIGDOMX9_LIGCDOMX9_CONDSQLX9_USEFIL

Considerações importantes:

...

USEFIL
RUA001RUBRUA_CODIGORUB_CODGRP1NS



Nota
titleObservação técnica

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


"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
idgrupos
labelGrupos de benefícios
titleGrupos de benefícios

Será enviado informações a partir da tabela XXX 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
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:


"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": [CNPJ  da filial do funcionpario] (Obs.: na fase 1 será enviado o valor fixo do CNPJ da filial do funcionário, portanto é necessário criar um grupo manualmente com esse nome 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"

Card
idpedidos
labelPedidos
titlepedidos

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:


"feeValue": sempre será enviado valor 0,

"payerDocument": [CNPJ da filial selecionada na parametrização],

"dtCredit": [data de crédito configurada na parametrização],

"dtDueDate": [data de vencimento configurada na parametrização],

"valueCredit": [somatória dos benefícios dos funcionários filtrados],

"idEmployee": [id do funcionário na Swile],

"flexibleAmount": sempre será enviado valor 0,

"code": [código do benefício na Swile],

"amount": R0_VALCAL.


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

OpçãoAPI P&M
Filiais

/private/corporate/branch/add

Grupos de cargo/private/workgroup/add
Funcionários/private/employee/add
Pedidos/private/order/create



04. DEMAIS INFORMAÇÕES

Atualizador de dicionário e base de dados - UPDDISTR.

Incluindo Campos Reservados (CFGX034 - SIGACFG).

Integração com a Swile.


05. ASSUNTOS RELACIONADOS

Não há.



Templatedocumentos

...