Banco do Brasil por API x boleto por remessa (CNAB): qual é qual

O ERP tem dois caminhos diferentes que se chamam "Banco do Brasil". Eles não são a mesma coisa, não usam o mesmo cadastro e não se comportam do mesmo jeito. A maior parte dos atendimentos de BB começa errado porque ninguém perguntou qual dos dois o cliente está usando. Antes de qualquer orientação, descubra isso.

COMO O SISTEMA SEPARA OS DOIS

A diferença mora em um único lugar: o banco escolhido na forma de pagamento.

De um lado está a integração do Banco do Brasil por API. É o caminho de boleto e Pix, e tem aplicativo próprio dentro do sistema.

Do outro está o Banco do Brasil de boleto por remessa e retorno, o arquivo CNAB. Não há integração nenhuma no meio: o sistema monta o arquivo, você envia ao banco e depois traz o retorno de volta.

É o mesmo campo para os dois. Ou seja, uma forma de pagamento pertence a um caminho ou ao outro, nunca aos dois. Se você tem os dois cadastrados, quem manda é a forma de pagamento que está no lançamento — não existe "o que está valendo" no geral.

O JEITO MAIS RÁPIDO DE SABER QUAL É O SEU

Abra a forma de pagamento do boleto no ERP e olhe o cadastro.

Se ela for da integração por API, o ERP mostra o aviso "Algumas configurações devem ser realizadas através do aplicativo do Banco do Brasil, clique aqui para gerenciar esta integração", com o link que leva ao aplicativo do Banco do Brasil.

Se ela for de remessa, esse aviso não existe. O que aparece são os campos do boleto bancário: agência, conta, carteira, convênio, modalidade de carteira, CNAB, espécie de documento e dias de protesto.

Esse aviso é o teste mais confiável, porque ele só é montado para os bancos que têm integração cadastrada, e o Banco do Brasil de remessa não é um deles.

POR QUE TANTA GENTE CONFUNDE

Na Gestão de Cobranças existe a tela de meios de pagamento, com uma lista fechada de bancos. Nessa lista o Banco do Brasil aparece uma única vez, e é o de REMESSA. A integração do BB por API não está lá.

A lista é fechada e é esta, inteira. Por API: Conta Integrada, Banco Inter, PagHiper, GerenciaNet, PagSeguro, Mercado Pago, Cora, Iugu e Asaas. Por remessa: Banco do Brasil, Santander, Caixa Econômica, Itaú, HSBC, Bradesco, Sicoob, Sicredi, Banco do Nordeste e Banrisul.

Cada item de API tem uma tela própria. Os itens de remessa não levam a tela nenhuma, de propósito: não existe tela de conexão para remessa, porque não há nada a conectar. É por isso que o cliente cadastra o Banco do Brasil nessa lista e diz que "não abre tela nenhuma" — está correto, é assim mesmo. E quando ele pede para habilitar mais um banco por ali, só os de remessa são oferecidos.

Resultado: quem procura o BB por API nessa tela encontra o de remessa, acha que é a mesma coisa e sai configurando o caminho errado.

Detalhe útil: quando você habilita um banco por essa tela, o ERP cria uma forma de pagamento chamada "Boleto" mais o nome do banco, já marcada como boleto. E ela fica presa àquele banco: tentar reaproveitar a mesma forma em outro banco responde "A forma de pagamento já está vinculada a outro banco."

O QUE O SISTEMA EXIGE NO BB POR REMESSA

Agência, conta e convênio são os três dados que o sistema cobra. Com qualquer um deles em branco, o ERP barra o boleto por remessa — por exemplo ao compartilhar o boleto por link, e-mail ou WhatsApp — com uma mensagem genérica de dados incompletos, sem dizer qual campo falta. O convênio não é gerado pelo ERP: ele vem do seu contrato de cobrança com o banco, e quem informa é o banco.

Carteiras aceitas — lista fechada, o sistema oferece estas oito e nenhuma outra: 11, 12, 15, 16, 17, 18, 31 e 51.

Modalidade de carteira — lista fechada de quatro: Simples, Vinculada, Descontada e BBVendor.

Leiaute — CNAB 240 ou 400. São as duas únicas opções.

Carteiras 15, 16 e 18 são tratadas pelo sistema como cobrança SEM registro. Boleto sem registro não entra em remessa. Se você escolheu uma delas e está procurando onde gerar o arquivo, a resposta é que não há arquivo a gerar. As carteiras que o sistema marca como registradas são 11, 12, 17, 31 e 51 — a carteira 17 serve e é registrada.

Trocar a carteira depois muda esse comportamento, porque o registro é derivado da carteira no momento em que a forma de pagamento é salva.

POR QUE NADA É AUTOMÁTICO NA REMESSA

Registrado quer dizer que o banco só reconhece o boleto depois de receber o arquivo. Por isso, enquanto o lançamento não estiver em uma remessa já gerada, ao imprimir o boleto pelo ERP, logado na empresa, aparece o aviso: "Este boleto ainda não foi registrado, você deve enviar o arquivo de remessa para o banco." Vem junto um link para imprimir assim mesmo — e imprimir assim mesmo não registra nada no banco, só imprime o papel. Esse aviso é para dentro de casa: no link público, que o cliente final abre sem login, o boleto sai normalmente.

O ciclo tem três passos, todos seus:

Primeiro, gerar o arquivo de remessa no ERP. No BB ele sai com extensão .rem e marca os lançamentos incluídos como remessa gerada.

Segundo, enviar esse arquivo ao banco, pelo canal que o banco fornece. O ERP não envia nada ao banco nesse caminho — ele entrega o arquivo para você baixar.

Terceiro, importar o arquivo de retorno no ERP.

E a importação do retorno também não é automática. O ERP lê o arquivo, mostra os lançamentos encontrados e dá baixa somente nos que você marcar e confirmar. Retorno importado sem marcar nada não baixa nada. É também nessa hora que você decide se juros e multa, desconto e tarifa do banco entram no lançamento.

Se a remessa saiu errada, o ERP tem o estorno de remessa: ele devolve o lançamento para a situação de remessa não gerada, e você gera de novo. Quem faz isso precisa da mesma permissão de gerar remessa.

O CAMINHO POR API, E POR QUE ELE É DIFERENTE

No caminho por API não existe arquivo. O lançamento é registrado direto contra o serviço bancário, e a confirmação do pagamento volta sozinha: o serviço avisa o ERP, de forma autenticada, e a baixa é aplicada no lançamento. Sem .rem, sem retorno, sem seleção manual.

Duas particularidades explicam por que a emissão do BB por API não se comporta igual à do Banco Inter ou à da Conta Integrada.

A primeira: a emissão do Banco do Brasil por API acontece fora do ERP. O ERP não executa a emissão dentro dele mesmo — ele encaminha a operação para o serviço de pagamentos, e o que volta é a resposta desse serviço. Banco Inter, Cora e Conta Integrada têm tratamento próprio dentro do ERP em partes do fluxo; o BB, não. Quando o comportamento de emissão parecer "diferente", é por aqui.

A segunda: o Banco do Brasil por API precisa estar liberado para a empresa. Não estando, a emissão não sai. Antes de tratar isso como contratação, olhe o botão do card dele em Meus aplicativos › Ver todos os aplicativos. Se estiver escrito TESTAR GRÁTIS, você mesmo liga na hora, por 7 dias, sem falar com ninguém. Se estiver ACESSAR e mesmo assim não abrir, o teste já foi usado ou o prazo acabou — aí sim o caso é de contratação.

AS MENSAGENS, E O QUE CADA UMA DENUNCIA

No BB por API, com usuário logado, a trava de plano aparece como "O seu plano atual não lhe permite acessar a integração com o Banco do Brasil. Por favor, contrate outro plano!" ou "O seu plano atual não lhe permite utilizar a integração com o Banco do Brasil. Por favor, contrate outro plano!". No link público de boleto ou Pix, que o cliente final abre sem login, a mesma trava aparece como "Este lançamento não está disponível!" — genérica de propósito, para não expor a situação da empresa a quem está pagando.

No caminho de remessa, a trava de plano que existe é a da tela de gerar remessa: "O seu plano atual não lhe permite gerar boletos bancários, Por favor, contrate outro plano!".

Se a mensagem cita "a integração com o Banco do Brasil", é o caminho por API. Se cita boletos bancários, é remessa.

O QUE COSTUMA DAR ERRADO

Cadastrou o BB na Gestão de Cobranças esperando integração. Aquilo é o de remessa. Não abre tela porque não tem tela.

Boleto não baixa sozinho na remessa. Não é defeito. No caminho de remessa a baixa só vem do retorno que você importar e confirmar.

Importou o retorno e não baixou. Quase sempre é porque os lançamentos não foram marcados antes de confirmar. Também vale conferir se o retorno é da mesma forma de pagamento e da mesma conta usada na remessa.

Escolheu carteira 15, 16 ou 18 e procura a remessa. Essas carteiras são sem registro no sistema e não geram arquivo.

Falta convênio, agência ou conta. Com qualquer um dos três em branco, o boleto por remessa é barrado com mensagem genérica, sem apontar o campo. Confira os três no cadastro.

Tem os dois cadastrados e não sabe qual está valendo. Olhe a forma de pagamento gravada no lançamento — é ela quem decide, lançamento a lançamento.

Banco do Brasil não liberado para a empresa. A emissão por API não sai e o link público mostra "Este lançamento não está disponível!". Não é configuração: confira o botão do card em Meus aplicativos › Ver todos os aplicativos antes de falar em contratação.

O QUE É DO ERP E NÃO SE RESOLVE AQUI

Forma de pagamento, conta bancária e lançamento financeiro são cadastros do ERP e se respondem pelas fontes do ERP — inclusive os campos de boleto, os juros e multa e a conta bancária vinculada. Esta fonte só trata do que separa os dois caminhos do BB.

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.

Uma regra que vale para os dois caminhos e vive nessas fontes: antes de a integração funcionar precisa existir uma forma de pagamento apontando para ela; se a forma desejada não aparece na lista, é porque já está vinculada a outra integração.

A conexão do Banco do Brasil por API — credenciais, habilitação da aplicação e testes — é assunto da fonte de conexão do BB, não desta. Nunca peça nem repita chave, token ou certificado no atendimento; se o cliente colar uma credencial na conversa, oriente a gerar outra no portal do banco.