...
- Visão Geral
- Exemplo de utilização
- Tela Conta de Cobrança
- Outras Ações / Ações relacionadas
- Tela Conta de Cobrança
- Principais Campos e Parâmetros
- Tabelas utilizadas
01. VISÃO GERAL
Esta atividade visa demonstrar como como Registrar boleto boletos via API para o Banco do BradescoBradesco, facilitando a integração de sistemas e a realização de cobranças eletrônicas.
02. EXEMPLO DE UTILIZAÇÃO
...
Ter realizado o cadastro no banco do Bradesco para obter o ClientID.
...
| Tooltip |
|---|
| onlyIcon | true |
|---|
| linkTextStrong | true |
|---|
| appendIcon | add-item |
|---|
| iconColor | orange |
|---|
|
Para solicitar a criação de um Client ID, é necessário enviar um e-mail para suporte |
...
...
- Razão Social do cliente
- CNPJ do cliente
- Uma breve descrição da aplicação que está sendo desenvolvida por nós
- Qual produto/serviço do Bradesco será consumido
- Dois e-mails de contato do cliente (o Bradesco usará para avisos e renovação de certificado)
...
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.  Image AddedLink de referência: Manual do Desenvolvedor - Como utilizar as open APIs do Bradesco
|
Utilizar o Banco Bradesco para cobrança.
...
Acesse o módulo Supervisor Financeiro, clique no menu Parâmetros, em seguida clique na opção Cobrança, aplicação Conta Cobrança.
Image Modified
Imagem 1 - Menu de acesso
| Painel |
|---|
| borderColor | #808080 | bgColor | #F3F3F3 |
|---|
| borderStyle | solid |
|---|
|
| Deck of Cards |
|---|
| | Card |
|---|
| label | Configuração Cobrança Eletrônica. |
|---|
| title | Configuração do Prazo Limite para Recebimento na Cobrança Eletrônica |
|---|
| effectType | fade |
|---|
| 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 Registradapor API: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.
- habilita a geração via API Bradesco
Complemente as demais informações conforme Configuração de Cobrança Eletrônica.  Image Removed Image Added
Imagem 2 – Configuração de Cobrança Eletrônica 
|
| Card |
|---|
| label | Registrar boleto via API para Banco Bradesco |
|---|
| title | Registrar boleto via API para Banco do Brasil |
|---|
| Registrar boleto via API para Banco BradescoInsira 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
para [email protected] seguindo o template “Cadastro modelo Cadastro de Client ID”ID. Como toda Toda comunicação de APIs do Bradesco com parceiros é feita utilizando o
o protocolo mTLS é , sendo necessário o uso de um certificado digital. Existem algumas regras específicas para os certificados digitais aceitos pelo Bradesco. Confira
abaixoConfira: - 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á a 4 meses e no máximo 3
3 anos
Data de validade a contar da data da solicitação de cadastramento
cadastramento ou renovação. Para fins de teste, o certificado usado no ambiente de homologação pode ser uma
uma versão auto assinadaautoassinada. 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. | Nota |
|---|
A opção Gera Cobrança por API é habilitada apenas para o Banco Bradesco e Banco do Brasil e para o Banco Bradesco. 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 Banco do BrasilBradesco. Image Removed 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 Removed Image Added
Imagem 4 - Configuração Boleto Aba API - Ambiente: Indica qual ambiente do Banco Bradesco a aplicação irá se comunicar.
- Bradesco Certificado SSL
- : O Certificado SSL deve ter padrão ICP-Brasil e ser do Tipo A1
seguindo as características mencionadas anteriormente recomendamos que no
- é 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” “cer”- cer, facilitando posteriormente o envio do arquivo
“pem” “cer” referente - 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.
 Image Removed Image Added
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.
Image Removed Image Added Imagem 5 -Boleto
|
| Composition Setup |
|---|
deck.tab.inactive.background = #FFED00
deck.tab.active.background = #FF9900 |
|
|
03. TELA CONTA DE COBRANÇA
Outras Ações / Ações relacionadas
04. TELA CONTA DE COBRANÇA
Principais Campos e Parâmetros
Não há
05. TABELAS UTILIZADAS