Configurar o Banco do Brasil: formas de pagamento, chave Pix, multa, juros e instruções

A configuração da integração Banco do Brasil por API (boleto, Pix e extrato) reúne formas de pagamento, chave Pix, multa/juros, mensagens de instrução e e-mail de alertas. Não confunda com o Banco do Brasil por remessa (arquivo CNAB): é outro caminho.

FORMAS DE PAGAMENTO SÃO TELAS DO ERP
Os campos buscam formas de pagamento do financeiro do ERP. A lista sai do próprio cadastro de formas de pagamento do financeiro, e não de um cadastro próprio do banco. O cadastro da forma em si se responde pelas fontes do ERP.

O card "Forma de pagamento" tem três campos: "Forma para recebimento boleto" e "Forma para recebimento Pix", ambos obrigatórios, e "Forma de pagamento" (opcional, usado ao realizar pagamentos). As regras abaixo valem para os dois campos de recebimento — o campo "Forma de pagamento" usa uma busca diferente, que varre todos os bancos e exclui as formas já ligadas a esta integração.

POR QUE A FORMA NÃO APARECE NA LISTA
Nos dois campos de recebimento, a busca devolve apenas formas que atendam a tudo isto:
1) Estar livre ou já ser desta integração — só entram formas que ainda não estão ligadas a banco nenhum, mais as que já pertencem a esta integração. Forma já vinculada a outra integração fica de fora, sem nenhuma mensagem na tela.
2) Ser do tipo certo — "Forma para recebimento boleto" só lista formas do tipo Boleto Bancário; "Forma para recebimento Pix" só lista formas do tipo Pagamento Instantâneo (PIX). Forma criada com o tipo errado não aparece, mesmo estando livre.
3) Ter conta bancária vinculada — a busca exige conta bancária na forma, então forma sem conta bancária nunca aparece. Por isso cada item da lista mostra "Conta bancária: ..." embaixo do nome. Com mais de uma loja cadastrada, a conta bancária ainda precisa estar vinculada à loja em que você está.

Confira nesta ordem: 1) o tipo da forma bate com o campo; 2) a forma tem conta bancária (e, com várias lojas, essa conta está na sua loja); 3) a forma já está vinculada a outra integração; 4) crie outra forma pelo botão de adicionar do próprio campo.

CHAVE PIX
O campo "Chave Pix" só aparece depois que você escolhe a forma para recebimento Pix. Antes disso ele não está na tela. Se você limpar a forma de recebimento Pix, a chave é apagada junto e precisa ser digitada de novo.

MULTA / JUROS
Os tipos de multa e de mora vêm do próprio banco: o sistema mostra a lista que recebe. O valor fica bloqueado e é limpo automaticamente enquanto o tipo for sem multa (multa) ou isento (mora). Escolhendo qualquer outro tipo, o valor passa a ser obrigatório.

MENSAGENS DE INSTRUÇÃO
São quatro linhas de instrução do boleto, de até 78 caracteres cada. A própria tela avisa: use {multa} para destacar o valor de multa e {mora} para destacar o valor de correção diária por atraso. Em integração nova, as duas primeiras linhas já vêm preenchidas com um texto padrão, que você pode trocar.

NOTIFICAÇÕES
O "Email para alertas de pagamento" é obrigatório e precisa ser um e-mail válido. Serve para avisar quando ocorrer algum problema na confirmação automática dos pagamentos recebidos (Pix, boleto etc.).

O QUE COSTUMA DAR ERRADO
Salvei e não gravou: nada é gravado até clicar em "Salvar configurações", e o botão valida o formulário antes de enviar. Se algum obrigatório estiver vazio — forma para recebimento boleto, forma para recebimento Pix, chave Pix, e-mail de alertas, ou o valor de multa/mora quando o tipo não for sem multa/isento — nada é enviado. "Cancelar" descarta as alterações e volta para a listagem de integrações.