> For the complete documentation index, see [llms.txt](https://ajuda.consistem.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.consistem.com.br/consistem-integracoes/areas-de-negocio/financeiro/banco-bradesco-api-cobranca.md).

# Banco Bradesco (API Cobrança)

#### Visão geral

A integração entre o Consistem ERP e a API de Cobrança do Banco Bradesco moderniza a gestão de títulos financeiros, substituindo o modelo tradicional de troca de arquivos (CNAB 240/400) por uma comunicação direta e em tempo real. Esta solução permite o registro instantâneo de boletos e a validação imediata de dados (como CPF/CNPJ e valores) no ato da emissão, eliminando o tempo de espera do processamento de arquivos e reduzindo falhas manuais.

#### Requisitos

<table><thead><tr><th width="461">Consistem ERP</th><th>Banco Bradesco (API Cobrança)</th></tr></thead><tbody><tr><td><p><strong>Compatibilidade:</strong> 7.6 ou superiores do Consistem ERP.</p><p><strong>Módulos:</strong> Financeiro e Cobrança Escritural devidamente implantados.</p><p><strong>Licença:</strong> <a href="https://movidesk.consistem.com.br/form/5801/">Aquisição de licença</a> <strong>BBRA</strong> ativa junto à Consistem.</p><p>Orientamos o acompanhamento da nossa equipe de consultores.</p></td><td>Aquisição de licença e implantação deve ser verificada com a empresa fornecedora.<br><a href="https://developers.bradesco.com.br/">Saiba mais</a></td></tr><tr><td><a href="/spaces/JAFv73zIUkocB6ArsYjv/pages/SfhnTXkjUOFBpQGkRuJV">Cadastro de Portador (CCAPL025)</a>: O portador correspondente à conta bancária deve estar cadastrado, com o número do banco e agência corretos.</td><td><strong>Convênio:</strong> Convênio de Cobrança Ativo de 7 dígitos (Tipos 2 ou 4; Modalidades 1 ou 4).</td></tr><tr><td></td><td><strong>Portal:</strong> Cadastro no <a href="https://developers.bradesco.com.br/">Portal do Desenvolvedor Bradesco</a>.</td></tr><tr><td></td><td><strong>Aplicação:</strong> Criação de uma aplicação no portal, vinculando o convênio de cobrança ou conta corrente para viabilizar a integração.</td></tr><tr><td></td><td><strong>Credenciais:</strong> Obtenção das chaves <em>Client ID</em> e <em>Client Secret</em>.</td></tr><tr><td></td><td><strong>Certificados:</strong> Se exigido pelo banco, realizar o upload ou geração dos certificados digitais para autenticação segura (mTLS ou SSL/TLS).</td></tr></tbody></table>

#### Configuração da integração

**No Consistem ERP:**

1. Acesse o programa [Integração (CSINTEGRACAO010)](/componentes/manuais-de-telas/cadastros-gerais-de-componentes/integracao.md), selecione a integração **BBRA** e acione a coluna **Editar**.<br>

   <figure><img src="/files/P6biWG5NcWyL9xgBGO85" alt=""><figcaption></figcaption></figure>
2. No programa [Cadastro de Integração (CSINTEGRACAO010A)](/componentes/manuais-de-telas/cadastros-gerais-de-componentes/cadastro-de-integracao.md), configure a integração com as chaves obtidas no portal do banco (*Client ID* e *Client Secret*). Altere a situação da integração para *Ativo* e salve os dados.<br>

   <figure><img src="/files/L1XuG82d6SgXtrkVPta3" alt=""><figcaption></figcaption></figure>
3. Acesse o programa [Cadastro de Dados do Banco da Cobrança Escritural (CCCE030)](/financeiro/manuais-de-telas/financeiro-contas-a-receber/tabelas-da-cobranca-escritural/cadastro-de-dados-do-banco-da-cobranca-escritural.md) e, no campo **Leiaute CNAB**, selecione a opção *API*.

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>Esta configuração ativa o uso da API para o banco selecionado.</p></div>

   <figure><img src="/files/AMcg0KuSBcv8TvU5Dgp7" alt=""><figcaption></figcaption></figure>
4. No programa [Configuração Geral da Cobrança Escritural (CCCE000)](/financeiro/manuais-de-telas/financeiro-contas-a-receber/configuracoes-da-cobranca-escritural/configuracao-geral-da-cobranca-escritural.md), altere o campo **Envio da Remessa Automática via API na Geração do Borderô** para *Sim*.

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>Esta é uma configuração independente que automatiza a transmissão após o borderô ser gerado.</p></div>

   <figure><img src="/files/Hjq2RHuXQ4rAzrbLxEJp" alt=""><figcaption></figcaption></figure>
5. No [Cadastro de Agendamento de Tarefas (CSTASK010)](/componentes/manuais-de-telas/agendamento-de-tarefas-e-processo-em-segundo-plano/cadastro-de-agendamento-de-tarefas.md), [Aba Parâmetros Padrões](/componentes/manuais-de-telas/agendamento-de-tarefas-e-processo-em-segundo-plano/cadastro-de-agendamento-de-tarefas/aba-parametros-padroes.md), configure a tarefa *Buscar Títulos Liquidados Bradesco* e *Buscar Títulos Liquidados Bradesco Webhook* (Financeiro - Contas a Receber) e defina a periodicidade para a leitura automática dos retornos.<br>

   <figure><img src="/files/1A38gSlTrM7vTptMDbSk" alt=""><figcaption></figcaption></figure>

#### Como a integração funciona

A integração utiliza o protocolo **HTTPS** com autenticação via **OAuth2**, utilizando APIs **RESTful** em formato **JSON**. Quando o usuário encerra um borderô, o sistema valida se a licença **BBRA** está ativa; se configurado para API na [Configuração Geral da Cobrança Escritural (CCCE000)](/financeiro/manuais-de-telas/financeiro-contas-a-receber/configuracoes-da-cobranca-escritural/configuracao-geral-da-cobranca-escritural.md), o ERP interrompe a criação do arquivo físico (.rem) e realiza chamadas diretas aos *endpoints* do Bradesco. O banco valida os dados instantaneamente e retorna o status de *Registrado*, permitindo o pagamento imediato pelo sacado.

#### Fluxo do processo

O fluxo segue o leiaute padrão da Consistem para APIs bancárias:

1. **Origem dos Dados:** O usuário seleciona os títulos e gera o borderô no programa [Geração do Borderô de Remessa (CCCE065)](/financeiro/manuais-de-telas/financeiro-contas-a-receber/cobranca-escritural/geracao-do-bordero-de-remessa.md).
2. **Envio (Remessa Digital):** No programa [Geração do Arquivo de Remessa de Borderô (CCCE100)](/financeiro/manuais-de-telas/financeiro-contas-a-receber/cobranca-escritural/geracao-do-arquivo-de-remessa-de-bordero.md), o sistema converte os dados para o leiaute da API e realiza a chamada de envio automático sem gerar arquivo físico para o Bradesco.
3. **Registro em Tempo Real:** O banco processa a informação e retorna o status. Se houver qualquer inconsistência será exibido na hora para correção.
4. **Retorno Automático (Task):** Através do [Agendamento de Tarefas (CSTASK015)](/componentes/manuais-de-telas/agendamento-de-tarefas-e-processo-em-segundo-plano/agendamento-de-tarefas.md), o sistema consulta o banco periodicamente para verificar quais títulos foram liquidados.
5. **Resultado Final (Liquidação):** O retorno é gravado de forma automática e o título é baixado via [Atualização do Movimento de Retorno (CCCE170)](/financeiro/manuais-de-telas/financeiro-contas-a-receber/cobranca-escritural/atualizacao-do-movimento-de-retorno.md), mantendo o saldo atualizado sem a necessidade de importar arquivos de retorno manuais.

<p align="center">Esse conteúdo foi útil?</p>

<p align="center"><a href="https://movidesk.consistem.com.br/form/10395/" class="button primary" data-icon="thumbs-up">Sim</a> <a href="https://movidesk.consistem.com.br/form/10395/" class="button primary" data-icon="thumbs-down">Não</a></p>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://ajuda.consistem.com.br/consistem-integracoes/areas-de-negocio/financeiro/banco-bradesco-api-cobranca.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.