CONTEÚDO

  1. Visão Geral
  2. Exemplo de utilização
  3. Tela Conta de Cobrança
    1. Outras Ações / Ações relacionadas
  4. Tela Conta de Cobrança
    1. Principais Campos e Parâmetros
  5. Tabelas utilizadas

01. VISÃO GERAL

Esta atividade visa demonstrar como Registrar boletos via API para o Banco Bradesco, facilitando a integração de sistemas e a realização de cobranças eletrônicas.

02. EXEMPLO DE UTILIZAÇÃO

Caminho

Supervisor > Parâmetros > Cobrança > Conta Cobrança - FICTACOBRANC

Pré-Requisitos 

Possuir acesso ao Sistema Financeiro e suas aplicações.

Possuir Certificado SSL para acesso ao ambiente de homologação e produção do Bradesco.

Ter realizado o cadastro no banco do Bradesco para  obter o ClientID.

Para solicitar a criação de um Client ID, é necessário enviar um e-mail para [email protected] seguindo o modelo Cadastro de Client ID.

Toda comunicação de APIs do Bradesco com parceiros é feita utilizando o protocolo mTLS, sendo necessário o uso de um certificado digital. Existem regras específicas para os certificados digitais aceitos pelo Bradesco. Confira:

  • Deve seguir o padrão ICP-BRASIL do tipo A1
  • Tamanho mínimo de 2048 bits
  • Utilizar algum algoritmo RSA como o RSASHA 256, 384 ou 512
  • Data de validade/expiração deve ser superior a 4 meses e no máximo 3 anos

Data de validade a contar da data da solicitação de cadastramento ou renovação. Para fins de teste, o certificado usado no ambiente de homologação pode ser uma versão autoassinada. 

Autenticação com a API do Banco Bradesco requer as seguintes cifras:

• TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256, e/ou Página 5 de 22
• TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384

Verifique se o seu sistema operacional está preparado para essas cifras e, caso não esteja, providencie os ajustes necessários.

Link de referência: Manual do Desenvolvedor - Como utilizar as open APIs do Bradesco


Utilizar o Banco Bradesco para cobrança.

Realizar Cobrança Eletrônica.

Passo a Passo

Acesse o módulo Supervisor Financeiro, clique no menu Parâmetros, em seguida clique na opção Cobrança, aplicação Conta Cobrança.

Imagem 1 - Menu de acesso.png

Imagem 1 - Menu de acesso

Aba Conta Cobrança

Insira no campo Banco a opção Banco Bradesco. Complete os demais campos.

Marque as Opções:

  • Gera Cobrança Eletrônica: habilita a aba CNAB.
  • Gera Cobrança por API: habilita a geração via API Bradesco

Complemente as demais informações conforme Configuração de Cobrança Eletrônica.

Imagem 2 – Configuração de Cobrança Eletrônica

Registrar boleto via API para Banco Bradesco

Para solicitar a criação de um Client ID, é necessário enviar um e-mail para [email protected] seguindo o modelo Cadastro de Client ID.

Toda comunicação de APIs do Bradesco com parceiros é feita utilizando o protocolo mTLS, sendo necessário o uso de um certificado digital. Existem regras específicas para os certificados digitais aceitos pelo Bradesco. Confira:

  • Deve seguir o padrão ICP-BRASIL do tipo A1
  • Tamanho mínimo de 2048 bits
  • Utilizar algum algoritmo RSA como o RSASHA 256, 384 ou 512
  • Data de validade/expiração deve ser superior a 4 meses e no máximo 3 anos

Data de validade a contar da data da solicitação de cadastramento ou renovação. Para fins de teste, o certificado usado no ambiente de homologação pode ser uma versão autoassinada. 

Autenticação com a API do Banco Bradesco requer as seguintes cifras:

• TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256, e/ou Página 5 de 22
• TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384

Verifique se o seu sistema operacional está preparado para essas cifras e, caso não esteja, providencie os ajustes necessários.

Link de referência: Manual do Desenvolvedor - Como utilizar as open APIs do Bradesco

Insira no campo Banco a opção 237- Banco Bradesco.

Marque a opção Gera Cobrança por API e a opção Emite Boleto.

A opção Gera Cobrança por API é habilitada apenas para o Banco Bradesco e Banco do Brasil.

Funcionalidade de registro via API funcionará apenas quando o cliente for responsável pela emissão do boleto. Para isso a opção Emite Boleto deve estar marcada.

Ao marcar a opção, a aba API também será habilitada, permitindo o cadastro de informações para comunicação com o Bradesco.

Imagem 3 - Parâmetro Gera Cobrança por API Habilitado.

Aba Boleto.

Campos a serem informados:

  • Padrão de Preenchimento
  • Boleto Modelo

Complete as demais informações conforme a necessidade.


Imagem 4 - Configuração Boleto

Aba API

  • Ambiente: Indica qual ambiente do Banco Bradesco a aplicação irá se comunicar.
    • Produção: Produção é o ambiente real da aplicação, onde se utiliza o sistema no dia a dia. 

      Após ter concluído todos os testes com sucesso em ambiente de homologação, o próximo passo é solicitar as credenciais do ambiente de produção. Para isso, será necessário adquirir um certificado emitido por Autoridade certificadora, como: 
      Digicert, CertiSign, Serasa entre outras. Geralmente o certificado emitido pelas autoridades Certificadoras é disponibilizado em um arquivo formato .pfx
    • Homologação: Homologação é o ambiente utilizado para realizar testes na aplicação sem impactar os dados reais. 
  • Bradesco
    • Certificação SSL
      • Importar: O Certificado SSL deve ter padrão ICP-Brasil e ser do Tipo A1. Também é recomendado pelo banco Bradesco que no momento da aquisição do certificado SSL seja solicitado à empresa que irá gerar o novo certificado que forneça os arquivos de chave pública e privada no formato .pem e .cer, facilitando posteriormente o envio do arquivo .pem ou .cer referente a chave pública para o Bradesco.
    • Client key: Chave criptográfica privada usada para autenticar um aplicativo cliente em um sistema de autenticação e autorização.
    • Client Secret: É parte da credencial para identificar sua aplicação na API do Banco Bradesco. É obtida após enviar, por e-mail ao Bradesco, a chave pública do certificado SSL que será utilizado na comunicação com a API de registro de boletos híbridos.

Link de referência: Manual do Desenvolvedor - Como utilizar as open APIs do Bradesco

Imagem 4 - Aba API com campos para comunicação com Banco Bradesco.

Aba Conta de Cobrança

  • Nro. do Contrato: Numero do convênio. Informação disponibilizada pelo Banco Bradesco.

Imagem 5 - Nro do Contrato


Aba Boleto.

Campos a serem informados:

  • Emitido pelo(a) Empresa
  • Padrão de Preenchimento
  • Boleto Modelo

Complete as demais informações conforme a necessidade.


Imagem 5 -Boleto

deck.tab.inactive.background = #FFED00
deck.tab.active.background = #FF9900

03. TELA CONTA DE COBRANÇA

Outras Ações / Ações relacionadas

AçãoDescrição

Geração do Arquivo de Cobrança CNAB

Geração do arquivo para envio ao banco com informações de Cobrança.

Conta Cobrança

Parâmetros a aplicação Conta Cobrança

04. TELA CONTA DE COBRANÇA

Principais Campos e Parâmetros

Não há

05. TABELAS UTILIZADAS