01. DADOS GERAIS
Produto: | TOTVS RH |
---|---|
Linha de Produto: | Linha Protheus |
Segmento: | RH |
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
Efetuado o desenvolvimento da integração com a Swile.
Observação
A melhoria depende da aplicação da atualização liberada no pacote de expedição do módulo RH a partir de 30/01/2023 e da execução do UPDDISTR com o dicionário diferencial para os releases iguais ou superiores a versão 12.1.33.
Clique aqui para exibir ou esconder o conteúdo.
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 | Exemplo de preenchimento |
---|---|---|---|
MV_APISWI1 | C | URL base do ambiente de integração com Swile. | https://prod.veedigital.com.br/FinancialBackend/rest |
MV_APISWI2 | C | Usuário do ambiente de integração com Swile | usuario |
MV_APISWI3 | C | Senha do ambiente de integração com Swile | senha |
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_DOM | X9_IDENT | X9_CDOM | X9_EXPDOM | X9_EXPCDOM | X9_LIGDOM | X9_LIGCDOM | X9_USEFIL |
---|---|---|---|---|---|---|---|
RUA | 001 | RUB | RUA_CODIGO | RUB_CODGRP | 1 | N | S |
Observação técnica
As informações enviadas para a Swile são geradas conforme o detalhamento abaixo:
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.
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:
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"
Será enviado informações a partir da tabela 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 da Swile:
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 |
04. DEMAIS INFORMAÇÕES
Atualizador de dicionário e base de dados - UPDDISTR.
Incluindo Campos Reservados (CFGX034 - SIGACFG).
05. ASSUNTOS RELACIONADOS
Não há.