> 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-pagamento-escritural.md).

# Banco Bradesco (API Pagamento Escritural)

Integração | Financeiro

### Visão Geral

A integração entre o banco Bradesco e o Consistem ERP via API de Pagamento Escritural automatiza o envio de borderôs e a consulta de retornos de pagamentos. A solução elimina a troca manual de arquivos de remessa e retorno, permitindo a conciliação automática e agendada de documentos e tributos diretamente pelo ERP.

### Requisitos

| Consistem ERP                                                                                                                                                        | Banco Bradesco                                                                                                                                  |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| **Compatibilidade:** 7.6 ou superiores do Consistem ERP.                                                                                                             |                                                                                                                                                 |
| <p><br>Módulo Financeiro - Contas a Pagar</p>                                                                                                                        |                                                                                                                                                 |
| <p><br><strong>Licença:</strong> <a href="https://movidesk.consistem.com.br/form/5801/">Aquisição de licença</a> <strong>BBRAP</strong> ativa junto à Consistem.</p> |                                                                                                                                                 |
| <p><br>Orientamos o acompanhamento da nossa equipe de consultores.</p>                                                                                               | Aquisição de licença e implantação deve ser verificada com a empresa fornecedora. [Saiba mais](https://banco.bradesco/html/classic/index.shtm). |
|                                                                                                                                                                      | Conta corrente ativa e credenciamento no portal [Bradesco Developers](https://developers.bradesco.com.br/).                                     |
|                                                                                                                                                                      | Aplicação registrada e APIs habilitadas no portal do Bradesco:                                                                                  |
| <p><br>Cobrança</p>                                                                                                                                                  |                                                                                                                                                 |
| <p><br>Pagamento de Contas de Consumo e Tributos via Código de Barras</p>                                                                                            |                                                                                                                                                 |
| <p><br>Pix Transferência (Consultar e Transferir)</p>                                                                                                                |                                                                                                                                                 |
| <p><br>Transferência TED.</p>                                                                                                                                        |                                                                                                                                                 |
|                                                                                                                                                                      | Certificado Digital A1 ativo.                                                                                                                   |

### Configuração da Integração

**No Consistem ERP**

1. No programa [Cadastro de Portador (CCAPL025)](https://ajuda.consistem.com.br/modulos/cadastros-gerais/manuais-de-telas/cadastros-gerais/cadastro-de-portador.md), cadastre os dados bancários para o Banco Bradesco com o código **BACEN 237**;

<figure><img src="https://3798442413-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhlUlmj2KD330s7T7Q6vh%2Fuploads%2FVMyiBlWeDa81Hg6kxas4%2F2026-08-24_10h44_24.png?alt=media&amp;token=5a8e9bbb-5995-4481-bb7c-b83de318af3c" alt=""><figcaption></figcaption></figure>

2. Configure o Bradesco como banco para Pagamento Escritural no [Cadastro de Banco do Pagamento Escritural (CCFFE050)](https://ajuda.consistem.com.br/modulos/financeiro/manuais-de-telas/financeiro-contas-a-pagar/tabelas-do-pagamento-escritural/cadastro-de-banco-do-pagamento-escritural.md);

<figure><img src="https://3798442413-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhlUlmj2KD330s7T7Q6vh%2Fuploads%2F4UvlaPlZvmlawuUBNxuK%2F2026-08-24_10h49_10.png?alt=media&amp;token=fc4e5035-5f87-42d0-846f-e9ea4199b9f5" alt=""><figcaption></figcaption></figure>

3. Ative como *Sim* os campos **Integração pela API** e **Possui Pagamento Tributo** (caso utilize tributos) no programa [Cadastro de Dados do Banco do Pagamento Escritural (CCFFE015)](https://ajuda.consistem.com.br/modulos/financeiro/manuais-de-telas/financeiro-contas-a-pagar/tabelas-do-pagamento-escritural/cadastro-de-dados-do-banco-do-pagamento-escritural.md);

<figure><img src="https://3798442413-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhlUlmj2KD330s7T7Q6vh%2Fuploads%2Fg916qhJrL4LXJZTMHuaK%2F2026-08-24_10h55_11.png?alt=media&amp;token=859e3034-af35-4db6-a46c-5ad2390d7f21" alt=""><figcaption></figcaption></figure>

4. No [Cadastro de Dados Bancários por Empresa (CCFFE016)](https://ajuda.consistem.com.br/modulos/financeiro/manuais-de-telas/financeiro-contas-a-pagar/tabelas-do-pagamento-escritural/cadastro-de-dados-bancarios-por-empresa.md), defina **agência**, **conta** e **identificadores por empresa**;

<figure><img src="https://3798442413-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhlUlmj2KD330s7T7Q6vh%2Fuploads%2FuxdyItMv64ssQuu2zXCC%2F2026-08-24_11h01_09.png?alt=media&amp;token=75710a38-4eeb-49e8-9a5a-cef345eda9a1" alt=""><figcaption></figcaption></figure>

5. Acesse a [Configuração do Pagamento Escritural (CCFFE000)](https://ajuda.consistem.com.br/modulos/financeiro/manuais-de-telas/financeiro-contas-a-pagar/configuracoes-de-contas-a-pagar/configuracao-do-pagamento-escritural.md) e defina o **Envio da Remessa Automática via API na Geração do Borderô** como *Sim*;

<figure><img src="https://3798442413-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhlUlmj2KD330s7T7Q6vh%2Fuploads%2FWBjHAnORo6o36Q6g9hio%2F2026-08-24_11h03_33.png?alt=media&amp;token=68a0d096-feba-4a6d-b922-6247b035f51a" alt=""><figcaption></figcaption></figure>

6. Configure as **categorias de fornecedores** habilitadas para pagamentos de tributos no programa [Cadastro da Categoria de Conta e Tributo (CCFFE110)](https://ajuda.consistem.com.br/modulos/financeiro/manuais-de-telas/financeiro-contas-a-pagar/tabelas-do-pagamento-escritural/cadastro-da-categoria-de-conta-e-tributo.md) para envio automático dos borderôs;

<figure><img src="https://3798442413-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhlUlmj2KD330s7T7Q6vh%2Fuploads%2F206IFNW5oG7rIjzjqpmA%2F2026-08-24_11h08_57.png?alt=media&amp;token=91978abf-77d8-4ef3-b8ec-0620a303983f" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Para agendar o pagamento de documentos classificados como tributos relacionados à fornecedores das categorias cadastradas, utilize o programa [Geração do Borderô de Documento de Conta e Tributo (CCFFE072)](https://ajuda.consistem.com.br/modulos/financeiro/manuais-de-telas/financeiro-contas-a-pagar/pagamento-escritural/geracao-do-bordero-de-documento-de-conta-e-tributo.md).
{% endhint %}

7. No [Cadastro da Ocorrência de Retorno (CCFFE030)](https://ajuda.consistem.com.br/modulos/financeiro/manuais-de-telas/financeiro-contas-a-pagar/tabelas-do-pagamento-escritural/cadastro-da-ocorrencia-de-retorno.md), configure as ocorrências considerando o procedimento específico:

* ***BD** (Pagamento Agendado) -> **Procedimento 1** (Documento Confirmado/Alterado)*
* ***00** (Pagamento Efetuado) -> **Procedimento 2** (Documento Liquidado)*
* ***02** (Pagamento Cancelado) -> **Procedimento 3** (Documento Devolvido/Excluído)*
* ***55** (Pagamento Devolvido) -> **Procedimento 3** (Documento Devolvido/Excluído)*
* ***HA** (Pagamento Rejeitado) -> **Procedimento 4** (Documento Rejeitado)*

<figure><img src="https://3798442413-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhlUlmj2KD330s7T7Q6vh%2Fuploads%2FCv0afLRCyTAdsdiwGGI4%2F2026-08-24_11h14_20.png?alt=media&amp;token=dd70ca55-ffc2-4849-8159-9ddd78d80663" alt=""><figcaption></figcaption></figure>

8. Acesse o programa [Cadastro da Modalidade de Pagamento (CCFFE025)](https://ajuda.consistem.com.br/modulos/financeiro/manuais-de-telas/financeiro-contas-a-pagar/tabelas-do-pagamento-escritural/cadastro-da-modalidade-de-pagamento.md) e vincule as modalidades às formas de pagamento:
   * ***11** (Convênios / Código de Barras) -> **Forma de Pgto 5** (Pagamento de Contas e Tributos)*
   * ***30** (Boletos do Banco) -> **Forma de Pgto 3** (Pagamento de Título do Banco)*
   * ***31** (Boletos Outros Bancos) -> **Forma de Pgto 4** (Pagamento de Título de Outro Banco)*
   * ***41** (TED - Outra Titularidade) -> **Forma de Pgto 2** (Crédito em Conta de Outro Banco)*
   * ***43** (TED - Mesma Titularidade) -> **Forma de Pgto 2** (Crédito em Conta de Outro Banco)*
   * ***45** (Pix) -> **Forma de Pgto 1** (Crédito em Conta do Banco)*

<figure><img src="https://3798442413-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhlUlmj2KD330s7T7Q6vh%2Fuploads%2FgS5jFmDLvQHvyeZ9M7lQ%2F2026-08-24_11h33_40.png?alt=media&amp;token=3bb378e5-1827-48ff-9175-798ec972070d" alt=""><figcaption></figcaption></figure>

9. Informe o código **BBRAP** no programa [Integração (CSINTEGRACAO010)](https://ajuda.consistem.com.br/modulos/componentes/manuais-de-telas/cadastros-gerais-de-componentes/integracao.md);

<figure><img src="https://3798442413-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhlUlmj2KD330s7T7Q6vh%2Fuploads%2FsX8D1JOvg6q1tcBsnNip%2F2026-08-24_11h16_39.png?alt=media&amp;token=fc9482c4-e46b-4b57-aff8-593707b665a3" alt=""><figcaption></figcaption></figure>

10. Na [Aba Dados Gerais (CSINTEGRACAO010ATAB1)](https://ajuda.consistem.com.br/modulos/componentes/manuais-de-telas/cadastros-gerais-de-componentes/cadastro-de-integracao/aba-dados-gerais.md), preencha **Host** (<https://openapi.bradesco.com.br>), **Host Homologação** (<https://openapisandbox.prebanco.com.br>), **Certificado A1**, **Client Key** e **Client Secret**;

<figure><img src="https://3798442413-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhlUlmj2KD330s7T7Q6vh%2Fuploads%2FJOvvOrafyDh2xlEmj1C6%2F2026-08-24_11h19_51.png?alt=media&amp;token=51d5035c-1562-4716-9be6-33db7fc4246e" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Caso a organização possua múltiplas empresas com contas correntes distintas, deve-se preencher o campo **Empresa Integração** e acessar o botão **Empresa**, habilitando a parametrização individualizada para cada unidade.
{% endhint %}

11. Na [Aba Endpoints (CSINTEGRACAO010ATAB2)](https://ajuda.consistem.com.br/modulos/componentes/manuais-de-telas/cadastros-gerais-de-componentes/cadastro-de-integracao.md), ative todos os **endpoints** com retenção de log de, no mínimo, **30 dias**;

<figure><img src="https://3798442413-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhlUlmj2KD330s7T7Q6vh%2Fuploads%2FhD8FfABgNxclvT4fGoGm%2F2026-08-24_11h22_23.png?alt=media&amp;token=384b322a-66fd-467b-a5d4-d310a470ee81" alt=""><figcaption></figcaption></figure>

12. Na[ Aba Integração Manual (CSINTEGRACAO010ATAB3)](https://ajuda.consistem.com.br/modulos/componentes/manuais-de-telas/cadastros-gerais-de-componentes/cadastro-de-integracao/aba-integracao-manual.md), selecione a opção *Obter Token* no campo **Dados** e preencha os dados da empresa para validar a configuração e requisitar o Token;

<figure><img src="https://3798442413-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhlUlmj2KD330s7T7Q6vh%2Fuploads%2F4WVbAvpUPoZTQaPG6C3e%2F2026-08-24_11h24_33.png?alt=media&amp;token=15159f56-785f-41d5-97ec-bf4b8ec3a814" alt=""><figcaption></figcaption></figure>

13. Ative a tarefa **Buscar Documentos Liquidados Bradesco** (Módulo Financeiro - Contas a Pagar) para rodar periodicamente no [Agendamento de Tarefas (CSTASK015)](https://ajuda.consistem.com.br/modulos/componentes/manuais-de-telas/agendamento-de-tarefas-e-processo-em-segundo-plano/agendamento-de-tarefas.md).

<figure><img src="https://3798442413-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhlUlmj2KD330s7T7Q6vh%2Fuploads%2FaXA6c8UchkiDp8Sq1Mdy%2F2026-08-24_11h28_53.png?alt=media&amp;token=ad1aba96-833b-49d4-b710-8480e8e766a7" alt=""><figcaption></figcaption></figure>

**Na integração Bradesco**

1. Acesse o portal [Bradesco Developers](https://developers.bradesco.com.br/) com as credenciais da empresa;

<figure><img src="https://3798442413-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhlUlmj2KD330s7T7Q6vh%2Fuploads%2FyRgSHlAUfWWkck2GaUII%2F2026-08-24_11h30_17.png?alt=media&amp;token=1fbadeca-1eb0-4970-8313-6598a90abf14" alt=""><figcaption></figcaption></figure>

2. Crie e registre a aplicação solicitando as credenciais de acesso (**Client Key** e **Client Secret**);

<figure><img src="https://3798442413-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhlUlmj2KD330s7T7Q6vh%2Fuploads%2FrcR7uQMt9CFM4z6hTYYH%2F2026-08-24_11h38_07.png?alt=media&amp;token=791eecb8-7b23-46df-8a91-2547b2d31fc3" alt=""><figcaption></figcaption></figure>

3. Associe o **Certificado Digital A1** à aplicação;
4. Solicite a ativação das APIs necessárias (**Cobrança**, **Consumo/Tributos**, **Pix** e **TED**) no ambiente de produção e homologação.

### Como a integração funciona

A comunicação é realizada via chamadas HTTP/REST seguras utilizando autenticação por Token (gerado e renovado automaticamente pelo Consistem ERP) e validação por certificado digital. O sistema consome e envia dados estruturados para o Bradesco, respeitando as janelas operacionais de cada serviço.

O acompanhamento detalhado das requisições pode ser feito através do programa [Consulta Logs de Integração (CSINTEGRACAO100)](https://ajuda.consistem.com.br/modulos/componentes/manuais-de-telas/consulta-de-componentes/consulta-logs-de-integracao.md).

### Fluxo do Processo

1. **Geração dos dados:** O usuário gera o borderô no Consistem ERP;
2. **Transformação no leiaute:** Os dados do borderô são convertidos internamente no leiaute padrão da Consistem para a comunicação via API;
3. **Envio da remessa:** O sistema transmite a requisição diretamente aos endpoints do Bradesco (automaticamente na geração ou via Gravação do Arquivo de Remessa (CCFFE100);
4. **Processamento no banco:** O Bradesco valida o *payload* e agenda/executa as transações;
5. **Consulta e conciliação:** A *task* agendada consulta periodicamente os retornos. Os documentos **quitados**, **cancelados** ou **rejeitados** têm seu retorno processado automaticamente via leiaute e atualizados no sistema, ficando pendentes para tratamento manual no programa [Atualização do Arquivo de Retorno (CCFFE170)](https://ajuda.consistem.com.br/modulos/financeiro/manuais-de-telas/financeiro-contas-a-pagar/pagamento-escritural/atualizacao-do-arquivo-de-retorno.md) apenas em caso de divergências.

<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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
