Integração Hubsoft com Bradesco

Sobre o Bradesco

O Bradesco é um dos maiores grupos financeiros do Brasil, em atividade desde 1943, com sede em Osasco, São Paulo. Tem agências ou postos de atendimento em boa parte dos municípios do país. Para o provedor, isso significa um banco de cobrança disponível em quase qualquer região.

O que a integração faz

• API V2: o Hubsoft envia ao banco o registro, a alteração de vencimento e a baixa por cancelamento ou pagamento, sem remessa. O retorno é lido pela rotina de verificação de boletos na API Bancária.
• Registro em até 5 minutos: na API, o boleto fica registrado em até 5 minutos. Em faturamentos grandes, o envio é em lotes e pode levar mais.
• CNAB 240 e 400: remessa e retorno em arquivo continuam disponíveis.
• Pix com vencimento (COBV): o Pix tem data de vencimento, juros, multa e desconto até o vencimento, como o boleto. O Hubsoft envia, consulta e cancela o Pix sozinho, com verificação dos pagos a cada 8 minutos.
• Pix na fatura: QR Code na impressão do boleto e Pix copia e cola na visualização da fatura.

O que você precisa

• Conta no Bradesco com convênio de cobrança.
• Certificado digital da empresa cadastrado no Hubsoft. A chave pública do certificado é enviada ao banco.
• Para a API V2: a habilitação da funcionalidade 175 - Registro via Webservice e as credenciais geradas no painel developers do Bradesco.
• Para o Pix: a liberação do Pix COBV pelo gerente, as credenciais do Pix e uma chave Pix, de preferência aleatória.
• Módulo Financeiro do Hubsoft, incluso na licença.

Como ativar

1. Crie a forma de cobrança em Configuração > Financeiro > Forma de Cobrança, com o banco 237 - Banco Bradesco S/A, e homologue por remessa e retorno.
2. Cadastre o certificado em Configuração > Geral > Certificado Digital e baixe a chave pública em Ações > Baixar Chave Pública.
3. Peça ao gerente a habilitação do Registro via Webservice e gere as credenciais no painel developers.
4. Na aba API da forma de cobrança, ative as ações desejadas. Em Parâmetros Extras, informe a versão v2 e as credenciais. Na aba Certificado, vincule o certificado.
5. Cadastre a rotina de verificação de boletos na API Bancária, para os pagamentos serem compensados.
6. Para o Pix, cadastre o Bradesco em Configuração > Integrações > PIX, com as credenciais, a chave, o certificado e o caixa financeiro, e vincule à forma de cobrança.

O passo a passo com as telas está na wiki da Hubsoft: boleto Bradesco e Pix Bradesco.

Limitações

• O Bradesco não tem Pix Automático no Hubsoft.
• A API V0, mais antiga, faz só o registro do boleto.
• No Pix separado do boleto, o pagamento por Pix precisa gerar a baixa do boleto no banco, para evitar pagamento em duplicidade pelo código de barras.
• Layouts de carnê não mostram o QR Code automaticamente. É preciso um layout específico, que o suporte configura.
• O Pix COBV aceita pagamento por até 60 dias depois do vencimento.

Perguntas frequentes

Qual versão da API devo usar?

A V2, com credenciais geradas no painel developers do Bradesco. A V1 e a V0 continuam documentadas para quem já usa.

O Pix do Bradesco cobra juros depois do vencimento?

Sim. O Pix COBV leva juros, multa e desconto como o boleto, e pode ser pago até 60 dias depois do vencimento.

Por que o boleto não registrou pela API?

Os erros costumam ser específicos de algum dado do cliente ou da comunicação com o banco. O suporte da Hubsoft analisa o caso.

Revisado em 10/10/2026.