Configuração de cobrança bancária - ERP UAU

Se seu UAU está hospedado na Cloud Senior, não é necessário fazer nada de infraestrutura. A Senior já cuida de:

• Nova cadeia de certificados;
• Liberações de IP;
• Configurações de ambiente.

Ação necessária: Manter o UAU atualizado na versão que contempla os novos endereços das APIs do Itaú.

Você deve executar os 4 passos abaixo:

• Passo 1: Atualizar o UAU (obrigatório): a versão mais recente já contém os novos endereços das APIs do Itaú. Após a atualização, você não precisa alterar nada manualmente — o sistema passa a usar os novos endereços automaticamente.

  Importante

  Os próximos passos são necessários apenas se você encontrar erros de comunicação com o Itaú.

• Passo 2: Instalar a cadeia de certificados GlobalSign:

  • Baixe os certificados:

    1. Acesse o Portal do Desenvolvedor do Itaú
       

    2. Faça o download dos três certificados:
       

       • GlobalSign Root R46.
         
       • GlobalSign GCC R46 OV TLS CA 2025.
         
       • GlobalSign GCC R46 EV TLS CA 2025.
         

    3. Salve os arquivos .cer em uma pasta acessível no seu servidor
       

  • Instale os certificados (Windows): Abra o PowerShell como Administrador e execute os comandos abaixo (substitua o caminho conforme onde você salvou os arquivos):

    • Import-Certificate -FilePath "C:\caminho\GlobalSign Root R46.cer" -CertStoreLocation Cert:\LocalMachine\Root
      

    • Import-Certificate -FilePath "C:\caminho\GlobalSign GCC R46 OV TLS CA 2025.cer" -CertStoreLocation Cert:\LocalMachine\CA
      

    • Import-Certificate -FilePath "C:\caminho\GlobalSign GCC R46 EV TLS CA 2025.cer" -CertStoreLocation Cert:\LocalMachine\CA
      

    Importante

    Use LocalMachine (repositório da máquina), não por perfil de usuário. O UAU é executado por uma conta de serviço que reconhece apenas certificados do repositório da máquina.

  • Valide a instalação: Verifique se os certificados aparecem no Gerenciador de Certificados do Windows. Tente estabelecer uma conexão com o Itaú novamente. Confirme se os erros de SSL desapareceram.
    

• Passo 3: Liberar IPs do Itaú no seu Firewall: Necessário quando o firewall controla o tráfego de saída por endereço de IP. e quando existem regras que bloqueiam comunicação com IPs externos

  • O que você pode fazer: Autorize a comunicação de saída pela porta 443 (HTTPS) para os seguintes endereços de IP do Itaú:

    • 200.196.155.117/32<br/>

    • 138.59.163.117/32<br/>

    • 138.59.163.69/32<br/>

    • 3.44.192.200/29<br/>

    
    Exemplo de regra de firewall:
    • Protocolo: HTTPS (443)
      
    • Destino: IPs listados acima
      
    • Direção: Saída
      
    • Ação: Permitir
      Teste a comunicação entre seu servidor e as APIs do Itaú para confirmar que a liberação funcionou.

• Passo 4: se você executou o Passo 2 é necessário reiniciar IIS e Serviços do UAU.

  • Abra o PowerShell como Administrador e execute:

    • iisreset

  • manualmente:

    1. Abra Serviços no Windows (services.msc);
       
    2. Localize os serviços do UAU;
       
    3. Reinicie cada um deles.
       

Dúvidas ou Problemas?: Consulte a documentação técnica oficial do Itaú