¶ Integração Bancária com o Banco Itaú — Emissão e Confirmação Automática de Boletos
Este tutorial explica como configurar a integração bancária com o Banco Itaú no EmiteFácil para emissão automática de boletos via webservice, confirmação automática de pagamentos e renovação automática de certificado.
¶ O que essa integração faz?
Ao configurar a integração com o Itaú, o EmiteFácil passa a:
- Registrar boletos automaticamente na API do Itaú no momento da emissão
- Confirmar pagamentos em tempo real via webhook: quando o cliente paga, o sistema já baixa o título automaticamente, sem precisar importar arquivo de retorno
- Renovar o certificado digital automaticamente (sem intervenção manual)
¶ Pré-requisitos: obter o Client ID no Portal Itaú
Antes de qualquer configuração no EmiteFácil, você precisa gerar uma credencial no Portal Itaú for Developers para obter o Client ID da sua empresa.
Como gerar a credencial e obter o Client ID:
- Acesse o Itaú for Developers (devportal.itau.com.br) e faça login com os dados da sua empresa
- No menu lateral esquerdo, clique em Credenciais (ícone de chave, seção "Gestão de acessos")
- Na página gestão de credenciais, clique em gerar credencial
- Preencha o formulário:
- nome da aplicação: nome sem espaços, de 4 a 50 caracteres (ex.:
EmiteFacil-Cobranca) - descrição da aplicação: texto de 10 a 256 caracteres
- ambiente: selecione produção
- produtos: selecione o produto de cobrança bancária contratado (geralmente Corban)
- nome da aplicação: nome sem espaços, de 4 a 50 caracteres (ex.:
- Clique em cadastre-se e confirme o aviso de segurança
- O portal exibirá o Client ID — copie este código, pois ele será necessário no EmiteFácil
Atenção: após gerar a credencial, o portal exibe o Client Secret uma única vez. Guarde-o em local seguro caso precise, mas não é necessário informá-lo no EmiteFácil — o próprio sistema gera um novo certificado automaticamente durante a configuração (descrita mais adiante).
¶ Passo 1 — Configurar a Integração Bancária no EmiteFácil
Como acessar: Menu superior Cadastros → Configuração de Integração com Bancos (ou diretamente pela URL /app-integracao-bancaria).
Clique em Nova configuração para adicionar uma integração com o Itaú.
No modal, preencha:
| Campo | O que preencher |
|---|---|
| Banco | Selecione 341-ITAÚ UNIBANCO S.A. |
| Client ID (recebido no e-mail de boas-vindas do Banco Itaú) | Cole o Client ID obtido no portal do Itaú |
Atenção: o campo Client Secret não aparece para o Itaú. Ele será gerado automaticamente na etapa de geração do certificado (Passo 4). Você não precisa preenchê-lo manualmente.
Clique em Salvar.
¶ Passo 2 — Acessar o Cadastro de Conta Bancária
A Carteira de Cobrança (onde os dados específicos do boleto são configurados) fica vinculada à Conta Bancária do EmiteFácil.
Como acessar: Menu superior Financeiro → Contas Bancárias.
Clique na conta bancária do Itaú (já deve estar cadastrada com os dados da agência e conta corrente). Se ainda não existir, clique em Nova Conta Bancária e preencha os dados.
¶ Passo 3 — Criar a Carteira de Cobrança
Com a conta bancária aberta no modo de edição, você verá o campo Esta conta possui emissão de boletos. Marque essa opção — a tabela de carteiras e o botão Nova Carteira de Cobrança serão exibidos logo abaixo.
Clique em Nova Carteira de Cobrança para abrir o modal de configuração.
¶ Passo 4 — Configurar a Carteira e Gerar o Certificado
Preencha os campos do formulário:
| Campo | O que preencher |
|---|---|
| Código da carteira | Código da carteira fornecido pelo Itaú (ex.: 109, 112) |
| Código do Cedente/Beneficiário | Código do beneficiário na cobrança Itaú (consta no contrato com o banco) |
| CNPJ/CPF do cedente | CNPJ ou CPF do titular da conta |
| Tipo de arquivo | Selecione WEBSERVICE para integração automática |
| Variação da Carteira | Preencha conforme orientação do banco (pode ficar em branco se não for exigido) |
| Convênio | Número do convênio de cobrança, se exigido pelo Itaú |
| Integração bancária | Selecione a integração criada no Passo 1 |
| Status | Deixe marcado como Ativa |
Após selecionar a integração bancária, o botão Gerar certificado será exibido ao lado do campo. Clique nele.
O que acontece ao gerar o certificado:
- O EmiteFácil gera internamente uma CSR (requisição de certificado) com os dados da sua empresa
- A CSR é enviada automaticamente para o servidor de segurança do Itaú (
sts.itau.com.br) - O Itaú retorna o Client Secret e o certificado digital assinado
- O certificado é armazenado no sistema e a data de validade é exibida na tela
Dica: o certificado é válido por aproximadamente 1 ano. O EmiteFácil renova automaticamente quando faltarem entre 60 e 90 dias para o vencimento — você não precisa se preocupar com isso.
¶ Passo 5 — Configurar os Padrões dos Boletos
Logo abaixo dos campos principais, há uma seção Informação padrão aos títulos gerados:
Configure conforme a política da sua empresa:
| Campo | Descrição |
|---|---|
| Espécie de documento | Tipo de documento (Duplicata, Fatura, etc.) |
| Desconto | Percentual de desconto padrão (0 = sem desconto) |
| Juros diários | Percentual de juros ao dia após o vencimento |
| Multa | Percentual de multa aplicado após o vencimento |
| Dias para crédito em conta | Quantos dias até o valor ser creditado |
| Limite de dias para pagamento | Após quantos dias o boleto vence e não pode mais ser pago |
| Protestar automaticamente | Marque se quiser que títulos sem pagamento sejam enviados a protesto |
| Texto padrão | Mensagem que aparecerá impressa em todos os boletos desta carteira |
Dica: use
{emissao_mes_ano}no campo de texto padrão para substituir automaticamente pelo mês/ano de emissão do boleto. Exemplo:Competência: {emissao_mes_ano}.
¶ Passo 6 — Ativar o Webhook
O webhook é responsável pela confirmação automática de pagamentos: quando o cliente paga o boleto, o Itaú notifica o EmiteFácil instantaneamente e o sistema baixa o título automaticamente.
Na seção Webhook (ao final do modal), clique em Ativar Webhook no banco.
O sistema registra a URL de notificação na API do Itaú. A partir desse momento:
- Pagamentos do tipo BAIXA_EFETIVA (pagamento normal) e BAIXA_OPERACIONAL (pagamento por acordo) são processados automaticamente
- O título é baixado em Contas a Receber sem necessidade de importar arquivo de retorno CNAB
Atenção: o webhook precisa ser ativado uma vez por carteira. Se você criar uma nova carteira ou trocar a integração, repita este passo.
¶ Passo 7 — Salvar e Verificar
Clique em Salvar para gravar a carteira de cobrança. Em seguida, salve também a conta bancária.
A partir desse momento, ao emitir boletos pelo EmiteFácil vinculados a esta carteira, eles serão:
- Registrados automaticamente na API do Itaú ao serem gerados
- Baixados automaticamente em Contas a Receber quando o cliente efetuar o pagamento
¶ Fluxo resumido
Portal Itaú → Copiar Client ID
↓
EmiteFácil: Cadastros → Configuração de Integração com Bancos → Nova configuração (banco 341 + Client ID)
↓
EmiteFácil: Financeiro → Contas Bancárias → (sua conta Itaú) → Editar
↓
Marcar "Esta conta possui emissão de boletos" → Nova Carteira de Cobrança
↓
Preencher dados + Tipo de arquivo: WEBSERVICE + Integração bancária → Gerar certificado
↓
Configurar juros/multa/desconto padrão
↓
Ativar Webhook no banco → Salvar
¶ O que o sistema faz automaticamente
| Ação | Automação |
|---|---|
| Registro do boleto | Ao emitir, o sistema registra no Itaú e grava o nosso número |
| Confirmação de pagamento | Via webhook em tempo real (sem importar arquivo CNAB) |
| Renovação do certificado | Automaticamente 60–90 dias antes do vencimento |
¶ Perguntas frequentes
Preciso importar arquivo de retorno (CNAB) mesmo com a integração ativa?
Não. Com o webhook ativo, as confirmações de pagamento chegam em tempo real. O arquivo de retorno se torna desnecessário para baixas de pagamento. Você pode continuar importando se quiser, mas não é obrigatório.
O que acontece se o webhook ficar inativo?
Os boletos continuam sendo registrados normalmente. Apenas a confirmação automática de pagamento deixa de funcionar — você precisaria importar o arquivo de retorno CNAB até reativar o webhook.
O certificado pode ser gerado mais de uma vez?
Sim. Se houver problema com o certificado atual (expirado, corrompido), clique em Renovar certificado (botão que aparece no lugar de "Gerar certificado" após a primeira geração). O sistema solicitará um novo certificado ao Itaú.
Posso ter mais de uma carteira de cobrança na mesma conta?
Sim. Cada carteira tem sua própria configuração de juros, multa, código de carteira e webhook. Você pode criar quantas forem necessárias para a mesma conta bancária.
Onde configuro o Gerar Boleto com PIX?
No campo Gerar Boleto c/ PIX dentro da Carteira de Cobrança. Quando marcado, o boleto gerado incluirá um QR Code para pagamento via Pix. Disponível conforme contrato com o banco.