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.
- 1 Descrição
- 2 Pré-Requisitos
- 3 Passo a Passo
- 4 Acerto de Caixa com 'PIX/Carteira Digital
- 5 Recebimento em Pix/Carteira Digital Manualmente
- 6 Recebimento em Pix/Carteira Digital utilizando Integração com o Banco do Brasil (versão 2)
- 7 Recebimento em Pix/Carteira Digital utilizando Integração com o Itaú, Bradesco e Sicoob
- 8 Recebimento em Pix/Carteira Digital utilizando Integração Sicredi
- 9 Dicionário de Dados
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
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’.
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
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.
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.
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.
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'.
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.
Segue um exemplo, quando a configuração ‘Envia Rede’ estiver configurada como ‘Não’ na rotina de ‘Baixa de Duplicatas a Receber’.
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.
O mesmo processo ocorre nas demais rotinas implementadas como: ‘Acerto de Cheques Recebidos’, ‘Notas Fiscais’, ‘Adiantamento (Recebimento)’.
Nas Notas Fiscais será gerado na tag <tPag> o código 17 - Pagamento instantâneo Pix.
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.
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
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.
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
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.
Acessar o Menu: Cadastros >> Certificados Digitais no ViasoftX.exe.
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.
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 |
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.
Acessar o Menu: Cadastros » Certificados Digitais no ViasoftX.exe.
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.
Acessar o Menu: Cadastros » Certificados Digitais no ViasoftX.exe.
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.
É 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.
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.
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.
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.
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 |
---|---|
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. |
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