Como Configurar o Banco do Brasil como Provedor Próprio de Boletos

Para emitir boletos pelo Banco do Brasil no Berga, crie uma aplicação no Portal Developers BB com a API Cobranças, informe as credenciais e o convênio em Configurações › Boleto Banco do Brasil e cadastre o endereço de aviso de pagamento no portal. Os boletos passam a sair em nome da sua empresa, com QR Code Pix, e o pagamento cai direto na sua conta.

Abrir Boleto Banco do Brasil

Antes de começar

• Conta corrente Pessoa Jurídica no Banco do Brasil
• Convênio de cobrança contratado com a sua agência. Peça à pessoa gerente da conta o número do convênio (7 dígitos), a carteira e a variação da carteira
• Chave Pix cadastrada na conta, para o boleto sair com o QR Code Pix
• Acesso ao Portal Developers BB (developers.bb.com.br) com o usuário da empresa

Como criar a aplicação no Portal Developers BB

1. 1
   Entre em developers.bb.com.br e clique em Criar uma nova aplicação.
2. 2
   Dê um nome (por exemplo, "Berga") e uma descrição.
3. 3
   Inclua a API Cobranças com as permissões de consultar e registrar boletos.
4. 4
   Peça a liberação da aplicação para produção. O Banco do Brasil pode pedir que a pessoa responsável pela conta aprove o acesso; se a liberação travar, fale com a sua gerência informando que a API Cobranças é para o convênio de boletos.
5. 5
   Com a aplicação em produção, abra Credenciais e copie o Client ID, o Client Secret e a developer_application_key.

As credenciais de teste (homologação) não servem para o Berga: use sempre as de produção.

Como configurar o Banco do Brasil no Berga

1. 1
   Acesse Configurações › Boleto Banco do Brasil.
2. 2
   Ative Emitir boletos pelo Banco do Brasil.
3. 3
   Em Aplicação no Portal Developers BB, cole o Client ID, o Client Secret e a Chave da aplicação (developer_application_key).
4. 4
   Em Convênio de cobrança, preencha Número do convênio, Carteira, Variação da carteira, Agência e Conta corrente (agência e conta sem o dígito).
5. 5
   Se você já emitiu boletos neste convênio fora do Berga, informe em Próximo nosso número um número maior que o último usado. O Banco do Brasil não aceita nosso número repetido. Em branco, o Berga começa do 1.
6. 6
   Clique em Salvar configurações.

Depois de salvar, o quadro de status no topo da tela testa as credenciais e a conexão com o Banco do Brasil. Se algum item aparecer com erro, a mensagem indica o que corrigir.

Ao voltar à tela, Client ID, Client Secret e chave da aplicação aparecem mascarados. Para alterar só o convênio, deixe esses três campos em branco e salve: os valores atuais são mantidos.

Como cadastrar o aviso de pagamento (webhook)

O aviso de pagamento faz o Berga dar baixa sozinho no boleto pago no Banco do Brasil.

1. 1
   Em Configurações › Boleto Banco do Brasil, na seção Aviso de pagamento (webhook), clique em Copiar endereço.
2. 2
   No Portal Developers BB, abra a sua aplicação e entre em Webhook.
3. 3
   Informe o número do convênio, cole o endereço copiado e um e-mail de contato, e salve.

Antes de dar baixa, o Berga confere o pagamento no Banco do Brasil. Por isso o boleto pago pode levar alguns minutos para aparecer como recebido.

Como definir o Banco do Brasil como provedor padrão

1. 1
   Acesse Configurações › Financeiro.
2. 2
   Em Provedor de boleto padrão, selecione Banco do Brasil (sua conta) no campo Provedor padrão.
3. 3
   Clique em Salvar provedor padrão.

O provedor padrão já vem selecionado ao emitir boletos no faturamento e no boleto avulso. Em cada emissão ainda dá para escolher outro provedor.

Resultado esperado

O boleto é registrado no Banco do Brasil com a sua empresa como beneficiária, sai no modelo de boleto do Berga com o QR Code Pix no recibo do pagador e, quando pago, é baixado automaticamente. Faturas com duas ou mais parcelas recebem os boletos em formato de carnê.

Se der errado

Artigos relacionados

• Como Configurar o Sicoob como Provedor Próprio de Boletos
• Como Configurar o Sicredi como Provedor Próprio de Boletos
• Por que o Boleto Aparece com o Nome da Prospera como Beneficiário