Integração com o Itaú: Boleto via API com PIX | 142295 | Resulth ERP
CONTEXTO
O que muda com esta versão?
Até agora, emitir um boleto pelo sistema exigia o envio manual de arquivo de remessa ao banco. Da mesma forma, pagamentos PIX dependiam de integrações de terceiros. Com esta versão, o sistema se integra diretamente ao Itaú via API, eliminando etapas manuais e intermediários.
Esta atualização entrega duas capacidades complementares:
Parte 1 — Boleto Itaú via API: registro automático de boleto no momento da emissão, sem necessidade de remessa.
Parte 2 — PIX Itaú via API: geração de QR Code dinâmico por venda, diretamente pela API oficial do Itaú.
FLUXO GERAL DE CONFIGURAÇÃO E USO
|
1 Preparar no banco Criar app no portal Itaú e baixar certificados |
2 Configurar no sistema Definir integração, credenciais e carteiras |
3 Emitir / Cobrar Boleto ou PIX gerados automaticamente |
4 Confirmar Sistema aguarda e registra o retorno do banco |
PARTE 1 DE 2 — BOLETO ITAÚ VIA API (REGISTRO ONLINE AUTOMÁTICO) |
O QUE MUDOU — BOLETO
Novo campo "Integração do Boleto Bancário" no cadastro do banco Itaú com as opções: Arquivos, Híbrido e API.
Novo botão "Integração do Boleto" na tela de Parâmetros de Cobrança, visível apenas quando a integração está em Híbrido ou API.
Nova tela "Dados para Integração de Boletos" para preenchimento das credenciais do Itaú Developer.
Registro de boleto passa a ser automático na emissão e reimpressão — sem passo manual adicional.
COMO ACESSAR E CONFIGURAR — BOLETO
⚠ |
Pré-requisito: o que preparar antes de configurar o sistema É necessário solicitar ao gerente do banco as credenciais necessárias para integração via API. O gerente irá passar: o Client ID, Client Secret, e o par de arquivos do certificado digital: a chave .key e o certificado .crt |
Passo 1 — Definir o tipo de integração do banco
Caminho: Cadastro>Bancos (módulo Receber) |
Localize o Itaú e ajuste o campo "Integração do Boleto Bancário" conforme a opção desejada:
Opção |
Envia remessa? |
Comportamento |
Arquivos |
✔ Sim |
Modo tradicional — sem integração API. Padrão do sistema. |
Híbrido |
✔ Sim (fallback) |
Registra online via API e ainda gera arquivo de remessa como segurança. |
API |
✘ Não |
Somente registro online — sem geração de arquivo de remessa. |
Tela Cadastro de Bancos — campo "Integração do Boleto Bancário" com as opções Arquivos, Híbrido e API
Passo 2 — Preencher os Parâmetros de Cobrança
Caminho: Movimento>Cobrança Eletrônica>Parâmetro de Cobrança (módulo Receber) |
Preencha os dados da conta normalmente: banco 0341, agência, conta, dígito verificador, convênio e carteira.
Tela Parâmetros de Cobrança — botão "Integração do Boleto" aparece apenas quando a integração está em Híbrido ou API
Passo 3 — Informar as credenciais de integração
Dentro da tela de Parâmetros de Cobrança, clique no botão "Integração do Boleto". Preencha os campos conforme abaixo:
Campo |
O que informar |
Client ID |
Código obtido no portal Itaú Developer |
Client Secret |
Senha/segredo da aplicação cadastrada no portal |
Arquivo Key |
Caminho do arquivo .key — use o botão "..." para localizar |
Arquivo CRT |
Caminho do arquivo .crt — use o botão "..." para localizar |
Tela "Dados para Integração de Boletos" — Client ID, Client Secret, Arquivo Key e Arquivo CRT
COMO FUNCIONA NO DIA A DIA — BOLETO
Após a configuração acima, o registro é automático: ao emitir ou reimprimir um boleto, o sistema comunica o Itaú via API imediatamente. Não há nenhum passo manual adicional.
💡 |
No modo Híbrido, o sistema ainda gera o arquivo de remessa normalmente, garantindo uma alternativa caso a comunicação com a API do Itaú apresente alguma instabilidade. |
REGRAS DE NEGÓCIO — BOLETO
O botão "Integração do Boleto" só aparece nos Parâmetros de Cobrança quando o campo de integração do banco está definido como Híbrido ou API.
Enquanto a opção for Arquivos, o sistema permanece no modo tradicional de remessa, sem qualquer alteração.
A comunicação com o Itaú exige que o par de certificados .key/.crt seja válido e acessível pelo caminho configurado.
Em caso de falha na comunicação com a API no modo Híbrido, o arquivo de remessa serve como alternativa de registro.
PARTE 2 DE 2 — PIX ITAU VIA API (QR CODE DINÂMICO POR VENDA) |
O QUE MUDOU — PIX
O banco Itau passa a ser opção disponível na tela "Configurações de Carteiras Digitais" para geração de QR Code PIX dinâmico.
Suporte a dois tipos de certificado: PFX (arquivo único com senha) ou Chave/Certificado (arquivos separados).
QR Code gerado diretamente pela API oficial do Itaú, sem intermediários.
Confirmação de pagamento automática: a tela avança sem intervenção manual após o cliente escanear.
Disponível no PDV (frente de caixa) e no DAV/Checkout.
COMO ACESSAR E CONFIGURAR — PIX
⚠ |
Pré-requisito: o que preparar antes de configurar o sistema
A geração e renovação do certificado são feitas exclusivamente pelo portal do Itau. O sistema não realiza essa etapa. |
Passo 1 — Acessar as Carteiras Digitais
Caminho: Cadastros>Parâmetros>Carteiras Digitais |
Dê duplo clique na carteira de PIX desejada. A tela "Configuração de chave PIX" será aberta.
Tela Configurações de Carteiras Digitais — selecione a carteira Itaú e clique duas vezes para editar
Passo 2 — Aba Configuração
Na aba Configuração, preencha:
Banco: Itaú
Ambiente: Producao
Timeout: valor em milissegundos (ex: 90000 = 90 segundos)
Recebedor: nome e endereço da empresa
Se a empresa usa proxy para acesso a internet, preencha também o grupo Proxy com host, porta, usuário e senha.
Aba Configuração — banco Itau selecionado, ambiente Produção e timeout preenchido
Passo 3 — Aba Bancos (credencial e certificado)
Na aba Bancos, com o Itaú selecionado, preencha:
Campo |
O que informar |
Tipo de chave PIX |
CNPJ, CPF, email, telefone ou aleatoria |
Chave PIX |
Valor correspondente ao tipo selecionado |
Client ID |
Codigo da aplicacao no portal Itaú Developer |
Client Secret |
Senha/segredo da aplicação |
Tipo de Certificado |
PFX: informar caminho do .pfx e senha | Chave/Certificado: informar caminho da chave privada e do certificado separadamente |
Aba Bancos — tipo de chave PIX, credencial e certificado configurados para o Itaú
COMO USAR NO DIA A DIA — PIX
No PDV (frente de caixa)
Na tela de encerramento da venda, pressione Ctrl+F6 ou clique em Cart. Digital.
Selecione a carteira PIC Itaú na lista exibida e confirme o valor.
O QR Code é exibido para o cliente escanear no aplicativo bancário.
Após o pagamento confirmado pelo cliente, clique em OK.
Encerramento de Venda — seleção da carteira PIC Itau na lista de carteiras digitais disponíveis
No DAV / Checkout
Na tela de pagamento, selecione a carteira PIX Itaú e informe o valor.
Clique em "Efetivar Pagamento".
O sistema gera um QR Code dinâmico via API do Itau e exibe para o cliente.
Quando o pagamento e identificado, a tela avanca automaticamente sem intervenção manual.
Pagamento com Carteira Digital (PIX) — QR Code gerado via API do Itau com confirmação automática
REGRAS DE NEGÓCIO — PIX
Cada QR Code é único por venda (dinâmico) — não é possível reutilizar um QR Code de outra transação.
O certificado digital deve ser válido e os arquivos acessíveis pelo caminho configurado.
A chave PIX deve estar previamente cadastrada e ativa no portal do banco Itaú.
O campo Ambiente deve ser definido como Produção para operações reais. Configurações em ambiente de homologação não processam pagamentos válidos.
A funcionalidade NF-e na tela de Carteiras Digitais é exclusiva para carteiras do tipo PIX Offline — não se aplica ao PIX Itaú.
BOAS PRATICAS E OBSERVAÇÕES
⚠ |
Guarde os arquivos de certificado em local seguro e com backup. A perda do certificado exige renovação pelo portal do Itaú, o que pode interromper a operação. |
💡 |
O campo Timeout define por quanto tempo o sistema aguardará a resposta do Itaú. O valor padrão de 90000 ms (90 segundos) é adequado para a maioria dos ambientes. Em redes lentas, considere aumentar o valor. |
ℹ️ |
Se a empresa utiliza proxy corporativo, o preenchimento dos dados de proxy na aba Configuração é obrigatório para que o sistema consiga se comunicar com a API do Itaú. |
💡 |
Para editar uma carteira digital existente, faça duplo clique sobre o registro na tela Configurações de Carteiras Digitais. Para excluir, selecione o registro e pressione CTRL + DELETE. |
DESCRIÇÃO |
AUTOR |
VERSÃO E DATA |
Elaboração do documento |
Joaquim Gaspar |
v1.0 – 04/08/2026 |
Revisão do documento |
Tande Guedes |
v1.1 - 10/08/2026 |
Atualização do documento |
Joaquim Gaspar |
v1.2 - 13/08/2026 |