Conectar a integração do Banco do Brasil: campos, certificado e status

O QUE É ESTA TELA
Integração por API com o Banco do Brasil: cobrança (boleto), Pix e extrato/saldo. Não é o boleto por remessa (CNAB) — esse é outro caminho dentro do ERP.

CAMPOS PARA CONECTAR
Agência/DV, Conta/DV, Convênio, Carteira, Variação da Carteira, Application ID, Cedente, Client ID e Client Secret. Todos obrigatórios; o dígito verificador fica no campo menor ao lado do número.
- Agência: entre 1 e 4 números, mais o DV.
- Conta: entre 1 e 8 números, mais o DV.
- Convênio: código que identifica a empresa no banco, fornecido pela agência de vinculação do beneficiário; a tela pede entre 4 e 8 números.
- Carteira e Variação da Carteira: números informados pelo banco (a tela usa 17 e 35 apenas como exemplo).
- Cedente: nome do beneficiário impresso no boleto, normalmente a razão social do titular da conta; até 100 caracteres.
- Application ID: chave de desenvolvedor. Client ID e Client Secret: do aplicativo criado no portal do Banco do Brasil.
CNPJ e nome fantasia não são digitados: o sistema pega da loja/empresa logada e monta o nome da integração como "nome fantasia - CNPJ". Se vier errado, o ajuste é no cadastro da loja, não nesta tela.

GERAR CERTIFICADO
Botão no rodapé da configuração da integração, ao lado de "Salvar configurações". Ele gera, a partir do certificado digital da empresa, o arquivo de cadeia completa para subir na criação da aplicação no Banco do Brasil, e baixa direto no navegador.
Importante: esse botão só aparece depois que a integração está conectada — enquanto não estiver, a tela mostra apenas o formulário de conexão. Se não for possível gerar, o sistema exibe a mensagem de erro retornada; nesse caso, verifique o certificado digital da empresa no ERP.

SITUAÇÃO DA INTEGRAÇÃO
A tela mostra a situação da integração em inglês, sem tradução. Você vai encontrar, por exemplo, pending (pendente), connected (conectada), active (ativa) e error (com erro) — se aparecer outra palavra, ela vem do mesmo lugar e significa o estado em que a conexão está. Enquanto a integração não estiver conectada ou ativa, a tela de edição mostra só o formulário de conexão. Já conectada ou ativa, aparecem: "Informações da integração" (token de acesso, conta, agência, última atualização e o botão Desconectar), o bloco Credenciais e a área de configuração.

DESCONECTAR
O botão fica em "Informações da integração" e age na hora, sem pedir confirmação. Depois dele a tela volta ao formulário de conexão. Se a integração desconectada era a que estava selecionada no módulo, a seleção é removida — ao reconectar, escolha a integração de novo.

DEPOIS DE CONECTADO
O único botão que grava é "Salvar configurações", no rodapé da configuração. Por ele vão convênio, cedente, Client ID, Client Secret, Application ID, Último número e as configurações (formas de pagamento, multa/juros, mensagens de instrução, e-mail para alertas).
Último número: sequência do nosso número do boleto. O sistema incrementa a cada boleto emitido; ajuste se você já emitiu boletos por outro meio.
Agência, conta, carteira e variação aparecem editáveis no bloco Credenciais, mas não está confirmado que a alteração feita ali seja gravada. Se você precisa trocar um desses dados, confirme antes com o atendimento em vez de contar com essa tela.

FORMAS DE PAGAMENTO (na configuração)
"Forma para recebimento boleto" e "Forma para recebimento Pix" são obrigatórias para salvar a configuração; ao escolher a de Pix, a chave Pix também passa a ser obrigatória. Por que uma forma não aparece na lista — filtro por tipo, forma já presa a outra integração e a exigência de conta bancária vinculada — está no conteúdo de configuração do Banco do Brasil, com a ordem de conferência.

WEBHOOK
A integração tem tela própria de webhooks (botão "Obter Webhook" na configuração e a tela de webhooks da integração). O sistema avisa quando a URL não começa com https:// — o Banco do Brasil exige URL HTTPS e acessível publicamente na internet.

O QUE COSTUMA DAR ERRADO
- Aplicação ainda habilitada só para teste no portal do banco (a tela não verifica nem avisa isso).
- Forma de pagamento não vinculada, do tipo errado ou já presa a outra integração.
- Credenciais regeradas no portal e não atualizadas aqui.
- URL de webhook sem HTTPS ou não acessível pela internet.
- Confundir com o boleto por remessa (CNAB), que é outro fluxo.