Boleto WebService: Bradesco
Revisão de 11h54min de 17 de abril de 2026 por Alex.vieira (discussão | contribs)
Índice
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.
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
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
