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 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.
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.
| 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.  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
| 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. 
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. 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. 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.
- 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
AQUI, O TEXTO ESTÁ DIFERENTE DO QUE ESTÁ SENDO DESTACADO NA TELA! Complete as demais informações conforme a necessidade.
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