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

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. 

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.

Não existe interface para preenchimento destes valores.

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

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.

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 

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.

Observação: Se existir algum pedido GetNet sem pedido VTEX, para esses casos, a busca será direto na API de pedidos para atualizar os dados correspondentes.

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.

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

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.

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.

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.

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

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.

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

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

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

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.

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

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.

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

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

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

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.

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.

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

As transações de Cancelamento e Chargeback  podem ser agrupadas, da mesma forma como ficam as transações de crédito, já que no momento do cancelamento a GetNet devolve os dados de todas as parcelas relacionadas. O que não podem ser agrupados são os pagamentos, que são efetuados por parcela, mês a mês (interface Recebimentos).

Portanto, na linha de resumo da Transação (pedido) cancelada, será exibida apenas uma transação com o detalhamento das parcelas que compõem a transação no bloco GetNet (expandir o registro). 

Além disso, será necessário mostrar o bloco GetNet para essas transações. No escopo original, o bloco VTEX não seria exibido para para transações de cancelamento e chargeback. No entanto, com a mudança na busca dos dados, será necessário exibir o bloco com as seguintes informações: 

• Data/hora do cancelamento (no lugar da data/hora transação): exibir a data e hora em que o pedido foi cancelado 
• Status do pedido: Cancelado ou Ativo (na maioria dos casos estará cancelado, mas deve exibir o status que o VTEX devolveu).
• Parcelas, comissão, valor total e NSU: mostrar os mesmos dados que são exibidos na transação de crédito correspondente ao cancelamento.

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 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 portal conciliador. 

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

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

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

I

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

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

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.

Detalhamento do Processo

O botão Conferir Manualmente está 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.

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 e ficarão visíveis na página inicial de pagamento.

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.

• Não é permitido gerar arquivo sem que seja informado CNPJ ou as datas.

• O arquivo tem um tamanho máximo de 10.000 linhas. Caso o arquivo ultrapasse esse valor será realizada a quebra do arquivo e apresentado no grid por "partes":

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

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