Boleto online com QR CODE - PIX cobrança Itaú

De Wiki NBS
Ir para navegação Ir para pesquisar
Construcao icon.png Área em Construção

Seta-topo.png

Para retornar à Página principal > Soluções NBS - Financeiro - SISFIN - Tabelas - Cobrança Bancária > Boleto online com QR CODE - PIX cobrança Itaú


Conceito

Este manual irá demonstrar a utilização da nova versão padrão CNAB para envio/recepção de boletos que constam com QRCODE para pagamento PIX. Com esta opção o cliente poderá escolher a modalidade de pagamento que desejar, seja por boleto ou PIX.

A NBS está em constante aprimoramento dos seus processos de negócio, objetivando a melhoria dos serviços e a satisfação dos clientes.


Versão

Esta melhoria estará disponível a partir da seguinte versão dos módulos abaixo:

Módulo Versão NBSScript
Cx Operacional 9.969.0.0 1.57.76.5
Ger Veic 3.855.0.0
NBS OS 3.1225.0.0
NF Vendas 5.706.0.0
Sisfin 9.969.0.0
Vend Veic 3.309.0.0
Vendas 4.518.0.0
NBS Boleto 1.13.0.0
Integrador Financeiro 1.47.0.0

Tela Menu Parametrização Cobrança Online / QR Code

Acesse:

  1. Sisfin > Tabelas > Cobrança Bancária > Configura Empresa-Banco > Aba Página 3
  2. Ative o Parâmetro: Cobrança Online QRCODE
Sisfin - Tabelas - Cobrança Bancária - Configura Empresa-Banco - Aba Página 3 - Parâmetro Cobrança Online QRCODE.png O usuário deve marcar o parâmetro: Cobrança Online QRCODE.
Esta opção está disponível para o tipo de cobrança escritural: 46- Itaú (240), ou 5- Itaú (400);

Este parâmetro virá por padrão desmarcado.


Atenção: Ao marcar o parâmetro, o sistema irá inabilitar o parâmetro: Cobrança Online (o sistema NÃO permite que ambos os parâmetros fiquem ativos) e, irá alterar o nome da aba Cobrança Online para: Cobrança Online/QRCODE.

Parametrização Cobrança OnLine / QR Code

Modo Produção - Aba Itaú

Será exemplificado somente a configuração do modo Produção, uma vez que o modo Homologação foi utilizado pela NBS para testes junto à instituição bancária. Importante: Antes de iniciar a configuração o usuário deve possuir em mãos os dados doo contrato firmado com a Instituição bancária Itaú (Client ID, Client Key, URL Registro).

Sisfin - Tabelas - Cobrança Bancária - Configura Empresa-Banco - Aba Página 3 - Parâmetro Cobrança Online QRCODE - Itaú - Botão Produção1.png Ao selecionar o Tipo de Ambiente de Destino, o sistema irá carregar o formulário correspondente.

Para este exemplo acesse o Modo Produção.

Sisfin - Tabelas - Cobrança Bancária - Configura Empresa-Banco - Aba Página 3 - Parâmetro Cobrança Online QRCODE - Itaú - Botão Produção.png O usuário deve preencher os campos do formulário ao lado para ativar o botão: Botão Conf. Produção.png
Importante: Os campos: Client ID e Client Key estarão inativos para preenchimento neste momento (o campo será preenchido automaticamente após processo de configuração abaixo).

Configuração do ambiente de Produção

Etapa 1 - Configuração de Comunicação

Sisfin - Tabelas - Cobrança Bancária - Configura Empresa - Banco - Aba Especifico para Cobranca Online - Itaú - Configuração de Comunicação - Botão Conf Produção - Form Conf Amb de Produção.png Efetue a geração das chaves assimétricas ao clicar no botão: Botão Gerar Chaves.png
Sisfin - Tabelas - Cobrança Bancária - Configura Empresa - Banco - Aba Especifico para Cobranca Online - Itaú - Configuração de Comunicação - Botão Conf Produção - Form Conf Amb de Produção2.png Após gerar as chaves, o usuário deve efetuar o envio da Chave Público para o banco.

Clique no botão OK, para fechar a mensagem informativa.

O usuário deve localizar a chave salva em seu diretório raiz.


IMPORTANTE: NÃO SERÁ POSSIVEL COPIAR A INFORMAÇÃO DA CHAVE PÚBLICA DIRETAMENTE DO CAMPO AO LADO, O USUÁRIO DEVE EFETUAR ESTE PROCESSO ATRAVÉS DO MENU RAIZ (encontra-se no mesmo local onde está salvo o executável do módulo Sisfin).
Na ocorrência de erro o usuário terá de refazer a geração da chave novamente.
Sisfin - Tabelas - Cobrança Bancária - Configura Empresa - Banco - Aba Especifico para Cobranca Online - Itaú - Configuração de Comunicação - Botão Conf Produção - Form Conf Amb de Produção - Menu Raiz.png Localize o arquivo gerado em seu diretório raiz.

O arquivo deve ser enviado ao Banco. A informação da Chave Pública poderá ser enviada da seguinte forma:

  • Anexando o arquivo ao lado no e-mail ou;
  • Copiando a informação através do modo edição, conforme exibido abaixo.
Sisfin - Tabelas - Cobrança Bancária - Configura Empresa - Banco - Aba Especifico para Cobranca Online - Itaú - Configuração de Comunicação - Botão Conf Produção - Form Conf Amb de Produção - Notepad++.png Edite o arquivo e copie a informação.

O usuário irá abrir o arquivo (para este exemplo utilizamos o programa Notepad++), marcar toda a chave e efetuar a cópia (Ctrl + C) e colar no corpo do e-mail a ser encaminhado ao banco.


Etapa 2 - Dados Descriptografados

Após o retorno do Banco, o usuário fará a segunda parte da parametrização, conforme exemplificado abaixo.

Nesta fase o usuário irá efetuar a inclusão dos dados criptografados encaminhado pelo banco.

Sisfin - Tabelas - C Bancária - Config Emp - Banco - Aba Especifico para Cobranca Online - Configuração de Comunicação - Botão Conf Produção - Form Conf Amb de Produção - Botão Próxima Etapa.png Após a resposta do banco, o usuário voltará ao formulário e irá clicar no Botão Botão Próxima Etapa.png
Botao Atencao2.png Atenção:
  • Para os clientes que utilizem o PIX Itaú, avance para a aba: Dados Descriptografados e, insira as informações encaminhada pelo banco.
Sisfin - Tabelas - C Bancária - Config Emp - Banco - Aba Especifico para Cobranca Online - Configuração de Comunicação - Botão Conf Produção - Form Conf Amb de Produção - 2ª Etapa1.png Os campos do formulário ao lado serão preenchidos com as informações encaminhada pelo Banco.

Copie os dados nos campos correspondentes e clique no botão: Botão Descriptografar Dados.png

Sisfin - Tabelas - C Bancária - Config Emp - Banco - Aba Especifico para Cobranca Online - Configuração de Comunicação - Botão Conf Produção - Form Conf Amb de Produção - 2ª Etapa - Tela Informativa.png Se, o usuário tentar passar para a próxima etapa SEM Descriptografar os dados, o sistema irá apresentar a Mensagem ao lado e, impedirá de continuar.
Sisfin - Tabelas - C Bancária - Config Emp - Banco - Aba Especifico para Cobranca Online - Configuração de Comunicação - Botão Conf Produção - Form Conf Amb de Produção - 2ª Etapa - Aba Dados Descriptografados.png Após Descriptografar os dados, o usuário será direcionado para a aba: Dados Descriptografados, onde os dados serão exibidos em Tela.

Clique no botão Botão Salvar Dados.png

Sisfin - Tabelas - C Bancária - Config Emp - Banco - Aba Especifico para Cobranca Online - Configuração de Comunicação - Botão Conf Produção - Form Conf Amb de Produção - 2ª Etapa - Tela Informativa2.png A mensagem ao lado será gerada quando os dados NÃO forem descriptografados corretamente.

Execute novamente o processo.

Sisfin - Tabelas - C Bancária - Config Emp - Banco - Aba Especifico para Cobranca Online - Configuração de Comunicação - Botão Conf Produção - Form Conf Amb de Produção - 2ª Etapa - Tela Informativa3.png A mensagem ao lado será exibida quando o processo foi executado com sucesso.

Clique no botão Botão Próxima Etapa.png.


Etapa 3 - Geração do Certificado CSR

Nesta etapa o usuário irá gerar os arquivos do Certificado CSR.

Sisfin - Tabelas - C Bancária - Config Emp - Banco - Aba Especifico para Cobranca Online - Configuração de Comunicação - Botão Conf Produção - Form Conf Amb de Produção - 3ª Etapa.png Clique no botão Botão Gerar CSR.png, o sistema irá gerar o arquivo do Certificado CSR.
Sisfin - Tabelas - C Bancária - Config Emp - Banco - Aba Especifico para Cobranca Online - Configuração de Comunicação - Botão Conf Produção - Form Conf Amb de Produção - 3ª Etapa - Tela Informativa.png Ao final do processo será exibido a Tela Informativa de sucesso.

Clique no botão Botão Próxima Etapa.png


Etapa 4 - Geração do certificado PFX

Nesta etapa o usuário terá de encaminhar os dados do Certificado CSR ao banco, esta ação é obrigatória para a geração do certificado PFX.

Nesta etapa o usuário irá gerar os arquivos do certificado PFX.

Sisfin - Tabelas - C Bancária - Config Emp - Banco - Aba Especifico para Cobranca Online - Configuração de Comunicação - Botão Conf Produção - Form Conf Amb de Produção - 4ª Etapa.png Nesta última fase, o usuário terá a possibilidade de retornar para a etapa anterior, caso detecte que algum passo não foi corretamente executado ao clicar no botão Botão Etapa Descriptografia.png
Clique no botão Botão Enviar CSR.png, para efetuar o envio do arquivo ao banco.
Importante: O arquivo CSR deve ser encaminhado ao banco antes de Gerar o certificado PFX.
Sisfin - Tabelas - C Bancária - Config Emp - Banco - Aba Especifico para Cobranca Online - Configuração de Comunicação - Botão Conf Produção - Form Conf Amb de Produção - 4ª Etapa - Tela Informativa.png Se, o usuário clicar no botão Botão Gerar PFX.png, antes do envio do Arquivo CSR ser encaminhado ao banco, o sistema apresentará a Mensagem ao lado e bloqueará a geração do arquivo PFX até que este processo esteja finalizado.
Sisfin - Tabelas - C Bancária - Config Emp - Banco - Aba Especifico para Cobranca Online - Configuração de Comunicação - Botão Conf Produção - Form Conf Amb de Produção - 4ª Etapa 2.png Após retorno do banco, o usuário irá gerar o PFX ao clicar no botão identificado na imagem ao lado.

Renovação de Certificado

A renovação do certificado deve ser feita antes do vencimento.

Se o usuário deixar o certificado vencer, este deve executar TODOS os passos acima para retornar a utilizar a cobrança online.

Sisfin - Tabelas - C Bancária - Config Emp - Banco - Aba Especifico para Cobranca Online - Configuração de Comunicação - Botão Renovar CRT.png O sistema irá emitir a tela de alerta do vencimento do certificado (na emissão do boleto) conforme a parametrização feita.

Clique no botão Renovar CRT.png

Sisfin - Tabelas - C Bancária - Config Emp - Banco - Aba Especifico para Cobranca Online - Configuração de Comunicação - Botão Renovar CRT - Form Renovar Certificado.png Clique no botão Botão Renovar Certificado.png
Importante: para este exemplo foi solicitado a renovação com um prazo muito longo antes do seu real vencimento. O sistema permitirá a renovação com no mínimo 60 dias antes do vencimento.
Para testar o Token, clique no botão Botão Testar Token.png
Botao Importante3.png Importante:
  • Após a finalizada a configuração acima, o usuário fará a emissão dos boletos normalmente. Abaixo será exibida as alterações feitas no módulo Sisfin.

Aba Parâmetros Gerais

Atenção: Este parâmetro deve ser preenchido somente pelas empresas que utilizem a comunicação Proxy.

Acesse:

  1. Aba Específico para Cobrança Online > Parâmetros Gerais
  2. Parametrize a comunicação proxy
Sisfin - Tabelas - Cobrança Bancária - Configura Empresa-Banco - Aba Cobrança Online-QRCODE - Sub Aba Parâmetros Gerais.png Preencha os campos de identificação Proxy.

Atenção: Normalmente estas informações são de controle da equipe de TI da empresa.


Aba WebHook

Área não liberara para uso no momento.

Botao Importante3.png Importante:
  • Esta etapa só será disponibilizada na próxima fase. A área se encontra em construção no momento.
Sisfin - Tabelas - Cobrança Bancária - Configura Empresa-Banco - Aba Cobrança Online-QRCODE - Sub Aba WebHook.png Atenção: As funções desta aba serão liberadas na próxima fase.

Emissão do Boleto - Sisfin

Após a geração do boleto, o usuário fará sua impressão, abaixo será exemplificado este processo através do Contas a Receber.

Acesse:

  1. Sisfin - Botão Receber > Botão Impressão Duplicatas/Boletos
  2. Efetue a impressão do boleto.
Sisfin - Botão Receber - Botão Impressão Duplicatas-Boletos.png Selecione o Título a ser impresso.
Sisfin - Botão Receber - Form Contas a Receber - Aba Detalhe-Manutenção - Tela Informativa.png O sistema irá questiona-lo se deseja efetuar o envio por e-mail ao cliente.

Para este exemplo, efetuamos apenas a impressão normal (selecionamos a opção NÃO no formulário ao lado).

Sisfin - Botão Receber - Botão Impressão Duplicatas-Boletos - Boleto.png

Impressão do boleto

Nesta aba o usuário poderá efetuar também a impressão do boleto, o sistema fará a comunicação com a API do banco (para habilitar a função é necessário que a empresa possua o parâmetro: 'Cobrança Online' - conforme exemplificado acima) para então imprimir o boleto.

Sisfin - Botão Receber - Form Contas a Receber - Aba Detalhe-Manutenção .png Para o detalhamento do Boleto, clique no botão: Botão QRCODE.png (após selecionar o título/boleto - aba Pesquisa - Contas a Receber),
Sisfin - Botão Receber - Form Contas a Receber - Aba Detalhe-Manutenção - Botão QRCODE - Form Consulta Ocorrência.png Neste formulário o usuário terá além da opção de impressão do título/boleto, as informações enviadas para a API (estas serão melhor detalhadas abaixo).

Para efetuar a impressão do Título/Boleto, clique no botão Botão Imprimir.png.


Importante: Se, o boleto NÃO estiver Registrado, ao solicitar este registro (clicar no botão Botão Registrar.png) o sistema fará a comunicação com a API Itaú onde esta irá autorizar a emissão do boleto (status Autorizado).
Sisfin - Botão Receber - Botão Impressão Duplicatas-Boletos - Boleto.png Será emitido o boleto, conforme o exemplo ao lado.

Consulta Ocorrência

O sistema exibirá a informação do processamento do título/boleto.

A informação terá a sua exibição dividida entre as abas exibidas abaixo, onde, para cada envio terá a informação correspondente do retorno.

  • JSON Token
    • Retorno Token
  • JSON Registro Boleto
    • Retorno Registro Boleto

JSON Token / Retorno Token

Nesta aba, será exibido as informações do Token (envio e retorno).

Sisfin - Botão Receber - Form Contas a Receber - Aba Detalhe-Manutenção - Botão QRCODE - Form Consulta Ocorrência - Aba JSON Token-Retorno Token.png Nesta aba será exibido os dados do envio (JSON Token) e do retorno do banco (Retorno Token).

HEADER/BODY Registro Boleto / Retorno Registro Boleto

Nesta aba, será exibido as informações do Boleto (envio e retorno).

Sisfin - Botão Receber - Form Contas a Receber - Aba Detalhe-Manutenção - Botão QRCODE - Form Consulta Ocorrência - Aba Header Body-Retorno Registro Boleto.png Nesta aba será exibido os dados do envio do Título/Boleto (JSON Registro Boleto) e do retorno do banco (Retorno Registro Boleto).

JSON Registro Boleto

Nesta aba, será exibido as informações do Boleto (envio e retorno).

Sisfin - Botão Receber - Form Contas a Receber - Aba Detalhe-Manutenção - Botão QRCODE - Form Consulta Ocorrência - Aba JSON Registro Boleto.png

Erro

Sisfin - Botão Receber - Form Contas a Receber - Aba Detalhe-Manutenção - Botão QRCODE - Form Consulta Ocorrência - Aba Erro.png

Menu Flutuante

Sisfin - Botão Receber - Form Contas a Receber - Aba Detalhe-Manutenção - Botão QRCODE - Form Consulta Ocorrência - Menu Flutuante.png

Copiar TX ID

Sisfin - Botão Receber - Form Contas a Receber - Aba Detalhe-Manutenção - Botão QRCODE - Form Consulta Ocorrência - Menu Flutuante - OPção Copiar TX ID.png
Sisfin - Botão Receber - Form Contas a Receber - Aba Detalhe-Manutenção - Botão QRCODE - Form Consulta Ocorrência - Menu Flutuante - OPção Copiar TX ID - Tela Informativa.png

Copiar QRCODE Copia e Cola

Sisfin - Botão Receber - Form Contas a Receber - Aba Detalhe-Manutenção - Botão QRCODE - Form Consulta Ocorrência - Menu Flutuante - OPção Copiar QRCODE.png
Sisfin - Botão Receber - Form Contas a Receber - Aba Detalhe-Manutenção - Botão QRCODE - Form Consulta Ocorrência - Menu Flutuante - OPção Copiar QRCODE Copia e Cola.png

Para retornar à Página principal > Soluções NBS - Financeiro - SISFIN - Tabelas - Cobrança Bancária > Boleto online com QR CODE - PIX cobrança Itaú