CONTEÚDO
- 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
Caminho
Supervisor > Parâmetros > Cobrança > Conta Cobrança - FICTACOBRANC
Pré-Requisitos
Possuir acesso ao Sistema Financeiro e suas aplicações.
...
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 Added
Imagem 1 - Menu de acesso
Painel |
---|
borderColor | #808080 |
---|
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 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 Bradesco Aviso |
---|
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
|
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. 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 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.
- 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.
Image AddedLink de referência: Manual do Desenvolvedor - Como utilizar as open APIs do Bradesco
Image Added
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 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 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