Passar para o conteúdo principal

Configurando a Integração com o Banco do Brasil | Boleto + Pix via API

Neste artigo, descubra como configurar a Integração com o Banco do Brasil para a geração de boletos + PIX, através da API.

Escrito por Laura Silva

Com a integração entre o Banco do Brasil e o Omie via API, sua rotina de geração de Boletos com QR Code Pix ficou muito mais fácil!

Esqueça a complicação de criar e enviar arquivos de Remessa, tudo é feito automaticamente, diretamente no seu sistema Omie.

É a tecnologia trabalhando por você, simplificando seus processos e deixando mais tempo para o que realmente importa: o crescimento do seu negócio! 🚀

📣 Informações Importantes

  • Os boletos gerados pela integração via API, somente podem ser cancelados ou prorrogados, 30 minutos após o seu registro;

  • Alterações de Valor para Bolecode que o Boleto seja cancelado e emitido novamente;

  • No Omie, a baixa das contas a receber ocorre automaticamente via API mediante a liquidação bancária, independentemente se o pagamento foi realizado via PIX ou boleto;

  • Caso precise, é possível prorrogar a data de vencimento do Bolecode conforme demonstrado aqui. No caso do Boleto + PIX, a informação é enviada pela integração via API;

  • No momento, a integração API está habilitada exclusivamente para a geração de Boletos e Boletos + PIX, desta forma, não é possível ativar a integração API apenas para a geração do Pix;

  • O PDF do Boleto é gerado diretamente no Omie, junto com o QR Code do PIX.

Tópicos do Artigo:


Pré-requisitos


Para configurar o Boleto + PIX, é necessário ter:

  • A configuração da carteira de cobrança contratada;

  • Credenciais da API do banco configuradas.

Se você ainda não utiliza ou não tem o produto contratado, você pode adquiri-lo de forma online ou através do gerente de relacionamento do Banco do Brasil.


Configurando a Cobrança Bancária

Antes de tudo, é necessário configurar a Cobrança Bancária, pois é a partir dela que obteremos os dados necessários para gerar o boleto!

Para isso, confira o passo a passo abaixo:


Obtendo as Credenciais da API de Integração

Para obter as credenciais da API de integração (Client ID e Client Secret), é necessário seguir um processo no Portal do Banco do Brasil, conforme o passo a passo abaixo:

⚠️ Lembrando que, conforme as orientações da documentação acima, as credenciais devem ser geradas em Produção.

Em caso de dúvidas no passo a passo da criação do Client ID e Client Secret, procure pelo seu Gerente Bancário. Alinhe com ele e siga os passos para que essa automatização aconteça por completo


Ativando a integração API para geração de Boleto + PIX

1) Após obter as credenciais da API no Portal do BB, no Omie, acesse o cadastro da Conta Corrente, e clique na aba "Integração com o Banco (API)" (1).

Em seguida, clique na opção "Registrar automaticamente os Boletos gerados" (2):


2) Para a geração do Boleto + Pix, após a ativação do registro dos Boletos, clique em "Gerar Boletos de Cobrança com Pix".

Com isso, o QR Code do PIX será incluído dentro do mesmo arquivo com o boleto, dando opção ao Cliente de pagar das duas formas:

3) Agora, é necessário habilitar a integração informando as credenciais de acesso. Para isso, clique na opção "Para habilitar a integração, clique aqui e informe as credenciais de acesso (Boletos)":

4) Informe as credenciais de acesso "Client ID" e "Client Secret" (1). Em seguida, clique em "Salvar credenciais" (2):

5) Com a emissão de Boleto + PIX ativa, clique em "Salvar":

💡 Exemplo de Boleto:

Separamos um exemplo de Boleto + PIX gerado:

6) Tudo pronto! Agora você já pode gerar o seu Boleto + Pix em suas Contas a Receber:

💡 Você também pode parametrizar para que o Bolecode seja gerado no momento de seu Faturamento:


Taxas e Limites

A taxa cobrada na emissão do Boleto + PIX varia conforme o plano contratado diretamente com o Banco do Brasil. Recomendamos que você verifique com o seu gerente os detalhes sobre a cobrança da taxa.


📚 Artigos Relacionados:

Respondeu à sua pergunta?