> 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/itau-api-cobranca.md).

# Itaú (API Cobrança)

#### Visão Geral

A integração entre o Consistem ERP e a API de Cobrança do Banco Itaú representa uma evolução na gestão financeira, substituindo o antigo modelo de troca de arquivos (CNAB) por uma conexão direta e em tempo real. Esta solução automatiza o ciclo de vida das cobranças, permitindo o registro imediato de boletos, a emissão de Bolecode (Boleto com QR Code PIX dinâmico) e a recepção de notificações de pagamento instantâneas. Essa sinergia elimina processos manuais e garante que o saldo do Contas a Receber esteja sempre atualizado com a realidade bancária.

#### Requisitos

<table><thead><tr><th width="461">Consistem ERP</th><th>Itaú (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 (Contas a Receber) e Cobrança Escritural implantados.</p><p><strong>Licença:</strong> <a href="https://movidesk.consistem.com.br/form/5801/">Aquisição de licença</a> <strong>ITAU</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://devportal.itau.com.br/">Saiba mais</a></td></tr><tr><td><strong>Certificado:</strong> O certificado gerado no banco deve estar instalado e configurado no servidor (Cache) para autenticação das chamadas.</td><td><strong>Contratação:</strong> Serviço de APIs de Recebimento e Bolecode ativo.</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>Portal:</strong> Cadastro no <a href="https://devportal.itau.com.br/">Portal Developers Itaú</a>.</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>Certificado:</strong> Geração do certificado no portal do banco para instalação no servidor da Consistem.</td></tr><tr><td></td><td><strong>Webhook:</strong> Configuração obrigatória da URL de recepção no painel do Itaú para avisos de liquidação em tempo real.</td></tr><tr><td></td><td><strong>Chave PIX:</strong> Chave ativa vinculada à conta corrente para geração do QR Code.</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 **ITAU** e acione a coluna **Editar**.<br>

   <figure><img src="/files/3BNDxaZDxhDisORU5xeG" 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/R6ftHwXaNHKQDBg12Au3" alt=""><figcaption></figcaption></figure>
3. Na [Aba Endpoints (CSINTEGRACAO010ATAB2)](/componentes/manuais-de-telas/cadastros-gerais-de-componentes/cadastro-de-integracao/aba-endpoints.md), configure os *endpoints* de produção conforme fornecido pelo manual do banco.<br>

   <figure><img src="/files/QuvmsDSSJM2pCI2QexVo" alt=""><figcaption></figcaption></figure>
4. Na [Aba Integração Manual (CSINTEGRACAO010ATAB3)](/componentes/manuais-de-telas/cadastros-gerais-de-componentes/cadastro-de-integracao/aba-integracao-manual.md), utilize a opção *Obter Token* para testar a comunicação. O sistema deve atualizar o campo **Token** (*Bearer*) e a data de expiração.
5. 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>
6. 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>
7. 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 as tarefas *Buscar Títulos Liquidados Itaú* e *Buscar Títulos Liquidados Itaú Webhook* (Financeiro - Contas a Receber) e defina a periodicidade para a execução automática.

{% hint style="info" %}
A tarefa de Webhook garante o processamento das notificações instantâneas enviadas pelo banco e serve como contingência.
{% endhint %}

#### Como a integração funciona

A troca de dados ocorre através do protocolo **HTTPS** utilizando o padrão **RESTful** com mensagens em formato **JSON**.

A inteligência da integração é gerida pelo programa [Integração (CSINTEGRACAO010)](/componentes/manuais-de-telas/cadastros-gerais-de-componentes/integracao.md), que utiliza o protocolo **OAuth2**. O ERP solicita um Token temporário ao banco usando as credenciais e o certificado digital para cada sessão de comunicação. A integração utiliza a API de Emissão para o registro e alteração de boletos e a API PIX para a geração do QR Code dinâmico. O diferencial do Itaú é o Webhook, onde o banco "avisa" o ERP sobre o pagamento no exato momento em que ele ocorre, permitindo a atualização instantânea do sistema.

#### Fluxo do Processo

O fluxo operacional segue o leiaute padrão definido pela Consistem para APIs financeiras:

1. **Geração do Título:** O usuário gera a cobrança no Contas a Receber e processa o borderô através do programa [Geração do Borderô de Remessa (CCCE065)](/financeiro/manuais-de-telas/financeiro-contas-a-receber/cobranca-escritural/geracao-do-bordero-de-remessa.md) ou [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).
2. **Envio (Registro):** O ERP realiza uma chamada síncrona para a API do Itaú. O banco valida os dados e retorna o **Nosso Número** e a **Linha Digitável** instantaneamente.
3. **Bolecode:** Simultaneamente, o sistema solicita o QR Code PIX dinâmico, anexando-o ao PDF do boleto para permitir o pagamento via PIX ou código de barras.
4. **Pagamento e Webhook:** No momento em que o cliente realiza o pagamento, o banco dispara um gatilho (Webhook) para o endereço configurado no ERP.
5. **Processamento do Retorno:** O Consistem recebe a notificação, interpreta o leiaute de retorno e realiza a baixa automática do título no Contas a Receber através do programa [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 sistema atualizado em tempo real sem a necessidade de importar arquivos.

<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/itau-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.