01. DADOS GERAIS
Produto: | |
---|
Linha de Produto: | Linhas_totvs |
---|
Segmento | Distribuição |
---|
Region | Construção Projetos |
---|
Linha | Linha Protheus |
---|
|
|
---|
Segmento: | |
---|
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 |
---|
|
FUNCIONALIDADE EM DESENVOLVIMENTO. NÃO ESTÁ DISPONÍVEL PARA USO. |
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 |
---|
|
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) do CNPJ que estiver cadastrado. |
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 SR0).
A rotina é do tipo Wizard e possui cinco passos:
...
...
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.
Image Removed
...
id | wizard2 |
---|
label | 2-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.
Image Removed
...
id | wizard3 |
---|
label | 3-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..
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.
Efetuado o desenvolvimento da integração com a Swile.
...
id | wizard4 |
---|
label | 4-Processamento |
---|
title | Processamento |
---|
Essa tela exibe um descritivo e um botão, que ao ser clicado iniciará a integração com a Swile.
Image Removed
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:
Image Removed
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:
Image Removed
Aviso |
---|
|
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.
Clique aqui para exibir ou esconder o conteúdo. Cloak |
---|
| 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_APISW1APISWI1 | C | URL base do ambiente de integração com Swile. | https://prod.veedigital.com.br/FinancialBackend/rest | MV_APISW2APISWI2 | C | Usuário do ambiente de integração com Swile | usuario | MV_APISW3APISWI3 | C | Senha do ambiente de integração com Swile | senha | ObservaçãoAs 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 |
|
|
Considerações importantes:
...
Nota |
---|
|
As informações enviadas para a Swile são geradas conforme o detalhamento abaixo: Deck of Cards |
---|
| 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" [CNPJ da filial do funcionpario] (Obs.: na fase 1 será enviado o valor fixo PROTHEUSdo CNPJ da filial do funcionário, portanto é necessário criar um grupo manualmente com essa descrição 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 |
---|
id | pedidos |
---|
label | Pedidos |
---|
title | pedidos |
---|
| 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 |
|
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á.
...