Banco do Brasil: visão geral e índice da pasta
O Banco do Brasil é uma das integrações bancárias por API do sistema, na mesma família do C6 Bank e do Banco Inter. Esta fonte é o mapa da pasta: diz o que a integração faz, qual é a primeira pergunta do atendimento e para qual fonte ir em cada assunto. O detalhe está nas outras.
O QUE A INTEGRAÇÃO FAZ
A própria tela de conexão resume em três itens: extratos e saldo, gestão de Pix (receber pagamento instantâneo pelo sistema) e cobranças (gerar e controlar boleto). O módulo tem aplicativo próprio dentro do sistema, com tela de Extrato.
Uma ausência proposital: o painel do Banco do Brasil é montado sem o atalho de Pagamentos. O motivo é limitação de autenticação do banco. Pagar contas pelo BB dentro do sistema não é o caminho.
A PRIMEIRA PERGUNTA DO ATENDIMENTO
Existem dois "Banco do Brasil" no ERP e eles não são a mesma coisa: a integração por API (boleto e Pix, com tela própria) e o boleto por remessa e retorno em arquivo CNAB (sem integração nenhuma, configurado dentro da forma de pagamento). Descubra qual é o do cliente antes de orientar qualquer coisa — é o mal-entendido que mais custa tempo nesta pasta. Como separar um do outro, o que cada caminho exige e as mensagens que denunciam cada um estão na fonte que compara os dois caminhos.
A ORDEM QUE FUNCIONA
Um: existe uma forma de pagamento apontando para a integração. Como em toda integração de meio de pagamento, sem isso nada anda. Se a forma que você quer usar não aparece na lista, ela já está vinculada a outra integração — o caminho é criar outra.
Dois: a integração está conectada. Enquanto ela não estiver conectada, a tela mostra só o formulário de conexão.
Três: a configuração está salva — forma para recebimento boleto, forma para recebimento Pix, chave Pix e e-mail para alertas de pagamento são obrigatórios.
Quatro: o webhook está registrado no banco e com a URL certa. É por ele que chega a confirmação do pagamento.
Um aviso sobre o passo um: a aplicação criada no portal do Banco do Brasil precisa estar habilitada para produção, e não só em ambiente de teste. Isso é orientação de atendimento: o ERP não verifica nem avisa nada disso, então a tela pode parecer certa com a aplicação ainda em teste.
PARA ONDE IR
Conectar — agência, conta, convênio, carteira, cedente, credenciais, gerar certificado, status e desconectar: fonte de conexão do Banco do Brasil.
Configurar — formas de recebimento, chave Pix, multa e juros, mensagens de instrução do boleto, e-mail de alertas, e por que uma forma de pagamento não aparece na lista: fonte de configuração.
Dia a dia — emitir boleto, receber Pix, links de impressão, extrato, gerar contas a receber: fonte do dia a dia.
Pagamento que não deu baixa sozinho — webhooks, notificações, histórico e reprocessar: fonte de webhooks.
Quem enxerga cada tela — permissões de extrato, saldo, Pix e transações dentro do próprio aplicativo: fonte de permissões do aplicativo.
API x remessa CNAB — carteiras, arquivo de remessa, retorno e as travas de plano: fonte que compara os dois caminhos.
O QUE NÃO É DESTA PASTA
Cadastro de cliente, forma de pagamento, conta bancária e lançamento financeiro são cadastros do ERP e se respondem pelas fontes do ERP. O roteiro comum de integrar um meio de pagamento e o funcionamento geral do Pix estão na pasta Meios de pagamento. O índice de integrações, o vínculo por loja e o efeito de remover uma integração estão na fonte raiz de Integrações.
O QUE É DO BANCO
Tarifas, limites, prazos de liquidação e a aprovação da conta são do Banco do Brasil. O sistema não define nem consulta isso, e os passos dentro do portal do banco mudam sem aviso. Credencial não circula no atendimento: não peça nem repita chave, token, senha ou certificado. Se o cliente colar uma credencial na conversa, oriente a gerar outra no portal do banco.