Como homologar boletos Bradesco
Integração por Arquivo Remessa
Na nova atualização poderá apenas marcar Gerar boleto e remessa com ACBrLib em: Banco> Consultar conta> Dados para geração do arquivo de remessa.
Primeiro terá que entrar em contato com o gerente da conta para pegar os seguintes dados (poderá mandar um email para o gerente):
- Beneficiário: (nome da empresa)
- CPF/CNPJ Beneficiário: (cnpj da empresa)
- Banco:
- Carteira/Modalidade:
- Simples Com Registro:
- Nosso Número inicial:
- Número da Remessa:
- Protesto é Automático ou negativado: (o cliente que decide)
- Quantidade de dias para protesto ou negativação: (o cliente que decide)
- Multa % : (o cliente que decide)
- Juros % mensais: (o cliente que decide)
- Código do Beneficiário/Cliente ou Cedente:
- Num. Convênio:
- Agência:
- Conta Corrente:
- UA/Posto:
- Mensagem local de pagamento: (o cliente que decide)
Após isso, irá pegar os dados e colocar no sistema.
Cadastrar Conta:
Banco> Cadastrar conta
Banco: 19 - BANCO BRADESCO S.A.
Agência: 4567 - Digito Verificador: 0
Número da conta: 01234567 - Digito Verificador: 0
Descrição: poderá colocar a forma que quiser na descrição, exemplo: boletos Bradesco.
Nome do cedente: razão social da empresa - Cidade/Logradouro/ N°/ Bairro/CEP/CNPJ: dados da empresa.
Código do Cedente: 1122334
Num. Convênio: 01234567891
Marcar a opção: Cobrança com Registro.
Aceite: Não.
Taxas: Protestar ou Negativar: poderá escolher se os boletos serão protestados ou negativos ou nenhuma das opções. Dias para protesto/negativação: é opcional. Taxa de multa (%): o cliente irá definir. Juros mensais (%): o cliente irá definir também, pois se ele calcula por dia, aqui terá que colocar o total por mês.
Cobrança: Carteira: 9 Espécie Documento: DM Modalidade: (deixar em branco) Layout Boleto: normalmente é padrão, mas pode colocar carnê ou pode colocar padrão (entrega) ai o boleto irá sair para preencher com a assinatura do beneficiário. CNAB: CNAB400.
Instruções: pode colocar a mensagem que o cliente deseja, pois essa mensagem irá sair em cima do boleto. Ex: PAGÁVEL PREFERENCIALMENTE NO BRADESCO. JURO AO MÊS % MULTA % A PARTIR DA DATA DE VENCIMENTO. PROTESTO AUTOMÁTICO APÓS .. DIAS. (se tiver protesto, se não deixa sem essa informação).
Clique em Gravar.
Após o cadastro da conta, irá precisar emitir 10 boletos de teste e 1 remessa para enviar ao gerente da conta.
Para isso primeiro terá que cadastrar uma fatura avulsa.
Cadastrar Fatura:
Faturas > Cadastrar fatura
Parceiro: usar o parceiro NF-E EMITIDA EM AMBIENTE DE HOMO - SEM VALOR FISCAL. Valor: um valor simbólico. Receita/Despesa: recebimento. Histórico: Boletos de teste (para saber depois no que foi usado). Forma: Boleto. Condição: 10x Observa os vencimentos e clique em Gravar.
Importante: os dados do parceiro que sairá no boleto precisará estar correto, desde nome/razão social, cnpj/cpf e endereço, para não dar boleto rejeitado.
Após a fatura gravada, poderá emitir os boletos.
Geração de Boletos:
Banco> Geração de Boletos
Selecione o Parceiro e clique em pesquisar, selecione os boletos e clique em avançar.
Irá aparecer a tela da conta bancaria, clique em avançar.
Irá aparecer os boletos, clique em avançar.
Os boletos estão prontos para ser impressos.
Para salvar eles clique em 
ao abrir na tela, pode salvar em alguma pasta.
Geração da Remessa:
Banco> Geração de Remessa
Selecione a conta e clique em pesquisar;
Selecione os boletos que gerou ou clique em Marcar Todos e clique em Gerar Remessa. A remessa gerada irá sair com um nome do arquivo. Irá abrir uma tela onde você terá que selecionar a pasta que deseja salvar esse arquivo de remessa e depois clique em ok.
Após salvar irá aparecer a mensagem:
O arquivo da remessa juntamente com os boletos terá que ser enviado para o gerente da conta.
O banco irá mandar uma mensagem respondendo se os boletos estarão homologados ou se estarão com erros, ai terá que ser corrigido conforme o erro, gerar novamente os boletos e a remessa, aguardando a resposta do banco.
Se estiver tudo ok, o cliente poderá emitir já os boletos pelo sistema.
Lembrando que precisa voltar a remessa para a numeração 0 > Banco > Consultar contas > Dados para geração do arquivo de remessa> sequencia da remessa: 0 e clique em gravar. Se o cliente já emite o boleto pelo site, terá que verificar a numeração do boleto para dar sequencia no sistema. (Na homologação a numeração não irá interferir.)
Integração por API
Este manual explica como configurar e operar a emissão de boletos do Bradesco com registro online no TryERP. Nesse modelo o boleto é registrado no banco no momento em que é gerado, já sai com QR Code Pix, e a baixa, o cancelamento e a consulta da situação são feitos pela própria tela de boletos, sem arquivo de remessa.
1. Visão geral
O fluxo completo acontece dentro do TryERP:
| Gerar o boleto | → | Registro no banco automático, na hora |
→ | Impressão / e-mail com linha digitável e QR Code Pix |
→ | Acompanhar Obter Status |
→ | Baixar / Cancelar quando necessário |
| O que muda em relação à remessa por arquivo | Com a API |
|---|---|
| Registro do boleto | Imediato, ao gerar. O banco devolve o nosso número confirmado, a linha digitável, o código de barras e o QR Code Pix. |
| Arquivo de remessa | Não existe. Nada precisa ser enviado pelo internet banking. |
| Baixa e cancelamento | Enviados ao banco pelo botão Baixar/Cancelar Boleto, com resposta na hora. |
| Situação do título | Consultada no banco pelo botão Obter Status. |
| Histórico | Cada comunicação com o banco fica gravada no boleto (data, operação, situação e resposta do banco). |
2. O que providenciar com o Bradesco
Antes de configurar o TryERP, a empresa precisa obter com o banco os itens abaixo. Quase tudo depende do gerente da conta.
| Item | Detalhe | Quem fornece |
|---|---|---|
| Contrato de cobrança pela API | O convênio de cobrança precisa estar liberado para cobrança online com boleto híbrido (boleto com QR Code Pix). Sem essa liberação o banco recusa o registro. | Gerente |
| Chave Pix na conta | Uma chave Pix (normalmente a chave aleatória) cadastrada na conta de cobrança, para o banco montar o QR Code do boleto. | Gerente / internet banking |
| Carteira habilitada para a API | O banco informa qual carteira está liberada para o registro online (em geral 04 ou 09). É esse número que vai no cadastro da conta no TryERP. | Gerente |
| Credenciais do Portal de Desenvolvedores | No portal do Bradesco para desenvolvedores, a empresa cadastra uma aplicação com a API de Cobrança Híbrida (com QR Code), vincula o certificado digital da empresa e recebe o Client ID e o Client Secret. A credencial de produção é solicitada separadamente da de testes. Passo a passo no item 2.1. | Portal do Bradesco (com apoio do gerente) |
| Certificado digital A1 | O mesmo certificado usado para a NF-e. Ele identifica a empresa junto ao banco em cada comunicação. | Certificadora / contador |
2.1. Obter o Client ID e o Client Secret no Portal Bradesco Developers
O cadastro é feito uma única vez, pela própria empresa, no portal Bradesco Developers. Tenha em mãos o CNPJ, a razão social e o arquivo do certificado público (.pem) exportado no item 3.1.
|
1
|
Acesse o Portal Bradesco Developers e clique em Entrar / Registrar. Se a empresa ainda não tem acesso, faça o cadastro por ali. |
|
2
|
Já logado, abra o menu Aplicativos e clique em Criar Aplicação. Dê um nome à aplicação (por exemplo, TryERP Boletos) e salve. |
|
3
|
A aplicação aparece na lista com o estado Ativo. Clicando no nome dela é possível abrir os detalhes a qualquer momento. |
|
5
|
Em Registro de Aplicações > 1. Selecionar Aplicação, escolha a assinatura ativa (Integração Boleto QrCode) e a aplicação criada no passo 2. Clique em Próximo. |
|
6
|
Em 2. Selecionar Recursos, marque todos os recursos da lista (registro do boleto com QR Code, segunda via, consulta de liquidados, baixa, webhook e reserva de ID). Os dois contadores devem mostrar o mesmo número. Clique em Próximo. |
|
7
|
Em 3. Revisar e Enviar, confira os dados e clique em Registrar Aplicação. |
|
8
|
Solicite a credencial da aplicação (Solicitar Credencial) preenchendo:
|
|
9
|
Quando a credencial estiver ativa, abra-a e clique em Visualizar credencial. Copie o Client ID e o Client Secret: eles vão na aba Web Service - API da conta (item 3.2). |
3. Configuração no TryERP
3.1. Certificado digital
|
1
|
Instale o certificado A1 da empresa em Configurações > Instalar Certificado Digital, informando o arquivo e a senha. |
|
2
|
Em Configurações > Consultar Instalação de Certificado, o suporte Tryideas exporta as chaves do certificado. São gerados dois arquivos: o certificado público (.pem) e a chave privada (.key). Guarde o caminho dos dois. |
|
3
|
O arquivo do certificado público (.pem) é o que se vincula à aplicação no Portal de Desenvolvedores do Bradesco. |
3.2. Conta bancária
Acesse Banco > Consultar Contas e abra a conta do Bradesco (ou cadastre uma nova em Banco > Cadastrar Conta). Confira os campos abaixo, aba por aba.
| Aba | Campo | Como preencher |
|---|---|---|
| Dados da conta | Banco, Agência e DV, Conta e DV | Exatamente como constam no banco. Agência e conta erradas geram "DADOS INCONSISTENTES". |
| Carteira | A carteira liberada para a API, informada pelo gerente (ex.: 04). | |
| Cobrança com Registro | Marcado. | |
| Espécie do documento | Normalmente DM (duplicata mercantil). | |
| Juros, multa e dias de carência | Conforme a política da empresa. O banco passa a cobrar juros e multa a partir do dia seguinte ao vencimento. | |
| Instruções do boleto | Texto impresso no boleto. | |
| Outras Opções | Usabilidade | API. |
| Registrar boleto no banco automaticamente ao gerar (API/Web Service) | Marcado para registrar na hora em que o boleto é gerado. Desmarcado, o boleto fica Sem registro até alguém usar o botão Registrar na Consulta de Boletos (útil para gerar hoje e registrar depois). | |
| Exibir layout boleto ao gerar a 1ª vez | Marcado para abrir o boleto na tela logo após o registro. | |
| Último nosso número | O TryERP controla a sequência do nosso número. Se a conta já emitia boletos por outro sistema, informe o último número usado para não repetir. | |
| Web Service - API | Tipo Cobrança | Bradesco. |
| Client ID e Client Secret | Copiados do Portal de Desenvolvedores do Bradesco. Use a credencial de produção. | |
| Ambiente | produção. "Homologação" é o ambiente de testes do banco (veja as Perguntas frequentes). | |
| Scope e Key User | Ficam em branco para o Bradesco. |
3.3. Configurações Adicionais (certificado e Pix)
Acesse Configurações > Configurações Adicionais, aba ACBr, sub-aba Boleto:
|
1
|
Selecione a conta do Bradesco. |
|
2
|
Marque Use Certificate HTTP (a comunicação com o Bradesco é autenticada pelo certificado da empresa). |
|
3
|
Marque Utilizar Pix, para o boleto sair com QR Code (cobrança híbrida). Sem essa opção o banco recusa o registro. |
|
4
|
Informe o Caminho chave pública (arquivo .pem) e o Caminho chave Privada (arquivo .key) gerados no item 3.1. |
|
5
|
Clique em Salvar. O TryERP grava a configuração de comunicação dessa conta, já com o Client ID e o Client Secret informados no cadastro. |
3.4. Parâmetros das operações
De volta ao cadastro da conta, na aba Web Service - API > Parâmetros, cadastre uma linha para cada operação. A lista de valores só aparece depois que a configuração do item 3.3 foi salva.
| Parâmetro | Valor | Usado em |
|---|---|---|
| Incluir | Remessa Registrar | Registro do boleto (automático ou pelo botão Registrar). |
| Baixa | Remessa Baixar | Botão Baixar/Cancelar Boleto. |
| Consultar Detalhes | Remessa Registrar | Botão Obter Status. |
4. Operação no dia a dia
4.1. Gerar e registrar
Os boletos são gerados como de costume: em Banco > Geração de Boletos, ou automaticamente ao emitir uma nota fiscal, fatura ou ordem de serviço com pagamento em boleto nessa conta. Com a opção Registrar boleto no banco automaticamente ao gerar marcada, o TryERP registra cada boleto no Bradesco na mesma hora e, em seguida, abre o boleto na tela e envia por e-mail, conforme a configuração da empresa.
O boleto impresso já traz a linha digitável, o código de barras e o QR Code Pix devolvidos pelo banco. O cliente pode pagar pela linha digitável ou pelo Pix: nos dois casos o pagamento cai no mesmo título.
4.2. Tela Consulta de Boletos
Em Banco > Consulta de Boletos, pesquise pela conta, parceiro ou período. A coluna Situação mostra o estado de cada boleto (veja a seção 5). Os botões usados com o Bradesco são:
| Botão | O que faz |
|---|---|
| Registrar | Registra no banco os boletos selecionados que ainda estão Sem registro. |
| Obter Status | Consulta a situação atual de cada boleto selecionado no Bradesco e atualiza a coluna Situação. |
| Baixar/Cancelar Boleto | Envia ao banco o pedido de baixa do título e marca o boleto como Baixado no TryERP. |
| Enviar Boleto por E-mail | Envia o boleto ao e-mail do parceiro. |
| Regerar Boleto | Gera um novo boleto para a mesma parcela (por exemplo, com novo vencimento). O boleto anterior precisa estar baixado. |
| Imprimir | Imprime ou visualiza os boletos selecionados. Boletos Sem registro não são impressos. |
Na parte inferior da tela, o histórico de comunicação do boleto lista cada envio ao banco com data, operação, situação resultante, detalhe do erro e a resposta completa. É a primeira coisa que o suporte vai pedir quando algo não funcionar.
4.3. Baixar ou cancelar um boleto
|
1
|
Selecione o boleto e clique em Baixar/Cancelar Boleto. Confirme a pergunta da tela. |
|
2
|
O TryERP envia o pedido ao Bradesco. O banco responde "Solicitação de baixa efetuada" e o boleto passa a Baixado. |
|
3
|
O banco conclui a baixa no seu processamento (normalmente no mesmo dia ou no dia seguinte). Enquanto isso, o Obter Status informa que o título está "com baixa solicitada". Isso é normal e não precisa de nova ação. |
4.4. Consultar a situação no banco
Selecione um ou mais boletos e clique em Obter Status. O TryERP consulta o Bradesco e atualiza a Situação de cada um. Use para confirmar um registro, acompanhar uma baixa ou verificar se um boleto foi pago.
5. Situações do boleto
| Situação no TryERP | O que o Bradesco informa | Significado |
|---|---|---|
| Sem registro | — | Boleto gerado e ainda não registrado: registro manual pendente ou registro recusado pelo banco (veja o histórico). Não pode ser pago nem impresso. |
| Registrado | "A vencer / vencido" | Título ativo no banco, aguardando pagamento. |
| Baixado | "Solicitação de baixa efetuada" (na hora da baixa) "Com baixa solicitada" (consulta, até o banco processar) "Conforme seu pedido" (baixa concluída) |
Título cancelado no banco a pedido da empresa. O TryERP mantém o boleto como Baixado nas três etapas. |
| Baixado | "Por decurso de prazo" | O banco baixou o título automaticamente por ter passado o prazo máximo após o vencimento, sem pagamento. |
| Pago | "Pago", com data e valor | O cliente pagou (boleto ou Pix). A liquidação da parcela segue o processo descrito em Liquidação com Arquivo de Retorno Bancário e Retorno por API. |
6. Mensagens do banco e o que fazer
As mensagens abaixo aparecem na tela (janela Rejeições retornadas pelo banco) e no histórico do boleto.
| Mensagem | Causa provável | O que fazer |
|---|---|---|
| Falha na Autenticação: HTTP_Code=401 | Client ID ou Client Secret incorretos, ambiente trocado (produção x homologação), certificado diferente do vinculado no portal, ou aplicação do portal sem a API de cobrança. | Conferir a aba Web Service - API da conta e os caminhos das chaves; salvar de novo em Configurações Adicionais (item 3.3); conferir a aplicação no portal do Bradesco. |
| Erro 403 sem mensagem (a resposta repete os dados enviados) | A aplicação do portal está associada à API de cobrança sem QR Code, ou a opção Utilizar Pix está desmarcada. | Marcar Utilizar Pix (item 3.3) e confirmar no portal que a aplicação usa a API de Cobrança Híbrida. |
| IDENTIFICADOR DO PRODUTO NAO CADASTRADO | A carteira informada na conta não está habilitada para a API no contrato. | Pedir ao gerente a carteira correta ou a liberação; ajustar o campo Carteira na conta. |
| DADOS INCONSISTENTES - 0840 | Agência, conta ou carteira diferentes do cadastro do banco, ou cobrança online ainda não liberada no convênio. | Conferir os dados com o gerente e pedir a liberação do convênio para cobrança online com boleto híbrido. |
| Não possui parâmetros configurados, necessário realizar a configuração | Aba Parâmetros da conta vazia. | Cadastrar as três linhas do item 3.4. |
| Selecionado boletos que a conta geradora não está configurada para utilizar o serviço de registro automático | A Usabilidade da conta não é API, ou o boleto foi gerado antes da mudança. | Ajustar a Usabilidade (item 3.2). Boletos antigos, de remessa, continuam pelo processo de arquivo. |
| Retorno do banco não corresponde a este boleto | O banco aceitou o registro, mas uma versão antiga do TryERP não reconheceu a resposta do Bradesco. | Atualizar o TryERP e usar Registrar novamente: o boleto passa a Registrado sem duplicar o título no banco. |
7. Perguntas frequentes
Posso testar antes de usar em produção?
O ambiente de testes do Bradesco ("Homologação") trabalha com dados fixos de exemplo: as respostas não correspondem aos dados da sua conta, e a consulta e a baixa não funcionam com um cadastro real. A forma mais segura de validar é gerar, em produção, um boleto de valor baixo para um cliente de teste, registrar, conferir com Obter Status e em seguida baixá-lo.
O boleto sai com QR Code Pix?
Sim. Com a opção Utilizar Pix marcada, o banco devolve o QR Code junto com o registro e ele é impresso no boleto. O pagamento por Pix liquida o mesmo título.
Fiz a baixa e o Obter Status mostra "com baixa solicitada". Deu errado?
Não. O banco aceitou a baixa e vai concluí-la no processamento dele. O boleto já está Baixado no TryERP.
Preciso gerar arquivo de remessa?
Não. Com o registro pela API, nada é enviado pelo internet banking.
Quais dados do cliente são obrigatórios?
CPF ou CNPJ, nome, endereço, bairro, cidade, UF e CEP do pagador. Cadastro incompleto é recusado pelo banco no registro.
O que acontece se eu gerar o boleto com o registro automático desligado?
Ele fica Sem registro e pode ser cancelado no TryERP sem custo, pois ainda não existe no banco. Quando quiser registrar, use o botão Registrar.
8. Resumo
| Etapa | Onde | Resultado |
|---|---|---|
| Liberação no banco | Gerente e Portal de Desenvolvedores do Bradesco | Convênio híbrido, carteira, chave Pix, Client ID e Client Secret. |
| Certificado | Configurações > Instalar / Consultar Instalação de Certificado | Certificado instalado e chaves exportadas. |
| Conta | Banco > Consultar Contas | Usabilidade API, Tipo Cobrança Bradesco, credenciais, ambiente, parâmetros. |
| Comunicação | Configurações > Configurações Adicionais > ACBr > Boleto | Certificado, Pix e chaves salvos para a conta. |
| Emissão | Geração de Boletos ou emissão de documentos | Boleto registrado na hora, com QR Code Pix. |
| Acompanhamento | Banco > Consulta de Boletos | Registrar, Obter Status, Baixar/Cancelar, e-mail e impressão. |
Última atualização: Outubro/2026.