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.
O SENAI DN solicitou o desenvolvimento de um Portal Web, totalmente apartado do SGE, com a finalidade de realizar a conciliação de vendas realizadas no VTEX, integrando com GetNet e Protheus. |
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:
|
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: O usuário terá opção de realizar o logoff do portal, através de ícone no canto superior direito.
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.
|
Modelo de Solução
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. O processo de importação não será automatizado neste momento. Ele precisa ser disparado manualmente por algum usuário responsável (administrador financeiro) e não terá opção de informar o período que deseja consultar. Para isso o usuário devera acionar os seguintes processos: 1- Buscar dados das Transações GetNet (Extrato) Ao acionar o processo de Importação de Dados, os dados das transações realizadas e processadas pela GetNet serão obtidos através da API GetNet de solicitação de extrato eletrônico (demonstrativo), serão buscados todos os registros desde a última execução do processo até a data atual. Serão importadas transações de Crédito à vista, Crédito Parcelado Lojista, Crédito Parcelamento Administradora, Cancelamento e Chargeback com status igual a 0-Aprovado. Transações com status Não Aprovado ou outro status diferente de Aprovado não serão importadas para o Conciliador. Conciliação Automática Ao importar os dados do GetNet, os status da conciliação entre GetNet e VTEX e GetNet e Protheus deverão ser preenchidos automaticamente, de acordo com o tipo de transação (crédito, cancelamento e chargeback) e a conferência e comparação de dados, conforme descrito nos itens Conciliação dos sub-requisitos de Transações (crédito, cancelamento e chargeback). 2- Busca dados das vendas VTEX (Pedidos) Ao acionar o processo de Importação de Dados, os dados das vendas realizadas através do Marketplace VTEX serão obtidos, através da API VTEX, e gravados na tabela correspondente do Portal Conciliador. Serão buscados todos os pedidos disponíveis no feed de pedidos VTEX. Importante:
Conciliação Automática Ao importar os dados do VTEX, o status da conciliação entre GetNet e VTEX deverá ser preenchido automaticamente (transações de crédito) conforme conferência e comparação de dados, descrito no Req.02.1 - Transações dos tipos Crédito à vista, Crédito Parcelado Lojista e Crédito Parcelamento Administradora / Conciliação. 3- Buscar dados dos títulos no Protheus Em andamento |
Pré-requisitos Executar os processo de importação de dados (Integrador), para identificar se as vendas que aconteceram no VTEX tem registro de extrato relacionado no GetNet e vice-versa. Detalhamento do Processo A interface de conciliação VTEX x GetNet x Protheus poderá ser acionada através do menu lateral chamado Transação. Será exibida a lista de pedidos e suas informações (GetNet, VTEX e Protheus) e os status das conciliações dos dados. O usuário terá a opção de expandir os dados das vendas do VTEX, do extrato GetNet e dos títulos do Protheus, vinculadas através do número do pedido e seus respectivos status de Conciliação. Ao acessar este menu, será exibida interface com opções de filtros disponíveis para exibição dos registros, que serão:
Inserir print filtro
|
Pré-requisitos Este botão ficará habilitado para usuário, apenas quando a transação selecionada estiver com status GetNet x VTEX ou GetNet x Protheus diferente de Conciliado (21) ou igual a Conferido Manualmente, caso um dos dois ou os dois estejam com valores diferentes será exibido a caixa com o campo observação e o botão salvar. Detalhamento do Processo O menu Conferir Manualmente está disponível na interface de Conciliação de Transação no portal Conciliador e o usuário poderá alterar o status da conciliação manualmente (GetNet x VTEX e GetNet x Protheus), nos casos em que as transações não tenha sido conciliadas automaticamente, pelo conciliador genérico. Ao clicar neste menu, a customização irá habilitar uma caixa de texto para o usuário preencher alguma observação na transação e salvar. Neste momento, os status da conciliação (GetNet x VTEX e/ou GetNet x Protheus) serão alterados para Conferido Manualmente e ficarão visíveis na página inicial da transação. Através desta mesma interface será possível visualizar as observações já preenchidas. |