Projeto: FS008780 - Conciliador Genérico

Nome do Cliente: Confederação Nacional da Indústria - SENAI

Objetivo

Este documento foi elaborado para informar aos usuários-chave da área Educacional do SENAI, a disponibilização de um Portal Web - Conciliador de Split de Pagamentos, que realiza a conciliação das vendas de cursos entre VTEX x GETNET x PROTHEUS E SGE.

Esse documento tem como base descrever a integração entre VTEX x GETNET x PROTHEUS, que visa conciliar as vendas feitas na VTEX, integrado ao Protheus do DN e a GTENET. 

Para isso, será apresentada uma visão prática da solução desenvolvida, explorando os conceitos utilizados e as funcionalidades do Sistema. O material descreve algumas etapas referentes como:

Público Alvo
Este manual é destinado aos colaboradores selecionados como usuários-chave do SENAI.

Metodologia

Este material tem como base a visão prática e completa da funcionalidade Customizada.



Pré-requisitos

Os anexos de retorno devem ser liberados nas permissões de perfil dos usuários para aparecerem nos seus respectivos lugares. Para mais detalhes de como liberar no perfil dos usuários acesse o Manual de Instalação de Customizações na seção Liberando Acesso aos Menus.


Detalhamento do Processo

Os parâmetros necessários para execução dos processos GetNet, VTEX serão informados no arquivo de configuração do Portal Conciliador (web.config). 

Deverão ser configurado os seguintes parâmetros: 


GetNet:
URL API - Solicitação de extrato
Token de acesso


VTEX:
URL API - Feed de Pedido
URL API - Consulta Pedido
Token de acesso


Protheus:
URL API - Busca Títulos
URL API - Baixa Títulos
URL API - Insere Títulos
Authorization
Ocp-Apim-Subscriotion-Key


Não será criada interface para preenchimento destes valores.

Pré-requisitos

A publicação deste portal pode ser feita através do Internet Information Services (IIS) Windows.


Detalhamento do Processo

O Portal Conciliador terá uma estrutura própria de login e layout. Os dados serão armazenados na nova base de dados criada. Os campos e filtros serão definidos no detalhamento de cada tela/página que compõem o portal.

A página inicial do portal irá trazer a lista de menus disponíveis na lateral esquerda, conforme modelo abaixo: 

Inserir print


O usuário terá opção de realizar o logoff do portal, através de ícone no canto superior direito. 


Não está prevista funcionalidade de logoff automático do usuário após um período de inatividade.


Autenticação dos usuários

A autenticação no portal será feita através do Azure do SENAI DN, ao acessar o endereço do Portal Conciliador, será exibida tela de login /autenticação do Azure, conforme exemplo abaixo:

Após login efetuado, o usuário será direcionado para o endereço inicial do Portal Conciliador, já autenticado.


Perfil / Grupos de usuários:

Todos os usuários com acesso ao Portal Conciliador terão acesso à todas as funcionalidades disponíveis. A restrição de acesso conforme o grupo será para visualização de dados pertinentes a cada Grupo/Regional. 

Ao logar no Portal Conciliador, ele identificará o grupo do usuário logado e permitirá a visualização apenas dos dados do Regional (grupo) do usuário. 

Caso um usuário esteja associado a mais de um grupo, ele terá permissão para visualizar os dados de todos os grupos associados. Usuários associados ao grupo SENAI DN não terão restrição de acesso à dados.


Inserir print


A utilização dos grupos do Azure se faz necessária neste momento devido ao curto prazo para desenvolvimento das funcionalidades do Conciliador e necessidade imediata de controle de acesso à dados por Regional. Com a evolução do Portal Conciliador, este recurso poderá ser migrado para dentro do portal (usuários e perfis), com novo esforço e custo necessário para adequação.

Modelo de Solução

  • Integrador
    • Importar dados do Extrato Getnet 
    • Importar dados dos Pedidos VTEX - resumo
    • Para cada pedido importado (GetNet/VTEX), importar dados dos títulos gerados no Protheus.
    • Vincular as informações GetNet, VTEX e Protheus e preencher o status da conciliação (GetNet x VTEX e GetNet x Protheus).
  • Transação
    • Interface para visualização das transações, exibindo as informações importadas da GetNet, VTEX e Protheus, por pedido/tipo de transação (Crédito, Cancelamento e Chargeback), com seus respectivos status de conciliação (DN).
    • GetNet: Exibir dados importados do extrato GetNet que são necessários para realizar a conciliação. 
    • VTEX: Exibir dados importados dos pedidos realizados no Marketplace que são necessários para realizar a conciliação. 
    • Protheus: Exibir dados importados dos títulos já gerados pela integração financeira entre VTEX e SGE, relacionados ao pedido.
    • Conciliação: Exibir resumo da conciliação realizada automaticamente, mostrando informações que são comparadas dos três sistemas e evidenciando as diferenças, caso existam. 
  • Conferir manualmente
    • Opção para o usuário marcar um registro como Conferido Manualmente e informar alguma observação pertinente. Utilizado apenas para os registros que não foram conciliados com sucesso automaticamente. 


Detalhamento do Processo

No menu do Portal Conciliador, será exibida uma opção chamada Integrador, que terá três submenus responsáveis por realizar a importação dos dados da VTEX, GetNet e Protheus, gravando o vínculo entre eles, quando identificado. Para isso, a importação precisará executar os seguintes passos :

  1. Buscar dados das vendas VTEX (Pedidos) 
  2. Buscar dados das Transações GetNet (Extrato)
  3. Buscar dados dos títulos no Protheus