Boleto Banco do Brasil

O Fácil123 emite boletos pelo Banco do Brasil usando a API de Cobrança do banco. Configurada a integração, cada boleto criado em uma venda ou em um lançamento financeiro é registrado no Banco do Brasil e, quando pago, tem o recebimento baixado automaticamente — sem precisar lançar nada no internet banking.

Importante: a titularidade da conta bancária cadastrada deve ser a mesma do CNPJ da empresa. Saiba mais em Integrações com Bancos.

Antes de iniciar, solicite ao seu gerente de contas do Banco do Brasil:

• Confirmação de que o convênio de cobrança é do tipo 4 e está ativo. Caso não esteja, ele pode ser contratado via BB Digital PJ: Contratação de Serviço → Cobrança e Pagamentos → Contratar serviço.
• Confirmação de que seu usuário possui Chave J.
• Número do convênio
• Número da carteira
• Número da variação da carteira (sem traço)
• Número da agência
• Número da conta com o dígito

Passo a passo

No Portal Developers BB

1. Clique neste link para acessar o Portal Developers BB.
2. Clique em Cadastre-se (se já tiver cadastro, faça o login e vá ao passo 3). Insira os dados solicitados → o Banco do Brasil enviará um código de confirmação para o seu celular → após a confirmação, defina a senha → faça o login e aceite os termos.
3. Vá em Aplicações → Criar nova aplicação.
4. Preencha Nome da integração com Fácil123 e Descrição com API Fácil123 → habilite Cobranças versão: 2 → Criar → clique na aplicação criada → Enviar para produção.
5. Em Identificação da empresa, digite seu CNPJ → Pesquisar CNPJ → Próximo. Em Revisão da aplicação clique em Solicitar produção → leia os Termos de Uso → selecione Li e concordo com os Termos de Uso do Portal → Concordar.
6. Clique na aplicação já em produção → Credenciais. Guarde os códigos Developer Application Key, Client ID e Client Secret — eles serão usados no Fácil123 na próxima etapa.

No Fácil123

Primeiro, cadastre a conexão com a API do Banco do Brasil:

1. Vá em Engrenagem → Conexão com API → Incluir → coloque o Nome como Banco do Brasil → no Emissor selecione Banco do Brasil – Boleto.
2. Preencha Client ID, Client Secret e Developer Application Key com os códigos obtidos no Portal Developers BB → Salvar → Testar.

Agora cadastre a conta de boleto do Banco do Brasil:

1. Vá em Financeiro → Contas → Incluir → escolha o banco Banco do Brasil → adicione o nome da conta como Conta Banco do Brasil → selecione a opção Permitir cobrança por boleto → em conta bancária digite o banco, agência e conta.

IMPORTANTE: Não coloque o número do dígito da agência.

1. Em Emissor do boleto selecione Banco do Brasil → na Conta de Repasse coloque Banco do Brasil.
2. Em Conexão com API selecione Banco do Brasil → preencha Convênio, Carteira e Variação da carteira com os dados fornecidos pelo seu gerente do BB.
3. Se desejar, preencha o Texto livre no boleto → Salvar.

Para terminar, vincule o meio de pagamento:

1. Vá no menu Vendas → Meio de pagamento → clique em Boleto → Alterar.
2. No Nome coloque Boleto Banco do Brasil → no Método de Pagto selecione Boleto → em Conta escolha Banco do Brasil → Salvar.
3. No menu Financeiro → Lançamentos → três pontinhos → Conciliar boletos.

Prontinho! Você já pode emitir boletos do Banco do Brasil pelo Fácil123.

Caso ocorram erros na emissão, avise o suporte o quanto antes para verificarmos.

Juros e multa no boleto

1. Vá em Engrenagem → Cobranças.
2. Escolha uma categoria padrão para tarifa de cobrança e para juros e multa das cobranças.
3. Adicione os juros ao mês e a multa.

Os juros e multas recebidos pelo boleto entram na mesma transação financeira que está sendo baixada.

Protesto automático

1. Vá no Menu Financeiro → Contas → localize a conta Banco do Brasil.
2. Habilite a opção Protestar após → informe a quantidade de dias após o vencimento → Salvar.

Quando preenchido de 3 a 5 dias, o Banco do Brasil comandará o protesto em dias ÚTEIS. Quando preenchido de 6 a 29, 35, 40 ou 45 dias, o Banco do Brasil comandará o protesto em dias CORRIDOS.

Negativação

1. Vá no Menu Financeiro → Contas → localize a conta Banco do Brasil.
2. Habilite a opção Negativação → informe a quantidade de dias corridos após o vencimento → Salvar.

O Banco do Brasil sempre comandará a negativação em dias CORRIDOS.

Trocando a carteira ou a variação da carteira

Você pode trocar a Carteira e a Variação da carteira a qualquer momento, mesmo com a integração já em uso.

1. Vá em Financeiro → Contas → clique na conta Banco do Brasil para editar.
2. Em Conexão com API, altere Carteira e/ou Variação da carteira → Salvar.

Atenção: esses campos não têm validação automática. Confirme com seu gerente do Banco do Brasil que a carteira e a variação novas são válidas para o seu convênio antes de salvar.

Depois de salvar, emita um boleto de teste e pague-o para confirmar que tudo continua funcionando. Se a emissão retornar erro, confirme com seu gerente do Banco do Brasil se essa variação está realmente habilitada no seu convênio.

Integração com extrato bancário

O Banco do Brasil também permite a importação automática do extrato bancário. Veja o passo a passo em Extrato Bancário Banco do Brasil.

Perguntas e respostas

1 - O que é chave J?
R: É um código que todo usuário cadastrado recebe para acessar o sistema do banco do brasil. A chave J é obtida junto ao gerente da conta no BB. A solicitação é feita pelo representante da instituição junto ao BB.

2 - Como faço para colocar no boleto as informações de juros, multa, protesto e negativação?
R: Caso o seu banco não preencha esses dados de forma automática, você pode adicionar no campo Texto livre no boleto.

3 - Ativamos a função de protesto e negativação automática mas depois desligamos. Um dos meus clientes foi negativado, por quê?
R: As cobranças que foram emitidas enquanto o protesto ou negativação automática estavam ativos serão protestados em caso de atraso. Só não serão protestados os boletos emitidos após a desativação.