Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

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 boleto via API para Banco do Bradesco

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.

...

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.pngImage Added

Imagem 1 - Menu de acesso

Painel
borderColor#808080
bgColor#F3F3F3
borderStylesolid
Deck of Cards
id001
effectTypefade
Card
labelConfiguração do Prazo Limite para Recebimento na Cobrança Eletrônica.
titleConfiguração do Prazo Limite para Recebimento na Cobrança Eletrônica
effectTypefade

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.
  • Cobrança Registrada: opção    para gerar o arquivo de remessa de cobrança eletrônica ao banco.
  • Gera Instrução de Alteração (opcional):  alterações no título serão refletidas no boleto.

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

Image Added

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

Image Added
Card
label Registrar boleto via API para Banco Bradesco
title Registrar boleto via API para Banco do Brasil

Registrar boleto via API para Banco Bradesco

Insira no campo Banco a opção 237- Banco Bradesco. Marque a opção Gera Cobrança por API, Emite Boleto e preencha os outros campos seguindo a configuração de conta cobrança. Complete os demais campos bom base no Grupo alvo


Aviso

Para solicitar a criação de um Client ID, é necessário enviar um e-mail para 
[email protected] seguindo o template “Cadastro de Client ID”. Como toda comunicação de APIs do Bradesco com parceiros é feita utilizando o 
protocolo mTLS é necessário o uso de um certificado digital. Existem algumas regras específicas para os certificados digitais aceitos pelo Bradesco. Confira 
abaixo:

  • 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 há 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 auto assinada. 

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.

Image AddedLink de referência

Nota

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

Funcionalidade de registro via API funcionará apenas quando o cliente é 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 Banco do Brasil.

Image Added

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.

Image Added

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. 

      Tooltip
      onlyIcontrue
      linkTextStrongtrue
      appendIconlink
      iconColor#0052CC

      https://apoio.developers.bb.com.br/referency/post/6050dda3737e1c0012e2d00e

      Link de como enviar aplicação para produção.

    • Homologação: Homologação é o ambiente utilizado para realizar testes na aplicação sem impactar os dados reais.
  • Application key: Acesse o portal developers do Banco do Brasil. Selecione a aplicação criada e navegue até as credenciais. Localize o item developer_application_key e copie seu valor, em seguida cole no campo Application Key.
  • Token de autenticação: Acesse o portal developers do Banco do Brasil. Selecione a aplicação criada e navegue até as credenciais. Localize e clique no botão Copiar Basic  copiar o token, em seguida, cole no campo Token Autenticação.

Image Added

Imagem 8 - Aba API com campos para comunicação com Banco do Brasil.


No portal developers do Banco do Brasil, no menu lateral, clique na opção Credências.

Image Added

Imagem 9 - Barra navegação BB.

Localize e clique no botão Copiar Basic.

Image Added

Imagem 10 - Botão Copiar.

Na aplicação Conta de Cobrança, aba API, cole no campo Token Autenticação o valor copiado. 

Localize e copie o valor do item developer_application_key e cole no campo Application Key.

Image Added

Imagem 11 - Token Autenticação.

Aba Conta de Cobrança

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

Image Added

Imagem 12 - 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.

Image Added

Imagem 13 -Boleto



Aba CNAB.

  • Informação específica 2: Variação da carteira. Informação disponibilizada pelo banco do brasil.

Clique no botão Incluir - <F3>.

Image Added

Imagem 14 - Informação Específica 2

Image Added
Composition Setup
deck.tab.inactive.background = #FFED00
deck.tab.active.background = #FF9900