MCP - Pix/Carteira Digital

Descrição

Realizar acerto em Pix fazendo a inclusão manualmente ou utilizando com Integração com SITEF ou Pay&Go gerando QRCode no PinPad (somente para Recebimento/saídas e se o TEF estiver em uma versão que contemple o tipo de acerto em Pix/Carteira Digital).
E também realizar acerto em Pix com integração com Banco do Brasil gerando o QRCode na tela do sistema.

 

Pré-Requisitos

  • Incluir o cadastro do 'Pix/Carteira Digital' no meu: Cadastros >> Pix/Carteira Digital com os seguintes campos (especificados no dicionário de dados):

 

 

 

 

  •  Rede Administradora: Caso nas Configurações Gerais >> Financeiro >> Geral, esteja marcada a opção ‘Envia Rede’ como ‘Sim', este campo ficará habilitado para que seja selecionado a Rede a ser utilizada. Se estiver informado a Rede, não será necessário selecionar no momento do acerto e o QRCode será gerado automaticamente no PinPad. Se a rede não estiver informada, no momento do acerto terá que ser selecionada e posteriormente o QRCode será gerado.

  • Se a opção ‘Envia Rede’ for alterada, é necessário sair totalmente do sistema e acessar novamente.

Nas Configurações Gerais >> Financeiro >> Analíticas de Receita, foi incluído o campo ‘Cart.Digital/PIX’ para que seja adicionada a analítica que será usada nos acertos.

Passo a Passo

  1. Após realizar a inclusão de um cadastro de ‘Pix/Carteira Digital’, neste exemplo, configuramos com a Pay&Go, na tela de acerto das rotinas de ‘Baixa de Duplicatas a Receber’, ‘Acerto de Cheques Recebidos’, ‘Notas Fiscais’, ‘Adiantamento (Recebimento)’, Carrinho e ‘Acerto de Caixa (Balcão)’ ficará habilitada a opção de acerto ‘7-PIX/Carteira Digital’.

  1. Ao clicar na opção de acerto em ‘PIX/Carteira Digital’, será carregada nova tela para inclusão do acerto (especificados no dicionário de dados):

 

Acerto de Caixa com 'PIX/Carteira Digital

  1. Foi efetuada a venda no Carrinho e adicionado na ‘Simulação de Pagamentos’, acerto em ‘7-PIX/Carteira Digital’, trouxe o código ‘11-Sicredi-Pay&Go’, pois o mesmo está configurado para ‘Padrão PDV’ em seu cadastro. Como havia taxa configurado na Carteira, no carrinho é possível visualizar o valor calculado.

 

  1. Na rotina de Acerto de Caixa (balcão) em Processos >> Acerto de Caixa (Balcão), ficou informado que foi feito em ‘PIX/Carteira Digital’, podendo ser visualizado ou até mesmo editado em ‘Pagamentos’. Como foi informado nas Configurações Gerais a analítica de Receita para este tipo de acerto, a analítica já foi carregada.

 

  1. Ao finalizar a nota no Caixa, o QR Code já será gerado no PinPad para pagamento, isso porque a configuração foi deixada como ‘Envia Rede - Sim’, desta forma, já é enviada a Rede configurada sem a necessidade de informar.

 

  1. No momento em que é gerado o QR Code no PinPad, o cliente fará a leitura deste QR Code e irá concluir o pagamento. O valor pago será creditado automaticamente na conta, sendo que ao adquirir a máquina da Rede ou Cielo, por exemplo, será configurado na própria máquina a chave para recebimento desses valores. Cada tipo de máquina tem seu banco para recebimento, sendo necessário um alinhamento no momento de efetivar esta aquisição. O que é preciso para o funcionamento, é que a integração seja realizada pelo TEF Pay&Go, em uma versão que contemple tipo de pagamento em 'PIX/Carteira Digital'.

  2. Após a conclusão da transação no sistema, é gerado um ‘Lançamento Financeiro’ no menu ‘Financeiro >> Lançamentos Financeiros’, contendo as informações referente ao lançamento e pode ser verificado que foi efetuado no portador configurado no Código Pix utilizado, sendo gravado também informações da transação TEF, como NSU, Autorização, Data/Hora da transação e a Rede .

É gerado também um lançamento financeiro de Taxa.

 

 

  1. Segue um exemplo, quando a configuração ‘Envia Rede’ estiver configurada como ‘Não’ na rotina de ‘Baixa de Duplicatas a Receber’.

  2. Neste caso, após informar o acerto e salvar, será solicitado que seja selecionada a Rede, somente após a seleção, é que o QR Code será gerado e o pagamento poderá ser efetivado.

 

  1. O mesmo processo ocorre nas demais rotinas implementadas como: ‘Acerto de Cheques Recebidos’, ‘Notas Fiscais’, ‘Adiantamento (Recebimento)’.

  2. Nas Notas Fiscais será gerado na tag <tPag> o código 17 - Pagamento instantâneo Pix.

  3. Nos acertos realizados em Cartão e Pix, o TEF será acionado duas vezes, uma para o cartão, mostrando na tela informações do pagamento como qual é o ‘Cartão utilizado, Tipo: Crédito ou Débito, o Valor e o Nro de Parcelas’, após sua autorização será mostrado na tela a ‘Carteira utilizada', o Tipo como ‘Pix’, o 'valor' e a 'Parcela’, desta forma, será realizado ambos os pagamentos, mostrando os dados antes do TEF ser acionado para informar ao usuário qual o tipo de pagamento que será feito primeiro.

  4. Validações: Não irá permitir fazer o acerto em Pix, caso o código do ‘PIX/Carteira Digital’ utilizado no pagamento não tenha portador configurado para o estabelecimento selecionado e mostrará a seguinte mensagem: ‘Carteira digital sem portador vinculado no estabelecimento’'.

Recebimento em Pix/Carteira Digital Manualmente

  1. O acerto em PIX/Carteira Digital pode ser feito manualmente, sem a chamada do TEF Pay&Go, basta deixar na configuração como ‘Usa TEF - Não’ e informar os dados manualmente no momento do acerto.

 

O lançamento financeiro será gerado normalmente, porém, sem acionar o TEF, e consequentemente, sem gravar as demais informações.

 

Recebimento em Pix/Carteira Digital utilizando Integração com o Banco do Brasil (versão 2)

Para utilizar os acertos em Pix com a integração com Banco do Brasil é preciso cadastrar a Carteira Digital/Pix com as configurações necessárias, com esta integração o QRCode será gerado na tela do sistema.

  1. No cadastro da Carteira digital/Pix deve ser incluído as seguintes informações:

Chave

Deve ser gerada uma chave para utilização do Pix e informar qual o tipo da chave.

Usa TEF

Para utilizar a integração do Banco do Brasil é necessário deixar como ‘Não’.

Banco

Selecionar Banco do Brasil.

Aba ‘Configurações’ - Ambiente

Selecione o ambiente em que será realizada a geração do QRCode do Pix integrando com o Banco do Brasil.

Client ID

Solicitar ao Banco do Brasil qual é o Client ID para envio do Pix

Client Secret

Solicitar ao Banco do Brasil qual é o Client Secret para envio do Pix

Application Key

Solicitar ao Banco do Brasil qual é a Application Key para envio do Pix

 

 

Caso seja utilizado o ambiente de testes para o Banco do Brasil, o campo Chave PIX deverá ser preenchido com uma das chaves disponibilizadas pelo BB para o ambiente de homologação:

    API versão 1:

  • E-mail: testqrcode01@bb.com.br

  • CPF: 28779295827

  • Aleatória: 7f6844d0-de89-47e5-9ef7-e0a35a681615

  • Aleatória: 3d94a38b-f344-460e-b6c9-489469b2fb03

  • Aleatória: d14d32de-b3b9-4c31-9f89-8df2cec92c50

    API versão 2

  • E-mail: hmtestes2@bb.com.br

  • CNPJ: 95127446000198

  • Celular: +5511985732102

  • Aleatória: 9e881f18-cc66-4fc7-8f2c-a795dbb2bfc1

  1. Após ter as credenciais informadas na Carteira, é necessário fazer a importação do Certificado Digital no ViasoftX.exe (versão do Viasoft Gerente no TMS), que se encontra no diretório de instalação do sistema \Viasoft\Client\Tools, menu Cadastros >> Certificados Digitais. Será necessário utilizar a última versão do ViasoftX.exe.

  1. Acessar o Menu: Cadastros >> Certificados Digitais no ViasoftX.exe.

  1. Basta importar o Certificado e informar a senha.
    Neste momento, os campos Chave Privada e Certificado PEM serão gerados automaticamente e ficarão bloqueados para alteração, esses campos (CERTIFICADOPEM e a CHAVEPRIVADA) ficarão gravados na tabela CERTIFICADO.

 

 

Desta forma, poderá ser realizado os recebimentos em Pix gerando o QRCode em tela nas rotinas do sistema que já contemplam o Pix, sendo elas: Baixa de Duplicata a Receber, Acerto e Cheques Recebidos, Acerto de Caixa (ao Finalizar ou Executar Ação de uma Nota Fiscal), Nota de Adiantamento (Recebimento) e Notas Fiscais.

Abaixo segue um exemplo ao efetuar a Baixa de Duplicata a Receber:

Ao salvar, será gerado o QRCode para recebimento, mostrando quantos segundos ficará na tela disponível antes de ser cancelado, este tempo de apresentação é configurável. O botão ‘Copiar’ facilita a cópia do Pix Copia e Cola' disponível ao lado, o botão ‘Confirmar transação Pix’ fica somente disponível na série da Viasoft para testes.
Após o cliente efetuar a leitura do QRCode e confirmar a transação, o processo é finalizado gerando um lançamento financeiro, conforme já mencionado acima.

 

E também ao Finalizar uma nota no Acerto de Caixa, após incluir um Carrinho com recebimento em Pix:

 

Os lançamentos financeiros serão gerados da mesma forma, porém com campos diferentes gravados.

É possível configurar o tempo em que o QRCode fica aberto na tela em Configurações >> Gerais - Financeiro >> Geral.

Recebimento em Pix/Carteira Digital utilizando Integração com o Itaú, Bradesco e Sicoob

Para utilizar os acertos em Pix com a integração com os bancos Itaú, Bradesco e Sicoob é preciso cadastrar a Carteira Digital/Pix com as configurações necessárias Chave, Portador e Taxa se necessário, selecionando o Banco desejado, com esta integração o QRCode será gerado na tela do sistema.

  1. No cadastro da Carteira digital/Pix devem ser incluídas as seguintes informações:

Chave

Deve ser gerada uma chave para utilização do Pix e informar qual o tipo da chave.

Usa TEF

Para utilizar a integração com os bancos Itaú, Bradesco e Sicoob é necessário deixar como ‘Não’.

Banco

Selecionar o banco (Itaú, Bradesco ou Sicoob).

Aba ‘Configurações’ - Ambiente

Selecione o ambiente em que será realizada a geração do QRCode do Pix integrando com o banco em questão (Itaú, Bradesco ou Sicoob).

Client ID

Solicitar ao banco qual o Client ID para envio do Pix

Client Secret

Solicitar ao banco qual o Client Secret para envio do Pix

Application Key

Solicitar ao banco qual a Application Key para envio do Pix

  1. Após ter as credenciais informadas na Carteira, é necessário fazer a importação do Certificado Digital no ViasoftX.exe (versão do Viasoft Gerente no TMS), que se encontra no diretório de instalação do sistema \Viasoft\Client\Tools, menu Cadastros » Certificados Digitais. Será necessário utilizar a última versão do ViasoftX.exe.

  1. Acessar o Menu: Cadastros » Certificados Digitais no ViasoftX.exe.

  1. Basta importar o Certificado e informar a senha.
    Neste momento, os campos Chave Privada, Certificado PEM e Certificado CSR (utilizado para o Sicredi) serão gerados automaticamente, ao salvar, esses campos ficarão gravados na tabela CERTIFICADO.

 

Desta forma, poderá ser realizado os recebimentos em PIX gerando o QRCode em tela nas rotinas do sistema, sendo elas: Baixa de Duplicata a Receber, Acerto e Cheques Recebidos, Acerto de Caixa (ao Finalizar ou Executar Ação de uma Nota Fiscal), Nota de Adiantamento (Recebimento) e Notas Fiscais.

Abaixo segue um exemplo ao efetuar a Baixa de Duplicata a Receber, porém, o processo segue igual, conforme mencionado acima para o Banco do Brasil:

 

Ao salvar, será gerado o QRCode para recebimento, mostrando quantos segundos ficará na tela disponível antes de ser cancelado, este tempo de apresentação é configurável. O botão ‘Copiar’ facilita a cópia do PIX Copia e Cola' disponível ao lado, o botão ‘Confirmar transação PIX’ fica somente disponível na série da Viasoft para testes.
Após o cliente efetuar a leitura do QRCode e confirmar a transação, o processo é finalizado gerando um lançamento financeiro, conforme já mencionado acima.

 

Recebimento em Pix/Carteira Digital utilizando Integração Sicredi

Para utilizar os acertos em Pix com a integração com o Sicredi é preciso primeiramente realizar a importação do Certificado. A importação do Certificado Digital é feita no ViasoftX.exe (versão do Viasoft Gerente no TMS), que se encontra no diretório de instalação do sistema \Viasoft\Client\Tools, menu Cadastros » Certificados Digitais. Será necessário utilizar a última versão do ViasoftX.exe.

  1. Acessar o Menu: Cadastros » Certificados Digitais no ViasoftX.exe.

  1. Basta importar o Certificado e informar a senha.
    Neste momento, os campos Chave Privada, Certificado PEM e Certificado CSR (utilizado para o Sicredi) serão gerados automaticamente.

  1. É necessário salvar as informações contidas no CERTIFICADO CSR, com a extensão .txt e finalizar a importação salvando a tela de Certificados Digitais.

  1. No caminho que foi salvo o arquivo .txt, deve ser editado sua extensão para .csr. Basta dar dois cliques em cima do arquivo e ao invés de editar o nome do arquivo, por exemplo, será somente editado a sua extensão para .csr.

     

  1. Irá solicitar se deseja alterar a extensão, basta clicar em ‘Sim’. Desta forma, o arquivo ficará salvo .csr e terá o seu ícone alterado.

 

 

 

 

  1. Após obter as credenciais, no cadastro da Carteira digital/Pix devem ser incluídas informações de Chave, Portador e Taxa se necessário, selecionando o Banco Sicredi.

 

 

 

  1. Na aba de Configurações, é informada as credencias.

 

 

Chave

Deve ser gerada uma chave para utilização do Pix e informar qual o tipo da chave.

Usa TEF

Para utilizar a integração com os bancos é necessário deixar como ‘Não’.

Banco

Selecionar o banco Sicredi

Aba ‘Configurações’ - Ambiente

Selecione o ambiente em que será realizada a geração do QRCode do Pix integrando com o banco Sicredi.

Client ID

Solicitar ao banco qual o Client ID para envio do Pix

Client Secret

Solicitar ao banco qual o Client Secret para envio do Pix

Application Key

Solicitar ao banco qual a Application Key para envio do Pix

 

Desta forma, poderá ser realizado os recebimentos em PIX gerando o QRCode em tela nas rotinas do sistema, sendo elas: Baixa de Duplicata a Receber, Acerto e Cheques Recebidos, Acerto de Caixa (ao Finalizar ou Executar Ação de uma Nota Fiscal), Nota de Adiantamento (Recebimento) e Notas Fiscais.

Abaixo segue um exemplo ao efetuar a Baixa de Duplicata a Receber, porém, o processo segue igual, conforme mencionado acima para o Banco do Brasil:

 

Ao salvar, será gerado o QRCode para recebimento, mostrando quantos segundos ficará na tela disponível antes de ser cancelado, este tempo de apresentação é configurável. O botão ‘Copiar’ facilita a cópia do PIX Copia e Cola' disponível ao lado, o botão ‘Confirmar transação PIX’ fica somente disponível na série da Viasoft para testes.
Após o cliente efetuar a leitura do QRCode e confirmar a transação, o processo é finalizado gerando um lançamento financeiro, conforme já mencionado acima.

 

 

Dicionário de Dados

Nome do Campo no Sistema

Funcionalidade

Nome do Campo no Sistema

Funcionalidade

PIX/Carteira Digital

Padrão PDV

Se for informado como ‘Sim’, será carregado esse pagamento como padrão no ‘Carrinho’ quando o acerto for em PIX.

Descrição

Nome do banco ou carteira digital.

Analítica

Informar a analítica de Taxa, caso nesta Carteira Digital seja calculada a Taxa o lançamento financeiro será realizado nesta analítica.

Chaves

Pode ser incluída a chave relacionada ao PIX, sendo utilizada somente na integração com alguns bancos, tais como: Sicoob, Itaú, Bradesco e Sicredi, com geração de QRCode na tela do sistema.

Portadores

Será obrigatória a informação do portador para efetuar o pagamento em PIX, pois o lançamento financeiro será efetuado neste portador, pode ser adicionado um para cada estabelecimento.

Taxa

Pode ser incluída somente uma taxa por estabelecimento, que será calculada sobre o valor do acerto em PIX em percentual ou como valor fixo, gerando um lançamento financeiro de Taxa.

Inativo

Data de inativo.

Usa TEF

Selecionar se o TEF utilizado será o Pay&Go ou o SITEF e selecionar a REDE.
Para utilizar a integração com os bancos é necessário deixar como ‘Não’.

Banco

Selecionar o banco (Sicoob, Itaú, Bradesco ou Sicredi), caso a Carteira Digital / PIX seja utilizada com integração gerando o QRCode em tela.

Informações Obrigatórias

Marcar o checkbox das opções que serão obrigatórias informar somente no acerto manual em PIX.

Aba ‘Configurações’ - Ambiente

Selecione o ambiente em que será realizada a geração do QRCode do PIX integrando.

Client ID

Solicitar ao banco qual é o Client ID para envio do Pix

Client Secret

Solicitar ao banco qual é o Client Secret para envio do Pix

Application Key

Solicitar ao banco qual é a Application Key para envio do Pix

Pagamento em Pix/Carteira Digital

PIX/Carteira Digital

F3 do cadastro de ‘PIX/Carteira Digital’;

Analítica

Informar a analítica do lançamento em PIX, caso esteja configurada nas Gerais em ‘Financeiro » Geral » Analítica de Receita', será carregada por padrão, se não estiver informada será carregada a Analítica de Receita em 'Dinheiro’.

Código Transação

Código gerado automaticamente ao incluir carteiras configuradas com TEF.

NSU

Código gerado pela transação do PIX com TEF.

Valor do Acerto

Carrega o valor total, mas pode ser alterado.

Botão ‘Adicionar'

Permite adicionar mais de um acerto em PIX.

Grid ‘Pagamentos Adicionados’:

Neste grid será incluído o acerto informado acima, contendo em sua visualização o valor da Taxa calculada.

 

Abaixo vídeos referente as evoluções no processo do Pix:

A partir da versão 3.5.2205.1001:

https://drive.google.com/file/d/1SNHPAA-rrGSzdyxjjm8HhGkoeDlfmjfd/view?usp=sharing

A partir da versão 3.5.2207.1001:

https://drive.google.com/file/d/1dSq0OEfY8sShn6MG_QPeh0lukBpX3kt_/view?usp=sharing

A partir da versão 3.5.2209.1001:

https://drive.google.com/file/d/1T3Gka-Tv-21toEv_dNvyDcY3dRKGbMIN/view?usp=sharing

A partir da versão 2.2309.2309.6911 (versão 90 - Pix QRCode Banco do Brasil v2)
https://drive.google.com/drive/folders/1xA3hb1S0JYpymr-_Yec2m0EjZM57j4p1