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


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.


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).
    • Importar dados dos Pagamentos do Extrato GetNet
  • 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. 

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: 

  1. Serão buscados todos os pedidos realizados no VTEX e disponíveis no feed. Uma vez importado para o conciliador, o pedido não será alterado. Portanto, caso ocorra atualização de status (cancelado, por exemplo), o status do pedido não será atualizado no Conciliador.
  2. Cada pedido do VTEX pode ser composto por mais de um item (Curso). No extrato da GetNet, recebemos uma transação única referente ao pedido. Portanto, no contexto do conciliador, precisamos somar os valores dos itens do pedido VTEX para comparar com o valor do pedido/transação no extrato GetNet. 
  3. No VTEX existem pedidos referentes à cursos gratuitos, que não geram dados financeiros e contrato. Estes pedidos não serão importados para o conciliador. Para identificá-los, iremos buscar apenas os pedidos com dados de pagamento preenchidos (paymentData).
  4. Não será gerado log detalhado do processo de importação. Ao finalizar a importação, será exibida na tela a informação do status da importação (sucesso ou erro) e mensagem de erro, caso ocorra. Caso o log detalhado seja necessário, deverá ser contratado escopo adicional para tratá-lo. 

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 

Ao acionar o processo de Importação de Dados, os dados das vendas realizadas através do Marketplace VTEX serão obtidos, com base no número do pedido VTEX, através de API disponibilizada pelo SENAI, para que seja possível vincular os títulos às transações do GetNet. Serão gravados no conciliador os dados de todos os títulos associados ao pedido para conferência.

Inserir Print

Para vendas realizadas pelo SENAI Nacional, a integração com o Protheus Nacional acontece assim:

  • É gerado um título a receber em nome do cliente/aluno, com status baixado no valor total da venda.
  • É gerado um título a receber no Protheus para cada parcela com a operadora de cartão em nome do cliente GetNet. Todos os títulos são gerados em aberto para serem baixados pelo processo de conciliação (que será detalhado neste escopo). 

Para vendas realizadas por algum Regional ou Parceiro, a integração com o Protheus Nacional acontece assim:

  • É gerado um título a receber em nome do cliente Regional ou Parceiro, com status baixado no valor total da comissão. 
  • É gerado um título a receber no Protheus para cada parcela com a operadora de cartão,  referente ao parcelamento da comissão, em nome do cliente GetNet. Todos os títulos são gerados em aberto para serem baixados pelo processo de conciliação (que será detalhado neste escopo). 


Para o sistema financeiro do Regional são gerados os títulos em nome da GETNET, já que o faturamento e NF são efetuadas pelo Regional. Este processo é de responsabilidade de cada Regional e não está contemplada a visualização e conciliação destes títulos no portal.


Conciliação Automática

Ao importar os títulos do Protheus, é necessário atualizar o status da conciliação entre GetNet e Protheus automaticamente, de acordo com o tipo de transação (crédito, cancelamento ou chargeback) e a comparação de dados, conforme descrito nos requisitos de transações / Conciliação.


Detalhamento do Processo

Todos os pagamentos efetuados pela GetNet, sejam referentes a transações de crédito ou transações de débito, como cancelamento e chargeback, são registrados no bloco de pagamentos do extrato GetNet e podem ser obtidos através da API GetNet de solicitação de extrato eletrônico (demonstrativo). O pagamento acontece 31 dias após a data da venda. 

O  menu ficará disponível dentro da opção Integrador,  GetNet Pagamentos, que será responsável por buscar no extrato os dados referentes aos pagamentos efetuados pela GetNet.


A cada execução, serão buscados todos os registros desde a última execução do processo até a data atual. Os pagamentos importados estarão vinculados aos títulos do Protheus já importados para o Portal Conciliador. 

Conciliação automática

Ao importar os pagamentos do extrato GetNet, eles serão automaticamente vinculados aos títulos do Protheus já importados para o portal conciliador (processo de Busca Dados Protheus - conciliação da transação). O status da conciliação será preenchido automaticamente, conforme descrito no Req.02 - Conciliação Automática deste documento. 

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: 

  • Data inicial da venda/transação
  • Data final da venda/transação
  • Número do Pedido
  • Tipo da transação - devolvido pelo GetNet: 1-Crédito à vista, 2-Crédito Parcelado Lojista, 3-Crédito Parcelamento Administradora, 5-Cancelamento e 6-Chargeback.
  • Status Transação: Aprovada ou Estornada.
  • Status GetNet x VTEX:  Lista com as opções Conciliado, Transação na GetNet sem Venda na VTEX, Venda autorizada na VTEX sem transação na GetNet, Número do NSU diferente, Quantidade de Parcelas diferente e Conferido manualmente.
  • Status GetNet x Protheus: Lista com as opções Conciliado, Valores brutos diferentes, Valor da taxa diferente, Quantidade de parcelas diferente, Número do NSU diferente, Ausência de títulos, Títulos Protheus sem Transação Aprovada, Títulos Protheus sem Venda na VTEX e Conferido manualmente.
  • Seller - Loja que originou a venda: Lista com os CNPJs dos Regionais.


Inserir print filtro

Nenhum filtro será obrigatório. Caso o usuário deseje informar apenas as datas ou apenas o número do pedido, serão exibidos todos os dados referentes à data e pedido selecionado.

Após seleção dos filtros, será exibida a lista de transações/pedidos conforme valores informados pelo usuário. A relação de informações será exibida nos blocos de informações (GetNet, VTEX, Protheus e Conciliação) conforme os seguintes tipos de transação:


Transações dos tipos Crédito à vista, Crédito Parcelado Lojista e Crédito Parcelamento Administradora

Será exibido as informações dos títulos/parcelas agrupadas por Pedido. Ao expandir, exibe as informações das caixinhas abaixo:

  • VTEX
  • GetNet
  • Protheus
  • Dados da Conciliação

2- Transações do tipo Cancelamento

Será exibido uma linha para cada parcela, todas associadas ao mesmo Pedido. Ao expandir, exibe as informações das caixinhas abaixo:

  • GetNet
  • Protheus
  • Dados da Conciliação

Inserir print

3- Transações do tipo Chargeback

Exibe uma linha para cada parcela, todas associadas ao mesmo pedido. Ao expandir, exibe as informações das caixinhas abaixo:

  • GetNet
  • Protheus
  • Dados da Conciliação


Inserir print

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. 

Detalhamento do Processo

A interface de  Valores diários, estará disponível no menu lateral no portal conciliador, para o usuário verificar as informações bancárias diariamente, referente os pagamentos do GetNet e informar os valores creditados na conta bancária manualmente. 

Ao acessar a interface, o usuário poderá visualizar a lista de registros por data e preencher os campos necessários. Será uma visão, que listará os seguintes campos:

  • Data: campo do tipo data não editável, preenchido automaticamente com a data do pagamento. 
  • Total Recebimentos: campo numérico não editável, preenchido automaticamente com o somatório dos pagamentos (crédito) obtidos no extrato de pagamentos da GetNet para o dia (importação realizada no Req.01.1). Serão considerados o valor total das vendas do SENAI DN e apenas o valor da comissão das vendas dos DRs e Parceiros. 
  • Total Descontos: campo numérico não editável, preenchido automaticamente com o valor total obtido no extrato de pagamentos (débito) referentes a cancelamento e chargeback da GetNet (importação realizada no Req.01.1). Serão considerados o valor total dos cancelamentos do SENAI DN e o apenas o valor da comissão dos cancelamentos dos DRs e Parceiros. 
  • Valor Banco: campo do tipo numérico para o usuário informar o valor que a GetNet depositou no banco naquela data. TOTVS avaliar  se da pra pegar do bloco payment_summaries": [{"type_register": 7, - bloco traz de todos os DRs. Buscar o valor da conta do DN (pegar pela conta ou CNPJ do cliente - banco 001, agência 3307-3, 59510 - somar tudo, pois é por bandeira). seguir regra padrão de arredondamento. 
  • Valor Diferença: campo numérico calculado automaticamente com a diferença positiva ou negativa entre o Valor do Banco e Valor GetNet (Valor Pagamentos - Valor Descontos)
  • Status processamento Baixa a pagar
  • Status processamento Baixa a receber

Detalhamento do Processo

A Interface de Recebimentos esta disponível no portal Conciliador através do menu lateral,  ao clicar neste menu será exibidos os dados do extrato GetNet referentes aos pagamentos efetuados para o SENAI, de forma resumida, com opção de expandir o registro para visualização dos detalhes importados do GetNet, Protheus e sua Conciliação. Cada pagamento precisa ter um título correspondente no Protheus. 

Para conciliação diária de recebimentos, é necessário verificar quais são os registros de pagamento obtidos no extrato GetNet, os registros referentes aos descontos realizados pela GetNet em decorrência de cancelamento ou chargeback e os títulos relacionados a todas essas transações/pagamentos (contas a pagar e receber). 


Ao acionar a interface de Conciliação de Recebimentos, será possível visualizar os dados dos pagamentos do extrato GetNet, crédito ou débito, obtidos através da API GetNet de solicitação de extrato eletrônico, e seus respectivos títulos gerados no Protheus, obtidos através das APIs Protheus (a pagar e a receber). As informações desta interface não serão agrupadas por Pedido, como acontece com a interface de Conciliação das Transações. Na tela inicial, será exibida uma linha para cada pagamento/título identificado.





Detalhamento do Processo

Enviar para o Protheus, através de API, a baixa dos títulos pagos ou descontados pela GetNet na data referenciada, já registrados nas interfaces de Recebimentos. Serão enviados todos os títulos associados aos Recebimentos: pagamentos do extrato GetNet a receber (crédito) ou a pagar (cancelamento e chargeback).

O menu Baixa de Títulos, estará disponível no portal conciliador, para o usuário enviar as baixas dos títulos diariamente para o Protheus e visualizar eventuais erros que possam ocorrer no processo.  

Ao acessar este menu, será exibida a interface com logs dos últimos processamentos feitos por data e tipo (pagar ou receber), com opção de reprocessamento em caso de erro, para execução manual. Serão exibidos os dados:

  • Data referência, 
  • Tipo: Pagar ou Receber,
  • Data e Hora da execução do Processo,
  • Status: Sucesso ou erro.