Integração com o Banco do Brasil

May
May
  • ✎ Criado em:
  • ✔ Atualizado em:

Resumo:

1. O Gestão do Escritório integra-se ao Banco do Brasil via API para registro instantâneo de boletos, eliminando arquivos de remessa. 

2. Para ativar, é necessário obter credenciais no Portal Developers do BB, criando uma aplicação vinculada ao CPF do administrador da empresa

3. Depois, configura-se as credenciais (ClienteID, ClientSecret, ConvenioApiKey) no Gestão do Escritório, tornando a emissão de boletos automática e prática.

  • Caminho rápido: Financeiro > Minhas contas > Emite boleto > Salvar

 

Ícone quadrado com gráfico sobreposto em tons de roxo e representando o produto Gestão do Escritório.

🎯 Pré-requisitos


 

 

🏦 Integração com o Banco do Brasil via API


 

O Gestão do Escritório permite integração com o Banco do Brasil por meio de API, oferecendo mais agilidade e praticidade para o registro de boletos.

Com essa integração:

  1. Os boletos são registrados instantaneamente;
  2. Não é necessário gerar e enviar arquivos de remessa;
  3. Todo o processo ocorre automaticamente dentro do sistema Gestão do Escritório.

 

🔐 Obtendo as credenciais da API do Banco do Brasil


 

Para ativar a transmissão instantânea, siga as orientações abaixo, utilizando os dados do titular da conta corrente (administrador da empresa):

 

1️⃣ Acessando o Portal Developers do BB

Tela de login do Portal Developers do BB. Exibe campo para digitar usuário e senha e o botão Entrar.

2️⃣ Criando a aplicação

  • Faça o login;
  • Clique em Criar nova aplicação.

Tela de aplicações do Portal Developers do BB. Destaca um campo Busca e alguns filtros.

3️⃣ Preenchendo os dados da aplicação

  • Dê um nome e uma descrição à aplicação (esses dados são livres e não impactam na cobrança);
  • Deixe o campo URL da aplicação em branco.

Tela de cadastro de nova aplicação no Portal Developers do BB.

  • Em Serviços disponíveis, selecione o produto Cobranças;
  • Role até o final da página e clique em Criar.

Menu de serviços disponíveis no Portal Developers do BB. Destaca-se o botão Cobranças.

4️⃣ Solicitando as credenciais de produção

  • Clique na aplicação criada;
  • A tela de Detalhes da aplicação será exibida;
  • Acione o botão Enviar para produção;
  • Você será redirecionado para a tela Solicitar produção.

Tela de aplicações do Portal Developers do BB. Destaca a aplicação de teste recém cadastrada.

Tela de detalhes da aplicação do Portal Developers do BB. Exibe menu com botões para Credenciais, Time, Certificados, APIs, Webhook e URLs.

5️⃣ Preenchendo os dados da empresa

  • Informe o CNPJ da empresa;
  • Acione o botão Pesquisar CNPJ;
  • Verifique os dados da razão social exibidos;
  • Para prosseguir, clique em Próximo.

Exibe tela de solicitação de ambiente de produção no Portal Developers do BB. Destaca botão Pesquisa CNPJ e, ao final da página, exibe o botão Próximo.

6️⃣ Revisando e finalizando o cadastro da aplicação

  • Revise as informações da aplicação;
  • Se tudo estiver correto, clique em Solicitar produção.

Tela de solicitação de produção em seu passo 2 referente à revisão da aplicação. Exibe informações da aplicação cadastrada e botão Solicitar produção.

ℹ️ Caso o cadastro esteja corretamente vinculado ao CPF do administrador da empresa, as credenciais de produção serão liberadas automaticamente.

Para visualizá-las:

  • Retorne à tela de Detalhes da aplicação.
  • Clique em Credenciais;
  • Acione o botão Produção.

Tela de credenciais do Portal Developers do BB. Destaca os parâmetros developer_application_key, client_id e client_secret.

 

⚙️ Configurando as credenciais no Gestão do Escritório


 

Antes de configurar as credenciais da API do Banco do Brasil no Gestão do Escritório, se certifique que você atende aos Pré-requisitos citados anteriormente. Caso sim, prossiga com os passos abaixo:

 

  • Acesse o menu Financeiro → Minhas contas;
  • Clique em Incluir nova conta ou edite uma conta já existente do Banco do Brasil;
  • Para exibir a seção Configurações de boleto, marque a opção Emite boleto.

Tela de cadastro de dados da conta corrente no Gestão do Escritório. Exibe campos para inserir Banco, Nome da conta, Agência, Conta, Tipo pessoa, Saldo, etc.

  • Preencha os campos referentes aos dados bancários:
    • Carteira;
    • Variação;
    • Convênio (se houver);
    • Nosso número.

Local de configuração do boleto. É possível inserir informações nos campos Carteira, Variação, Convênio e Nosso número.

  • Preencha os campos obrigatórios (marcados com *):
    • ClienteID;
    • ClientSecret;
    • ConvenioApiKey.

Exibe campos para inserção das credenciais ClienteID, ClientSecret e ConvenioApiKey.

  • Após o preenchimento todos os campos, finalize a configuração clicando em Salvar.

Ao final da configuração da conta no Gestão do Escritório é exibido o botão Salvar na cor verde.

Configuração concluída com sucesso!

Sua conta está apta para ser utilizada na emissão de boletos, com integração automática por meio de API.

Relativo a

Compartilhe nas redes sociais:

Esse artigo foi útil?