BCO - Automação de Recebimentos via QR Code com Baixa e Alerta por E-mail - WebHook.

Foi implementada no sistema Globus a baixa automática, via API, de pagamentos realizados por QR Code no processo de cobrança  conhecido como WebHook  tanto para QR Codes avulsos quanto para boletos híbridos.

Além da baixa no sistema, a funcionalidade também envia uma notificação por e-mail informando o recebimento do valor, trazendo mais agilidade e controle para o acompanhamento financeiro.

1 - Parametrizando o WebHook para as baixa automáticas:

Na tela de parametrização, devemos acessar a aba WebHook e cadastrar um usuário que será o responsável por todas as baixa automáticas realizadas por QR Code e envio das notificações quando realizado a baixa no sistema.

Esse cadastro é obrigatório para utilização das baixas automáticas via API, no campo Info tem uma breve descrição.

Será possível informar o usuário de três formas: digitando diretamente no campo, pressionando "Enter" para buscar ou clicando na lupa para abrir a tela de pesquisa.

Ao abrir o browser de pesquisa, será exibida a lista de todos os usuários cadastrados. Nessa tela, há uma coluna específica que indica se o usuário possui parametrização de e-mail vinculada ao seu cadastro no módulo Controle.

A parametrização de e-mail no cadastro do usuário não é obrigatória. No entanto, é importante destacar que, sem essa configuração, não serão enviados e-mails de notificação sobre os recebimentos realizados.

Caso seja indicado um usuário que não possui essa parametrização, será exibida uma janela com a seguinte informação:

URLs

Deverão ser informadas as URLs de WebHook que serão utilizadas para o recebimento das notificações de pagamento enviadas pela instituição bancária. Essas notificações permitem que o sistema identifique a liquidação das cobranças Pix e realize a baixa automática dos documentos.

Devem ser configuradas duas URLs:

• URL Base WebHook Pix: utilizada para notificações de pagamentos Pix avulsos (QR Code).

• URL Base WebHook Boletos: utilizada para notificações de pagamentos referentes a boletos com QR Code Pix.

As URLs informadas devem corresponder ao servidor onde o WebHook está instalado, responsável por receber as notificações enviadas pelo banco por meio da API. Essa URL é utilizada para cadastro no sistema e para a geração do token de comunicação, processo que deve ser realizado pelo administrador do sistema Globus.

Como o usuário responsável será utilizado como padrão para os recebimentos via PIX e também será o remetente das notificações, disponibilizamos um campo para associar os usuários que deverão receber essas notificações por e-mail. 

No botão Info tem a instrução para incluir e excluir os usuários

Será possível informar o usuário manualmente ou abrir o browser de pesquisa para realizar a seleção. 

Ao abrir o browser de pesquisa, será exibida uma coluna que apresenta o e-mail vinculado ao cadastro do usuário. 

Se tentarmos vincular um usuário sem e-mail não será possível.

Exemplo de associação de usuário com e-mail vinculado.

Se tentamos incluir um usuário já associado o sistema também não permite

2 - Simulação do processo no sistema Globus:

Após a realização da parametrização, sempre que houver um boleto híbrido em que o cliente opte pelo pagamento via QR Code, ou nos casos de QR Code avulso (gerado na tela de Alteração de documentos ou na Emissão de fatura), o sistema realizará a comunicação direta com o banco por meio do WebHook.

Quando o pagamento for identificado, o banco enviará a notificação ao sistema, que efetuará a baixa automática do documento no Globus.

Os usuários vinculados para recebimento de notificações também receberão um e-mail com as informações do pagamento realizado.

No exemplo abaixo emitimos um boleto hibrido ao qual o cliente efetuou o pagamento através do QR Code:

Segundos após o pagamento, ao consultar o documento no Globus, ele já estará baixado, com as devidas integrações realizadas com o módulo Banco e a Contabilidade. 

Ao analisar o log, o usuário responsável apresentado é aquele que está parametrizado no sistema.

E o usuário associado para receber a notificação recebe o e-mail com os dados do pagamento.

Obs.: A estrutura do e-mail é a mesma para o pagamento do QR Code avulso, quando não for por geração de boleto.