Cross Segmentos - Backoffice Linha RM - FIN - Adequações necessárias no RM Gestão Financeira para o Registro Online de Boletos Banco Itaú a partir de 15/09/2026

Tempo aproximado para leitura: 00:07:44 min

Dúvida

O Banco Itaú está enviando um comunicado informando que, a partir de 15/09/2026, serão necessárias algumas adequações para garantir a continuidade do funcionamento das integrações via APIs com o banco referente ao Registro Online de Boletos. Como realizar as adequações necessárias no RM Gestão Financeira devido às atualizações de segurança, novas faixas de IP e alteração de URLs (endpoints) de API do Banco Itaú?
 

Ambiente

Cross Segmento - TOTVS Backoffice (Linha RM) - TOTVS Gestão Financeira - Todas as versões
 

Solução 

Do lado da aplicação TOTVS RM Gestão Financeira, não é necessária a liberação de patch ou alteração no código do sistema. 

O produto utiliza os mecanismos nativos do sistema operacional (.NET Framework) para a comunicação segura via HTTPS/TLS.

Ações Necessárias na Infraestrutura e Parâmetros

A adequação depende exclusivamente de ajustes de infraestrutura, redes e parametrização no ambiente onde os servidores do TOTVS RM (IIS, Servidor de Job e Servidor de Aplicação) estão instalados.

A equipe de TI do cliente e os responsáveis pelos cadastros devem realizar as seguintes ações obrigatórias:

1: Importação da Nova Cadeia de Certificados (Windows Server)

O Banco Itaú atualizará a Root CA (Autoridade Certificadora Raiz) e o Certificado Intermediário de seus servidores.

• Ação: A equipe de TI precisará baixar o pacote de certificados no Portal do Desenvolvedor do Itaú e instalá-los nos servidores onde o TOTVS RM é executado.
• Windows Update: Se o sistema operacional Windows Server estiver com as atualizações em dia, a nova Root CA do Itaú costuma ser importada e reconhecida automaticamente via Windows Update.
• Observação Importante: Deve-se manter a cadeia atual e apenas adicionar a nova, garantindo que o sistema continue se comunicando sem interrupções até a virada definitiva por parte do banco.

2: Liberação dos Novos IPs no Firewall

O Itaú adicionará novas faixas de IPs de destino para responder às requisições das APIs.

• Ação: Liberar o tráfego de saída no firewall dos servidores do TOTVS RM para os novos blocos de IP divulgados pelo banco.
• Novas Faixas de IP (para o domínio api.gateway.itau.com.br):
  • 200.196.155.117/32
  • 138.59.163.69/32
  • 3.44.192.200/29
     

3: Atualização das URLs (Endpoints) no Cadastro de Convênio

Algumas chamadas de API passarão a responder no novo domínio do Itaú (api.gateway.itau.com.br).

• Ação: A equipe responsável pela manutenção dos cadastros no sistema deverá acessar o Cadastro de Convênio do TOTVS Gestão Financeira e atualizar os campos referentes aos endpoints de Token e Registro conforme as orientações do banco.
   

Detalhamento das URLs

1. URL do Serviço Autorizador (Token):
   • Atual: https://sts.itau.com.br/api/oauth/token
   • Nova: Conforme a documentação atual do Itaú, a URL sts.itau.com.br não sofrerá alteração. 
      
2. URL do Serviço de Registro de Cobrança:
   • Atual: https://api.itau.com.br/cash_management/v2
   • Nova: https://api.gateway.itau.com.br/cash_management/v2

Importante:

•  O certificado da empresa que é importado no cadastro de certificado do TOTVS Gestão Financeira, NÃO é afetado nessa atualização de segurança e continua da mesma forma.
   
• Clientes TOTVS Cloud: Por padrão não há bloqueio de saída. Caso tenha algum caso especifico, será necessário entrar em contato time Cloud TOTVS.
   
• Homologação e Testes: Durante a implementação inicial do registro online do Banco Itaú, não se obteve sucesso na execução de testes no ambiente de Sandbox. 
  
  Por esse motivo, sugerimos que os testes de conectividade e validação das novas URLs sejam realizados diretamente no ambiente de produção, efetuando um teste funcional de emissão/registro de boleto de baixo valor.
   
• Integrações com as soluções TechFin: As integrações do TOTVS Gestão Financeira com as soluções de TechFin Recebe+ MultiBanco (TPD) e Recebe+ Boleto híbrido, no qual utiliza conta do banco itaú, não há necessidade de efetuar alterações no produto e na infraestrutura, pois a comunicação com o banco Itaú ocorre na camada de techfin.

Saiba Mais:

Acesse a documentação completa para obter mais detalhes sobre a atualização de segurança e o vencimento de certificados sobre o Banco Itaú.

Consulte a documentação para obter mais detalhes sobre Registro Online de boleto Banco Itaú.