Páginas filhas
  • Manual Operacional da Customização- Integração Power BI

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

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:

da Integração do Report do Power BI com o Sistema de Gestão Educacional (SGE), que possibilita ao usuário acessar o dashboard da solução, por meio do SGE.

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

Acessar o ambiente de instalação do portal para acessar os parâmetros. Não existe interface no portal conciliador para informar os parâmetros.

Detalhamento do Processo

Os parâmetros necessários para execução dos processos devem ser informados no arquivo de configuração do conciliador appsettings.json, disponível no diretório de instalação (exemplo: c:\TOTVS\ApiConciliador). Segue a lista:

Expandir
titleSíntese

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.

Expandir
titleParâmetros da Customização
Expandir
titleVTEX

Parâmetros de Acesso:

  • ClearFeed: limpar o feed após leitura. Valor default: true.
  • NomeContaVTEX: nome da conta para acesso ao ambiente B2C, configurado para retornar os pedidos que precisam ser importados no conciliador (Feed exclusivo Conciliador).
  • AmbienteVTEX: Nome do ambiente B2C do VTEX do cliente.
  • APPKeyVTEX: Chave para acesso à API (B2C).
  • APPTokenVTEX: Token para acesso à API (B2C).
  • NomeContaVTEX2: nome da conta para acesso ao ambiente B2B, configurado para retornar os pedidos que precisam ser importados no conciliador (Feed exclusivo Conciliador).
  • AmbienteVTEX2: Nome do ambiente B2B do VTEX do cliente.
  • APPKeyVTEX2: Chave para acesso à API (B2B).
  • APPTokenVTEX2: Token para acesso à API (B2B).
Expandir
titleGetNet

Parâmetros de acesso:

  • URLServico: URL do serviço GetNet que devolve o extrato com os dados das transações e pagamentos. 
  • TokenUrlAuth: URL para obter o token de acesso.
  • TokenSeller_id: token do seller para acesso.
  • TokenUserName: token de usuário para acesso e autenticação. 
  • TokenPassWord: token para acesso. 
  • TokenScope: Fixo: "OOB"
  • TokenGrant_type: Fixo: "Client-Credentials"

Outros Parâmetros:

  • ValidPaymentTypes: Formas de pagamento que serão consideradas. O Conciliador está preparado para tratar as formas "Fluxo normal de pagamento" e "02". 
  • CnpjDNList: lista de CNPJs que correspondem ao DN.
  • CnpjNotImportAndShow: lista de CNPJs que aparecem no extrato, mas não são importadas para o Conciliador. 
Expandir
titleProtheus

Parâmetros de acesso:

  • URLServico: URL da API que retorna os títulos gerados no Protheus relacionados ao cliente GetNet. 
  • OCP_Apim_Subscription_key: Chave de acesso à API.
  • AuythUserName: usuário para autenticação e acesso.
  • AuthPassword: senha para autenticação e acesso.
  • UrlBaixaPagar: URL da API que efetua a baixa dos títulos a pagar no Protheus.
  • UrlBaixaReceber: URL da API que efetua a baixa dos títulos a receber no Protheus.

Outros parâmetros:

  • CodClienteGetNet: Código do cliente GetNet no Protheus utilizado para buscar os títulos relacionados.
  • Empresa: Código da Empresa no Protheus: '0001"
  • Filial: Código da Filial correspondente no Protheus: "03DN0001".
  • Seller:  Código identificador do Seller DN: "1".
  • FormaPgto: Forma de pagamento que será considerada no momento da baixa do Protheus: "CC" - Cartão de Crédito.
Aviso
titleImportante:

Não existe interface para preenchimento destes valores.

Expandir
titleAdicionar Grupos Novo DR ou Parceiro

Detalhamento do Processo

Por meio do arquivo appsettings.json, será possível adicionar grupos de novos regionais ou parceiros. 

Para incluir ou atualizar um Seller, será necessário utilizar o seguinte template base conforme exemplo abaixo, disponível em: c:\TOTVS\Conciliador\ConciliadorPortal

  {
      "cnpj": "", - Informa o CNPJ  do regional, somente números
      "nome": "", - Descrição do nome do regional
      "nomeReduzido": "", - Descrição do nome reduzido do regional
      "sellerId": "", - Identificador de Franquiado
      "groupId": "" – Codigo de agrupamento do regional
}

Após o usuário informar os valores para cada campo citado acima, será necessário incluir estas informações do template no arquivo appsettings.json dentro da lista de Sellers.

Image Removed

Expandir
titlePortal Web Conciliador - Estrutura e Layout padrão

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: 

Image Removed

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

Image Removed

Aviso
titleImportante:

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:

Image Removed

Image Removed

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.

Image Removed

Aviso
titleImportante:

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.

Expandir
titleProcesso de Importação de Dados (Menu Integrador)

Funcionalidades do menu Integrador

  • Importar dados do Extrato Getnet 
  • Importar dados dos Pedidos VTEX 
  • 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

Detalhamento do Processo

No menu do Portal Conciliador, será exibida uma opção chamada Integrador, que terá submenus responsáveis por realizar a importação dos dados da VTEX, GetNet, Protheus e Pagamentos, gravando o vínculo entre eles, quando identificado. 

Image Removed

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.  

Expandir
titleDados de Transações - GetNet, VTEX e Protheus

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.  

Image Removed

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.

Image Removed

Conciliação 

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.

Image Removed

Image Removed

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 

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 das - 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.

Image Removed

Image Removed

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). 
Aviso
titleObservação
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 

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.

Expandir
titleDados de Pagamentos - Extrato GetNet

Funcionalidade do menu GetNet Pagamentos

  • Interface para visualização dos pagamentos GetNet e seus títulos correspondentes no Protheus, por com seus respectivos status de conciliação e de baixa.

Pré-requisitos

Executar o processo de Importação de Dados - Pagamentos do Extrato GetNet, para a customização buscar todos os dados de pagamentos/recebimentos (débito e crédito) do extrato GetNet para serem exibidos na interface de pagamentos, que serão conciliados com os títulos correspondentes no Protheus.

Detalhamento do Processo

Ao executar o 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, serã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.

Image Removed

Image Removed

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 

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 em - Conciliação Automática deste documento. 

Total de Recebimentos e Valor Banco

Será gravado na interface de Valores Diários o total de recebimentos (somatório dos pagamentos - débito e crédito) e o valor total pago para o DN por dia, que será o somatório de todos os registros de pagamento (todas as bandeiras) daquela data. Devem ser considerados apenas os pagamentos realizados para o DN (filtrar pelo CNPJ do cliente 33.564.543/0001-90, seguindo regra padrão de arredondamento).

Para recebimentos/pagamentos de um regional ou parceiro (seller), o extrato traz os valores totais. No entanto, serão considerados apenas os valores referentes às comissões, já que esses valores serão repassados para a conta do DN e precisarão ser conferidos na interface de Valores Diários.

Expandir
titleAgendamento dos Processos de Importação de Dados
Expandir
titleAgendar - Processos

A interface de agendamento poderá ser acionada através do menu lateral chamado Agendamento de Processos.

Image Removed

Image Removed

Ao acesso o Menu e abrir a tela de configuração de agendamento, é necessário informar:

  • Selecione o tipo (processo): Seleção do processo que será agendado;

Hora da Execução (1ª execução): Onde o usuário informará a data e hora da primeira execução;

  • Executar em /  Às : Campos obrigatórios onde será informada a data e a hora da primeira execução. 
  • Repetir a execução: Neste item é possível definir a periodicidade que o processo será executado, podendo ser por dia, semana ou mês. Caso o usuário queira executar o processo apenas uma vez, terá a opção de não repetir o processo.

Agendamento em caso de erro:

  • Número de tentativas de execução em caso de erro: Campo onde o usuário definirá a quantidade de tentativas de execução do processo, caso seja apresentado algum erro.
  • Repetição a cada intervalo (em minutos): Neste item é possível definir a periodicidade que o sistema tentará executar o processo em caso de erros, respeitando o número de tentativas definido no campo anterior.

Image Removed

Após configuração do Agendamento será  exibida uma mensagem de confirmação, antes da execução do processo:

Image Removed

Se ocorrer alguma falha no processo de agendamento, uma mensagem de erro será exibida, conforme o exemplo abaixo:

Image Removed

Aviso

Se o tipo de processo selecionado já tiver um agendamento configurado, uma mensagem de confirmação será exibida ao usuário, sugerindo a possibilidade de sobrescrever as informações existentes.

Image Removed

Expandir
titleConsulta de agendamentos

Para consultar os agendamentos configurados é necessário acessar o menu: Agendamento de processo > Agendamentos:

Image Removed

Neste menu, você poderá consultar todos os agendamentos realizados.

Os agendamentos de cada processo serão organizados por fila, apresentando as seguintes informações nas colunas:

  • Processo: Nome do processo agendado.
  • Status: Indicação se o processo está agendado, com erro ou cancelado.
  • Tipo Recorrência: Informando se o agendamento será diário, semanal ou mensal.
  • Última execução: Data e hora da última execução do processo.
  • Próxima execução: Próxima data e hora em que o processo será executado.
  • Criado por: Responsável pelo agendamento do processo.

Image Removed

Expandindo a linha do agendamento, é possível visualizar os dados de cada processo, incluído a mensagem de  retorno de cada envio:

Image Removed

Dica

Para facilitar a visualização, o usuário poderá utilizar o Filtro (por status), localizado no canto superior direto da tela.

Image Removed

Expandir
titleCancelar agendamento

Para realizar um cancelamento, o usuário deve acessar o menu de agendamentos, selecionar o agendamento desejado e clicar no botão "Cancelar", conforme na imagem abaixo.

Image Removed

Será exibida uma mensagem de confirmação para validar o cancelamento.

Image Removed

Ao confirmar, o status, dados, hora e responsável pelo agendamento serão registrados.

Image Removed

Para reagendar o processo, é necessário realizar novamente o procedimento de agendamento.

Expandir
titleServiço de Execução de Processos Agendados

Foi disponibilizado o serviço Concliliador.Sevice nos Serviços do Windows para que seja realizada a execução dos Processos Agendados, o mesmo deverá estar sempre executando.

image.pngImage Removed

Expandir
titleConciliação da Transação

Funcionalidades do menu 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. 

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.

Image Removed

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.

Image Removed

Aviso
titleImportante:

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 abaixo.

Expandir
titleTransações de Crédito

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

Image Removed

Expandir
titleTransações de Cancelamento

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

Image Removed

Expandir
titleTransações de Chargeback

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
Expandir
titleProcesso para Conferir Manualmente - Transações

Funcionalidades do menu 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.
  • O 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 botão Conferir Manualmenteestá 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. 

Image Removed

Image Removed

Image Removed

 Através desta mesma interface será possível visualizar as observações já preenchidas. 

Expandir
titleRecebimentos (Pagamentos)

Funcionalidade do menu Recebimentos

  • Interface para visualização dos pagamentos GetNet e seus títulos correspondentes no Protheus, por com seus respectivos status de conciliação e de baixa.

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). 

Image Removed

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.

Ao acessar, será exibida interface com opções de filtros disponíveis para exibição dos registros, que serão: 

  • Data inicial - Pagamento
  • Data final - Pagamento
  • Número do Pedido
  • Status da Conciliação: Conciliado, Não Conciliado - Taxa divergente, Não Conciliado - Valor Bruto divergente ou Não Conciliado - Ausência de título no Protheus.
  • Status da baixa: Pendente, Título Baixado ou Erro na baixa. 
  • Seller - Loja que originou a venda: Lista com os CNPJs dos Regionais e Parceiros.

Image Removed

Ao expandir o registro, serão detalhadas as informações da GetNet e Protheus, além dos dados da Conciliação, conforme abaixo:

  • Dados do Pagamento (GetNet)
    • CPF/CNPJ Subseller (Parceiro ou DR)
    • Valor do Pagamento
    • Valor da Taxa por parcela
    • Data do Pagamento
    • Número de Parcela
    • Valor da comissão
  • Dados do Título (Protheus)
    • Número do Título no Protheus
    • Valor do Título
    • Valor da taxa
    • Nome do Cliente (recebimentos) ou Fornecedor (pagamentos)
    • Data de emissão
    • Data de vencimento

Image Removed

Expandir
titleConciliação Automática

Detalhamento do Processo

Ao importar os títulos do Protheus, o usuário deverá realizar a conferência dos dados de pagamentos GetNet e título Protheus e atualizar o status da conciliação automaticamente, de acordo com o tipo de transação (crédito, cancelamento ou chargeback). Todo título gerado no Protheus referente a um pedido no VTEX, precisa ter um registro de pagamento correspondente no extrato GetNet. Quando o pagamento é identificado, a baixa precisa ser enviada para o Protheus após fechamento dos valores de conciliação do dia.

Para vendas realizadas pelo SENAI Nacional, a integração financeira com o Protheus Nacional gera um título a receber para cada parcela com a operadora de cartão em nome do cliente GetNet, com seu respectivo valor de taxa (campo decréscimo - Protheus).

Para vendas realizadas por algum Regional ou Parceiro, a integração financeira com o Protheus Nacional gera um título a receber para cada parcela com a operadora de cartão, referente ao parcelamento da comissão, em nome do cliente GetNet, com  seu respectivo valor de taxa e com o código do regional registrado no campo código do cliente origem.

Para casos de Cancelamento de vendas pelo SENAI Nacional, a integração financeira com o Protheus Nacional envia para o Protheus os títulos a pagar para a GetNet, parcela por parcela. Para cancelamento de vendas de um Regional ou Parceiro, também são gerados os títulos a pagar, porém, com o valor de cada parcela referente à comissão de venda, parcela por parcela.

Para casos de Chargeback de vendas do SENAI Nacional ou Regional/Parceiro, a integração financeira com Protheus Nacional envia para o Protheus os títulos a pagar para a GetNet, parcela por parcela, no valor total da venda. Neste caso, o repasse da devolução para o Regional é de responsabilidade do SENAI Nacional.

Abaixo estão listados as regras e os campos que serão exibidos para cada tipo de conciliação:

Pagamento SENAI Nacional 

Nesta conciliação é necessário verificar:

  • Se foi identificado título a receber, em nome da GetNet, com valor bruto e valor da taxa iguais entre GetNet e Protheus.
  • Se o número da parcela da GetNet corresponde ao número da parcela no Protheus

Image Removed

Pagamento Regional/Parceiro

Nesta conciliação é necessário verificar:

  • Se foi identificado título a receber, em nome da GetNet, com valor da comissão e valor da taxa iguais entre GetNet e Protheus.
  • Se o número da parcela da GetNet corresponde ao número da parcela no Protheus

IImage Removed

Cancelamento Pagamento SENAI Nacional 

Nesta conciliação é necessário verificar:

  • Se foi identificado título a pagar, em nome da GetNet, com o valor bruto e valor da taxa iguais entre GetNet e Protheus.
  • Se o número da parcela da GetNet corresponde ao número da parcela no Protheus

Image Removed

Cancelamento Pagamento Regional/Parceiro

Nesta conciliação é necessário verificar:

  • Se foi identificado título a pagar, em nome da GetNet, com valor da comissão e valor da taxa iguais entre GetNet e Protheus.
  • Se o número da parcela da GetNet corresponde ao número da parcela no Protheus

Image Removed

Chargeback Pagamento SENAI Nacional e Regional/Parceiro

Nesta conciliação é necessário verificar:

  • Se foi identificado título a pagar, em nome da GetNet, com o valor bruto da parcela e valor da taxa iguais entre GetNet e Protheus.
  • Se o número da parcela da GetNet corresponde ao número da parcela no Protheus

Caso o pagamento atenda aos itens citados acima em cada cenário, ele será gravado com status de Conciliado e status da baixa Pendente. Desta forma, esse título ficará apto a ser enviado para ser baixado no Protheus.

Expandir
titleProcesso para Conferir Manualmente - Pagamentos

Detalhamento do Processo

O botão Conferir Manualmenteestá disponível na interface de de Pagamentos no portal, para os títulos que não foram conciliados ou baixados com sucesso automaticamente. Este botão ficará habilitado para usuário, apenas quando o título selecionado estiver com status de Conciliação diferente Conciliado ou Status de Baixa diferente de Baixado.

A integração do Report do Power BI com o Sistema de Gestão Educacional (SGE), permite que o SENAI acesse o dashboard da solução por meio do RM.

O processo envolve o recebimento de um arquivo com os dados de autenticação, sua importação no SGE e a configuração das parâmetros de integração.

Uma vez configurado, o Regional terá acesso ao dashboard, proporcionando uma visualização clara e abrangente das informações integradas.

O manual destaca a importância de seguir as etapas corretamente e destaca a responsabilidade do Regional em garantir a precisão dos dados para evitar qualquer impacto negativo na integração.

Expandir
titleParâmetros da Customização

Para que o usuário acesse o Dash é necessário que os parâmetros estejam preenchidos.

Ao acessar a tela de parâmetros no menu:  TOTVS Educacional | Sistema Indústria | Integração Power Bi |Parâmetros

Image Added

Será exibido na tela as campos:


Image Added

  • Authority URL: Endereço de acesso a API do Power BI
  • Workspace ID: Primary Domain gerado no Azure AD
  • Tenantid: Tenant ID gerado no Azure AD
  • Client ID: Client ID gerado no Azure AD
  • Secret Key: Secret Key gerada no Azure AD
  • Dash: Id do Dashboard que será exibido (exclusivo para cada Regional).

Para o preenchimento desses dados, o usuário do Regional, receberá um e-mail com o arquivo criptografado.

E -mail com o arquivo:

Ao receber o e-mail do SENAI DN com o arquivo contendo os dados de configuração, o usuário deverá baixar o arquivo, que posteriormente será importado.

Image Added


Importação do arquivo:

O arquivo recebido do SENAI DN deve ser importado via processo, para que os Regionais possam configurar os parâmetros da Integração Power BI.

O processo estará disponível em: TOTVS Educacional | Sistema Indústria | Integração Power BI | Parâmetros | Processos .


Image Added

Ao clicar no processo 'Importação de parâmetros Power BI', uma tela será apresentada para que o usuário indique o caminho onde o arquivo foi salvo.

Image Added


Quando o processo for concluído, as configurações de integração serão preenchidas automaticamente.

Image Added


Aviso
titleImportante:

O parâmetro não estará desabilitado para o usuário. Caso ocorra uma edição involuntária dos dados, é necessário importar novamente o arquivo para que o processo insira as informações corretas. Informações incorretas acarretam no não funcionamento da integração. A responsabilidade por essa etapa é do Regional.

Image Removed

Caso positivo, ao clicar neste botão, a customização irá habilitar uma caixa de texto para o usuário preencher alguma observação no pagamento e salvar. Neste momento, o status da conciliação será alterado para Conferido Manualmente e o status de baixa do título será alterado para Baixa Manual eficarão visíveis na página inicial de pagamento.

Image Removed

Este processo irá apenas alterar os status da conciliação e da baixa do título que estiverem com erro. Não será realizada nenhuma validação, exportação, importação ou processamento automático de informações de conciliação neste momento.

Funcionalidade do menu Valores Diários

  • Interface para o usuário visualizar, para cada dia, o total de pagamentos de títulos informado no Extrato GetNet de crédito (transações de crédito) e débito (cancelamentos e chargeback) e o total pago pela GetNet por dia (somatório dos valores de todas as bandeiras) contido no extrato bancário e exibir diferenças, quando existirem.

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. 

Image Removed

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: não editável, preenchido automaticamente com a data do pagamento. 
  • Total Recebimentos: não editável, preenchido automaticamente com o somatório dos pagamentos (crédito) obtidos no extrato de pagamentos da GetNet para o dia. 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: não editável, preenchido automaticamente com o valor total obtido no extrato de pagamentos (débito) referentes a cancelamento e chargeback da GetNet. 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 editável, para o usuário informar o valor que a GetNet depositou no banco naquela data. 
  • Valor Diferença: campo calculado automaticamente com adiferença positiva ou negativa entre o Valor do Banco e Valor GetNet (Valor Pagamentos - Valor Descontos)
    Expandir
    titleAcesso ao Dash

    Após o preenchimento das configurações, os Regionais terão acesso ao dashboard.

    Acesse o menu TOTVS Educacional | Sistema Indústria | Integração Power BI | Acesso ao Dash

    Image Added

    Ao clicar no menu, a customização chamará as APIs para autenticação e exibirá o link do dashboard na tela do RM.

    Image Added

    Aviso
    titleImportante:

    O SGE faz a exibição do dash, as regras, filtros e informações são configurações do Power BI, sem ações da customização.

    Expandir
    titleValores diários - Informação Bancária
    Aviso
    titleImportante:

    Quando o valor depositado for igual a zero, não é necessário calcular a diferença. O limite máximo de abatimento diário é o valor de crédito do dia. Caso seja atingido ou ultrapassado o máximo, o valor depositado pelo banco é zero e deve ser informado manualmente nesta interface. Independente do valor de abatimento atingido, o extrato de pagamentos retorna sempre todos os registros a receber e os cancelamentos e chargebacks que deverão ser pagos (baixados).

    Expandir
    titleBaixar Títulos Protheus

    Funcionalidades do menu Baixa de Títulos

    • Processo que deve ser executado diariamente (manual), envia as baixas de todos os títulos da data referência para o Protheus, a pagar e a receber. 
    • Baixa títulos a receber (transações de crédito) e a pagar (transações de cancelamento e chargeback).

    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.  

    Para executar o processo de baixa de títulos, o usuário deverá clicar no botão Executar Processo e informar uma data referência para envio da baixa para o Protheus.

    Image Removed

    Ao clicar em Executar, a customização só irá enviar a baixa dos títulos se o valor do banco estiver preenchido na interface Valores Diários para a data de referência selecionada. Não será validada a diferença entre o valor depositado no banco (informado pelo usuário) e os valores de pagamentos e cancelamentos.

    Não será possível selecionar registros/títulos. Este processo deverá identificar todos os pagamentos efetuados pela GetNet na data referência (recebimentos e abatimentos), para então localizar os títulos correspondentes no Protheus para envio da baixa. Serão enviadas para o Protheus a baixa de todos os títulos cuja a data de pagamento da GetNet seja igual a data referência informada (a pagar e receber).

    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.

    Ao expandir o registro será exibida a lista dos títulos processados por data e tipo, seus respectivos status de baixa e mensagem de erro (quando existir), como detalhe do log do processo.

    Baixa com sucesso

    Image Removed

    Baixa com erro

    Image Removed

    Caso exista pelo menos um título com status de Baixa com Erro, o status do processamento será Erro o usuário deverá processar novamente a data referência através desta interface. Nestes casos, serão enviadas novamente apenas as baixas dos títulos que ainda não foram baixados. Quando todos os títulos da data/referência estiverem baixados com sucesso, o status do processamento deve ser alterado para Sucesso. O usuário poderá visualizar o identificador do título com erro através desta interface, ao expandir o resumo da execução do processo. Após processamento, será gravado resumo do log do processo, status geral do processamento e status da baixa por título.

    Aviso
    titleImportante:
    • A customização irá disparar a execução da baixa de todos os títulos da data. Caso ocorra erro na baixa de algum título, não é possível realizar rollback. Porém, o usuário terá opção de reprocessar, até que todos os títulos estejam baixados com sucesso. 
    • A baixa parcial de títulos não será tratada nem travada neste escopo. É de responsabilidade do SENAI garantir que a regra de arredondamento seja a mesma no VTEX, GetNet e Protheus para não gerar diferença no Protheus. 

    Expandir
    titleConfiguração Ambiente

    Publicação e disponibilização do Portal Conciliador + Api em ambiente produção:

    View filenamePublicação Conciliador no ambiente Azure do cliente (Cloud TOTVS).pdfheight250