Boleto WebService: Bradesco

Pré-Requisitos

Para utilização do WebService de Boletos do Bradesco, é necessário atender aos seguintes requisitos:

• Ser cliente pessoa jurídica (PJ) do Bradesco.
• Possuir contrato de cobrança ativo, com os indicadores 175 e 182 devidamente habilitados .
• Para utilização da carteira 02 (Garantida) com QR Code, é necessário que o gerente da conta realize o cadastro por meio do formulário 5017.
• Ter realizado ao menos um acesso ao Bradesco Net Empresa.
• Possuir certificado digital da empresa no formato PFX, emitido por autoridade certificadora válida, atendendo aos seguintes requisitos:
  • Prazo de validade mínimo de 4 meses e máximo de 3 anos.
• Obs.: Para a cobrança com QRCode é necessário realizar a criação de uma chave PIX aleatória.

---

Fluxo para implantação da Integração

1. Cadastro no Portal Bradesco Developers

• Clique em Entrar/Registrar
• Na tela de login, selecione a opção Inscreva-se para iniciar o cadastro
• Preencha os dados do usuário responsável pela integração e defina uma senha de acesso
• Finalize o cadastro clicando em Inscrever-se
• Após o cadastro, você receberá um e-mail de ativação
• Clique em Ative sua Conta para concluir o processo — você será redirecionado para a página inicial do portal

Atenção: Caso não localize o e-mail de ativação, verifique a caixa de spam ou lixo eletrônico.

2. Cadastro de Assinatura de Cobrança com QR Code

• Acesse o Portal Bradesco Developers e realize o login com os dados cadastrados anteriormente.
• No menu principal, clique em Produtos para visualizar o catálogo disponível.
• Utilize o campo de busca para localizar o produto Cobrança com QR Code e selecione-o.
• Clique em Inscrever-se para iniciar o processo de assinatura do produto.
• Selecione o plano de produção
• Informe o grupo de trabalho responsável pela assinatura.

• Você pode utilizar o Default team ou criar um novo time em Organização > Equipe no menu lateral.

• Insira um nome para a sua assinatura.
• Clique em Enviar Solicitação para concluir o processo.

Aprovação da Assinatura:

• Para o ambiente de produção, a aprovação pode levar até 48 horas.
• Você será notificado por e-mail assim que a assinatura for aprovada.

3. Cadastro de aplicação API Cobrança com QR Code

• Clique em Registar Aplicação para registrar uma nova aplicação no produto.
• Escrever o nome do Aplicativo que deseja armazenar suas credencias e na caixa em vermelho
• Selecione o nome da equipe. (Exemplo: Default time) Depois clique em "Criar" para registrar o nome de sua aplicação.
• Selecione sua assinatura e clique em próximo
• Selecione todos os escopos (recursos) disponíveis e clique em próximo
• Clique em Registrar Aplicação
• Clicar em Solicitar Credencial
• Informe um nome para a credencial
• Informe o recurso de Cobrança com QRCode.
• Selecione seu aplicativo
• Selecione a opção Solicitar Credencial
  • Informe o CNPJ da empresa.
  • Informe a Razão Social da empresa.
  • Certificado Digital (.CER): Para gerar o certificado no formato .cer, siga os passos abaixo:

• Instale o certificado da empresa no formato .PFX no computador (usuário local);
• Acesse o Painel de Controle → Gerenciar Certificados do Usuário;
• Localize o certificado instalado na lista;
• Clique com o botão direito sobre o certificado e selecione:
  • Todas as Tarefas → Exportar.
• No assistente de exportação:
  • Selecione a opção Não exportar a chave privada.
  • Escolha o formato X.509 codificado na Base 64 (*.cer).
  • Finalize a exportação.

• Após finalizar e clicar em criar, receberá uma notificação para que aguarde a criação de sua credencial. O tempo limite de habilitação de sua credencial é de até 10 minutos.
• Por questões de segurança, o Client Secret estará visível somente por 3 dias. Caso o perca, será necessário gerar uma nova credencial para obter um novo Client Secret.

4. Configuração no PHERP

Conversão do Certificado PFX para .CRT e .KEY com OpenSSL. Sugestão executar o arquivo Conversao Certificado para executar os processos.

Para utilização da integração no PHERP, é necessário converter o certificado fornecido pelo banco (formato .pfx) para os formatos .crt e .key. Com o OpenSSL instalado, execute os comandos abaixo (através do CMD preferencialmente dentro da pasta bin com permissão de administrador do OpenSSL):

• openssl pkcs12 -in C:\OpenSSL\bin\certificado.pfx -nokeys -out C:\OpenSSL\bin\certificado.pem
• openssl pkcs12 -in C:\OpenSSL\bin\certificado.pfx -clcerts -nokeys -out C:\OpenSSL\bin\certificado.crt
• openssl pkcs12 -in C:\OpenSSL\bin\certificado.pfx -nocerts -nodes -out C:\OpenSSL\bin\certificado.key

Autenticação

• ClientID: Disponibilizada no registro da aplicação.
• ClientSecret: Disponibilizada no registro da aplicação..
• ArquivoCRT: Certificado público (.crt) convertido anteriormente.
• ArquivoKey: Chave privada (.key) convertido anteriormente.

Cobrança

• Tipo de Integração: WebService.

---

Observações Importantes

• As credenciais são sensíveis e devem ser armazenadas com segurança.
• No período da 00h00 às 03h00 pode haver indisponibilidade de acesso à API face às atualizações de tabelas e processamento batch.

---

Problemas Comuns

Durante a implantação e utilização da integração com o Bradesco, podem ocorrer alguns problemas relacionados à autenticação, comunicação com a API, permissões, comportamento ou configuração do ERP.

---

Assuntos Relacionados

Documentação Oficial API Boletos Bancários Bradesco

Boletos via Webservice

WebHooks de Integração Bancária