...
- 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 [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. Image AddedLink 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.
...
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 por API: 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 ![](/download/attachments/831831907/Seta%20voltar.png?version=1&modificationDate=1710417972387&api=v2)
|
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 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 Bradesco. 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. 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” “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
![](/download/attachments/831831907/image-2024-3-14_10-38-6.png?version=1&modificationDate=1710423487043&api=v2)
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 ![](/download/attachments/831831907/Seta%20voltar.png?version=1&modificationDate=1710417972387&api=v2)
|
Composition Setup |
---|
deck.tab.inactive.background = #FFED00
deck.tab.active.background = #FF9900 |
|
|
...