Descrição
O Boleto Híbrido é uma modalidade de cobrança que combina a emissão de boletos tradicionais com a possibilidade de pagamento via Pix. Nesse modelo, o boleto contém um QRCode Pix, proporcionando mais agilidade e praticidade para o pagador, que pode escolher entre o pagamento tradicional, utilizando o código de barras ou a liquidação imediata por meio do Pix.
Além da emissão com o QRCode, será realizado o Registro Automático, que permite que o boleto seja automaticamente registrado no sistema bancário logo após a sua emissão. Isso significa que as informações do boleto são enviadas e validadas pelo banco, garantindo conformidade e a segurança das cobranças, e dessa forma, o boleto já está pronto para ser pago pelo cliente sem a necessidade de processos manuais.
Índice
Pré-Requisitos
Cadastrar uma Carteira Digital do Banco do Brasil que será utilizada para gerar o Pix QRCode nos boletos e fazer o registro automático;
Vincular essa Carteira Digital no Cabeçalho de Cobrança.
Configurações
Passo a passo
Para realizar a impressão dos boletos com QRCode Pix do Banco do Brasil é necessário cadastrar a Carteira Digital que será utilizada, desta forma, os boletos serão impressos com o QRCode para pagamento e automaticamente será realizado o registro deste boleto no banco.
Para clientes que já possuem uma Carteira Digital para Pix do Banco do Brasil é necessário confirmar junto ao banco se as informações de Client ID, Client Secret e Application Key contemplam as modalidades Pix e Cobrança. Para o funcionamento, é necessário que as credenciais sejam geradas contemplando as duas modalidades.
Acessar o menu Cadastros >> Pix/Carteira Digital e deve ser incluído as seguintes informações:
Banco | Selecionar Banco do Brasil |
Aba ‘Configurações’ - Ambiente | Selecione o ambiente em que será realizada a geração do Boleto Híbrido com o Banco do Brasil (Teste, Pré-Produção ou Produção) |
Client ID | Solicitar ao Banco do Brasil qual é o Client ID para utilizar no Boleto Híbrido |
Client Secret | Solicitar ao Banco do Brasil qual é o Client Secret para utilizar no Boleto Híbrido |
Application Key | Solicitar ao Banco do Brasil qual é a Application Key para utilizar no Boleto Híbrido |
Dias para Registro:
Se configurado como zero, o boleto será registrado no momento da impressão com o QRCode para pagamento.
Se maior que zero, o boleto será impresso sem QRCode para pagamento via Pix e o boleto será registrado posteriormente.
Em Cadastros >> Cobrança Bancária >> Cabeçalho de Remessa Bancária, na aba Principal informar o Banco do Brasil e na aba Adicionais vincular a Carteira Digital que foi incluída.
É necessário informar no Detalhe de Cobrança que é Boleto Híbrido.
Após realizar as configurações acima mencionadas, será necessário verificar se o serviço do Job (ViasoftServerConstruShowServiceJob) está em execução para que a tarefa agendada seja executada, ou seja, será na execução do Job que os registros e cancelamentos pendentes serão enviados.
No menu 'Cadastros >> Agendador de Tarefas' >> Agendamento, terá a tarefa agendada 20075-REGISTROBOLETO.
Ao dar dois cliques nesse agendamento podemos observar que está padronizado para ser executado automaticamente todos os dias às 01:02min. Caso seja alterada a configuração do Agendador, é preciso reiniciar o serviço.
Processos com a configuração de Dias para Registro como 0 dias
Ao realizar impressões de boletos nas rotinas como por exemplo, Impressão de Boletos/Recibos/Duplicatas a Receber, Cadastro de Duplicata, Nota Fiscal, Acerto de Caixa (Execução do Caixa, Finalizar, Consulta Notas Fiscais), Nota de Transporte no Caixa, Nota de Transporte na Expedição, Nota de Receita, estando com a configuração de dias para registro como zero, o boleto será impresso com QRCode e será registrado automaticamente.
A impressão do QRCode será feita em todos os modelos de Boleto (Padrão, Recibo, Recibo Entrega, Carnê e Duas vias).
No exemplo abaixo foi realizado a emissão de uma nota fiscal no caixa e após a impressão dos boletos:
1.1. Nesta nota, em todas as parcelas o QRCode foi impresso e todos foram registrados automaticamente, como pode ser visto na rotina de ‘Impressão de Boletos/Recibos/Duplicatas a Receber’.
Cancelamento do Registro
2 . Caso seja necessário realizar o Cancelamento do Registro basta clicar no botão ‘Cancelar Registro' e clicar em ‘Sim’.
Neste momento, o registro será cancelado e o nosso número será zerado, se for necessário o boleto deverá ser regerado.
Histórico de Cobrança da Duplicata
Com o botão direito na duplicata selecionada, podemos visualizar o ‘Histórico de Cobrança da Duplicata’.
Aba ade ‘Histórico Cobrança’, podemos visualizar o registro do nosso número e seu posterior cancelamento.
Na aba de ‘Histórico Registro Pix’, podemos visualizar a geração do Pix para esse boleto e seu posterior cancelamento.
Pix Copia/Cola
Na tela de impressão de boletos, com dois cliques na duplicata selecionada é aberto o seu cadastro e na duplicata 92398 que não teve cancelamento, temos a gravação do Pix Copia/Cola e também um botão de acesso para o histórico do Pix.
Registros Pendentes de Envio
Se no registro dos boletos ocorrer alguma mensagem de erro no momento da impressão, por exemplo, que ‘Não foi possível registrar o boleto’, o mesmo será impresso sem o QRCode e seu registro ficará pendente na aba de ‘Registros Pendentes de Envio’. Conforme o exemplo abaixo, somente um boleto ficou sem o QRCode, código 92432 de nosso número 103534.
Na rotina de impressão são listados conforme abaixo:
E na aba de ‘Registros Pendentes de Envio’ ficou pendente de ‘Registro’ o boleto que ficou sem o QRCode, pois não pode ser registrado no momento.
A nova aba na rotina de impressão, foi criada com esta finalidade, caso ocorra algum problema ao registrar ou ao cancelar um registro, ficará pendente nesta tela para que o usuário verifique as pendências.
Com a configuração da carteira como 0 dias, todos os registros pendentes serão enviados na execução do Job, porém, se desejar registrar ou cancelar o registro sem aguardar a execução do Job, pode ser utilizado o botão ‘Enviar’, que o registro será realizado neste momento.
Neste caso, como não houve a geração do Pix, ao visualizar o cadastro da duplicata, não terá o Pix Copia/cola, mas o boleto foi registrado e o cliente poderá pagar normalmente pelo código de barras. Se o cliente solicitar o QRCode do Pix, terá que ser efetuado o cancelamento deste registro, regerado este boleto e novamente registrado.
Ao efetuar o cancelamento de registro com menos de 30 minutos, será retornado a mensagem ‘Boleto em processamento registrado em menos de 30 minutos’. Conforme o exemplo abaixo de emissão de uma nota com boleto gerado em uma única parcela.
Neste caso, o boleto ficará sem o nosso número devido o cancelamento efetuado, porém, o cancelamento ficará pendente na aba de ‘Registros pendentes de envio' para que seja enviado através do botão 'enviar’ após os 30 min ou na execução do Job esse registro será enviado.
Processos com a configuração de Dias para Registro acima de 0 dias
Como exemplo, na carteira digital foi configurado 2 dias para registro, porém, pode ser configurado 1 dia ou mais. Essa configuração foi criada para possibilitar que os boletos não sejam registrados no momento da impressão, e se não serão registrados no momento da impressão, não poderão ter o QRCode para pagamento, somente após o registro. Essa configuração pode ser utilizada para casos em que há muitos cancelamentos de notas fiscais, pois neste caso, os boletos terão que ser também cancelados e o banco cobra taxa de cancelamento.
No exemplo abaixo foi realizado a emissão de uma nota fiscal no caixa e após realizada a impressão dos boletos e como o registro dos boletos será feito somente após 2 dias da data de emissão do boleto (data de emissão + dias da carteira), todos os boletos serão impressos sem QRCode:
Os boletos serão visualizados na rotina de impressão na seguinte forma:
Registros pendentes de Envio
Na aba de ‘Registros Pendentes para envio’, todos os boletos serão listados, pois não foram de fato ainda registrados.
Os boletos foram emitidos no dia 28/10, considerando 2 dias para registro, o Job será executado conforme horário agendado, porém, esses boletos serão registrados somente no dia 30/10, respeitando a configuração dos dias da carteira.
Obs.: Caso também tenha registros pendentes de cancelamento, na execução do Job esses registros serão enviados, pois os cancelamentos não respeitam a configuração da carteira.Se for necessário registrar o boleto sem aguardar a execução do Job, pode ser clicado no botão ‘enviar’ e o boleto será registrado no momento, conforme pode ser verificado abaixo, o boleto 92443 foi registrado manualmente, não ficando mais pendente.
Cancelamento de Registro
Caso seja clicado em ‘Cancelar registro’ nos boletos que ainda não foram registrados, não irá mostrar a mensagem de que será efetuado o cancelamento do registro conforme foi apresentado mais acima, pois este boleto ainda não foi registrado, isso quer dizer que se for realizado o cancelamento, ao realizar o registro dos demais boletos, esse que foi cancelado, não será mais registrado, conforme pode ser visualizado abaixo no boleto de código 92442.
Seguindo o exemplo, os únicos boletos que serão registrados na execução do Job, serão os códigos 92440 e 92441, pois o 92442 teve seu cancelamento ainda antes do registro e o 92443 já teve seu registro feito pelo botão enviar.
Histórico de Cobrança da Duplicata
Verificando o histórico da duplicata 92441 que ainda não foi registrada, podemos observar que no Histórico de Cobrança tem o registro referente ao nosso número que foi gerado na impressão, porém, no histórico do Pix vemos que consta que ainda não foi registrado, Enviado = N.
E também não terá a informação do Pix Copia/Cola.
Vamos clicar no botão ‘Enviar’ deste boleto para verificar como ficará o histórico após seu registro.
No histórico do Pix, ficou informado ENVIADO = S. E em seu cadastro agora possui o Pix Copia/Cola.
Impressão após o Registro
Tendo o boleto registrado, poderá ser impresso e enviado ao cliente, pois agora terá o QRCode presente em sua impressão.
Continuando com o exemplo acima, o único boleto que ficou pendente de registro é o 92440.
Cancelamento de Nota Fiscal com configuração de 0 dias
Foi realizado a impressão dos boletos com QRCode da nota abaixo.
Ao realizar o cancelamento da nota seja pelo Caixa ou pela própria tela de nota, será solicitado para fazer o cancelamento, pois os boletos já foram registrados, e caso ocorra alguma mensagem como por exemplo, que ainda está em processamento devido os 30 min, ficarão pendentes para cancelamento, visto que as duplicatas foram excluídas no cancelamento. Na execução do Job esses registros serão cancelados.
Cancelamento de Nota Fiscal com configuração acima de 0 dias
No exemplo abaixo, temos uma nota fiscal emitida com os boletos gerados sem QRCode devido a configuração estar com 2 dias para registro, e todos ficaram pendentes de registro.
Antes de realizar o cancelamento da nota, foi registrado o boleto de código 92463 através do botão enviar e o boleto de código 92462 foi ‘Cancelado Registro’. Ficando pendente somente os boletos de código 92460 e 92461.
Ao realizar o cancelamento da nota, solicitou para que fosse efetuado o cancelamento do boleto, que seria 92463 que havia sido registrado anteriormente. No cancelamento da nota, os boletos são excluídos e ficou pendente para registro de cancelamento somente o de código 92463, pois não foi possível cancelar no momento devido o tempo de 30 minutos.
Baixa Parcial de Boleto Registrado
Na tela de Baixa de Duplicatas a Receber, foi adicionado uma nova legenda em verde para filtrar as duplicatas que possuem Pix Registrado.
Ao realizar a baixa parcial de um boleto registrado é gerado um novo boleto com o valor restante. Neste caso, o novo boleto ficou sem o QRCode e pendente para registro devido a configuração da carteira estar como 2 dias.
O Nosso Número anterior 103510 teve seu registro cancelado e ficou pendente de registro o nosso número 103566 conforme configuração da carteira.
Caso seja realizado a baixa parcial e o cancelamento não possa ser efetuado no momento, como por exemplo, a mensagem de processamento de 30 min, o registro de cancelamento também ficará pendente para posterior envio.
Caso a configuração da carteira estivesse como 0 dias, o boleto seria impresso com o QRCode e já registrado automaticamente sem ficar pendente.
Regerar Boletos na rotina de Impressão
Não será permitido regerar boletos sem alteração do Nosso Número.
No processo de Regerar é informado que será alterado o nosso número e se deseja continuar, seguindo com o processo, ao visualizar o boleto para impressão, é necessário fazer o cancelamento do registro anterior. Desta forma, o nosso número 103556 foi cancelado, e o novo boleto gerado foi registrado automaticamente com o novo nosso número de 103568. O registro foi feito automático devido a configuração de 0 dias para registro.
Se o boleto foi registrado e em menos de 30 min for regerado, o cancelamento não poderá ser efetuado no momento e ficará com o nosso número pendente para posterior cancelamento. Conforme exemplo abaixo, não possível cancelar o nosso número 103571 e o boleto foi gerado com o 103572.
O mesmo ocorrerá caso o boleto seja regerado através do botão ‘Gerar arquivos’, se não foi possível realizar o cancelamento, o boleto será gerado na pasta mencionada com o novo nosso número e o cancelamento ficará pendente.
Se o boleto for regerado utilizando o botão ‘Imprimir >> Boleto’, o boleto será impresso com o novo nosso número e o cancelamento também ficará pendente caso não seja possível efetuar no momento.
Gera Remessa de Cobrança por Arquivo
Ao informar um cabeçalho que possua uma Carteira Digital vinculada, não permitirá gerar remessa por arquivo. E por mais que informe um cabeçalho de outro banco, não irá listar na rotina os boletos que possuem cabeçalho com carteira digital vinculada.
Notificação de Usuário
Foi criada uma configuração em Configurações >> Usuários >> Configuração de Grupos/Usuários se ‘Notifica Registro Cobrança’ Sim ou Não. O usuário que estiver configurado para ser notificado, será notificado na ‘Central de Notificações’ uma vez ao dia.
Para notificações de cancelamento será fixo 1 dia da data de emissão do boleto, ou seja, se passou 1 dia e ainda possui registro de cancelamento pendente, será notificado.
Para registros de boletos não enviados, será respeitado data de emissão do boleto + configuração dos dias da carteira.
Ao clicar na notificação, será aberta a tela de Impressão de boletos, focando na aba de ‘Registros Pendentes de envio’, trazendo por padrão um filtro de 7 dias.
Neste caso, considerando que hoje é 29/10 e que na carteira está configurado 2 dias para registro, o usuário foi notificado devidos os cancelamentos por ser fixo 1 dia a partir da data de emissão (24/10 + 1 dia = 25/10, 28/10 +1 dia= 29/10 e hoje é dia 29/10.
Ainda considerando que hoje é 29/10, tendo somente os registros pendentes abaixo, se configurar 0 dias na carteira, o usuário será notificado, se configurar 1 dia, o usuário será notificado somente no dia 30/10 caso ainda houver pendência.
Versão
Lote | Data Liberação | Versão do Banco de Dados | Versão da Documentação | Autor/Revisor |
---|---|---|---|---|
04/11/2024 | 24092 | 1.0 | Carine |