Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Version History

« Previous Version 17 Next »

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.


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 se as informações de Client ID, Client Secret e Application Key contempla o Pix e a Cobrança (registro automático).

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

 

image-20241025-170305.png

image-20241025-170416.png

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.

image-20241025-182133.png

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

image-20241025-182736.png

image-20241025-175223.png

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

image-20241025-181105.png
  • 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.

image-20241025-181838.png

Processos com a configuração de Dias para Registro como zero

  1. 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:

PRINT_BOLETOO.png

boleto.png

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

image-20241025-204254.png

Cancelamento do Registro

2 . Caso seja necessário realizar o Cancelamento do Registro basta clicar no botão ‘Cancelar Registro' e clicar em ‘Sim’.

image-20241028-111832.png
  • Neste momento, o registro será cancelado e o nosso número será zerado, se for necessário o boleto deverá ser regerado.

image-20241028-112118.png

Histórico de Cobrança da Duplicata

  1. Com o botão direito na duplicata selecionada, podemos visualizar o ‘Histórico de Cobrança da Duplicata’.

image-20241028-112951.png

  • Aba ade ‘Histórico Cobrança’, podemos visualizar o registro do nosso número e seu posterior cancelamento.

image-20241028-113053.png

  • Na aba de ‘Histórico Registro Pix’, podemos visualizar a geração do Pix para esse boleto e seu posterior cancelamento.

image-20241028-113501.png

  • Com dois cliques na duplicata é aberto o seu cadastro e nele temos gravado o Pix Copia/cola e também um botão de acesso para o histórico do Pix.

image-20241028-121023.png

Registros Pendentes de Envio

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

BOLETO__SEM_QRCODE.png

  • Na rotina de impressão são listados conforme abaixo:

image-20241028-125043.png
  • 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.

image-20241028-125227.png
  • 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.

  • Todos os registros pendentes serão enviados na execução do Job conforme configuração de dia e horário, 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.

image-20241028-125401.png

image-20241028-125430.png

  • 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 cliente solicitar o QRCode do Pix, terá que ser efetuado o cancelamento deste registro e regerado este boleto e novamente registrado.

image-20241028-161044.png
  • 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.

image-20241028-161623.pngimage-20241028-162149.png

image-20241028-162220.png

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

image-20241028-162302.pngimage-20241028-162343.png


Erros Comuns

Situações que podem ocorrer durante o uso da rotina


Versão

Lote

Versão do Sistema

Versão do Banco de Dados

Versão da Documentação

Autor/Revisor

  • No labels