Visão Geral
Ao realizar a importação via API, alguns usuários podem encontrar a seguinte mensagem de erro:
"O .NET 8 (ou superior) não está instalado nesta máquina. Instale o .NET Runtime/SDK 8 ou superior para utilizar a importação via API."
Esse erro ocorre quando o sistema não encontra a versão necessária do .NET para executar a integração corretamente.
Sintomas
Ao tentar realizar uma importação via API:
- É exibida a mensagem informando a ausência do .NET 8 ou superior
Causa
Apesar da mensagem mencionar a necessidade do .NET 8 ou superior, em muitos ambientes é necessário que esteja instalada especificamente a versão:
✅ .NET Runtime 8.0 x86 (32 bits)
Mesmo em sistemas operacionais Windows de 64 bits, algumas integrações ou componentes legados podem depender da arquitetura x86 para funcionar corretamente.
Quando apenas a versão x64 está instalada, o sistema pode não localizar os componentes necessários e apresentar o erro.
Solução
1. Validar se o .NET Runtime 8.0 x86 está instalado
Acesse:
Painel de Controle → Programas e Recursos
ou
Configurações → Aplicativos → Aplicativos Instalados
Verifique se existe uma entrada semelhante a:
Microsoft .NET Runtime 8.x (x86)
Caso não esteja presente, prossiga com a instalação.
2. Baixar o .NET Runtime 8.0 x86
Como apoio do time de TI da empresa, acesse a página oficial da Microsoft:
Download oficial do .NET 8.0 https://dotnet.microsoft.com/download/dotnet/8.0
Na seção Runtime:
- Localize o .NET Runtime 8.0.
- Selecione a arquitetura x86 (32 bits).
- Faça o download do instalador correspondente.
3. Executar a instalação
Após o download:
- Execute o instalador como administrador.
- Aguarde a conclusão da instalação.
- Reinicie o computador, se solicitado.
4. Testar novamente a integração
Após a instalação do .NET Runtime 8.0 x86:
- Abra novamente o sistema.
- Acesse a funcionalidade de importação via API.
- Execute uma nova tentativa de importação.
A operação deverá ocorrer normalmente.
Como confirmar a instalação
Abra o Prompt de Comando e execute:
Deverá ser exibida uma entrada semelhante a:
Caso a versão 8 não apareça, a instalação não foi concluída corretamente.
Ao executar o comando acima é apresentada a seguinte mensagem:
'dotnet' não é reconhecido como um comando interno ou externo, um programa operável ou arquivo em lotes.
Esse comportamento ocorre quando o executável do .NET está instalado na máquina, porém o caminho da instalação não está configurado corretamente na variável de ambiente PATH do Windows.
O sistema utiliza a variável PATH para localizar executáveis e, quando o diretório do .NET não está configurado, o comando dotnet não pode ser encontrado.
Como validar a instalação do .NET
Verifique se o arquivo dotnet.exe existe no caminho de instalação:
C:\Program Files (x86)\dotnet
Caso o arquivo dotnet.exe esteja presente, o problema está relacionado apenas à configuração da variável PATH.
Como corrigir o PATH do Windows
Pressione Windows + R.
Digite:
sysdm.cpl
Acesse a guia Avançado.
Clique em Variáveis de Ambiente.
Em Variáveis do Sistema, localize a variável Path e clique em Editar.
Clique em Novo e adicione o caminho correspondente à instalação do .NET:
C:\Program Files (x86)\dotnet
Salve as alterações clicando em OK em todas as janelas.
Validação
Após a configuração, abra um novo Prompt de Comando e execute:
dotnet --version
O comando deverá retornar a versão instalada do .NET, por exemplo:
8.0.129
Também é possível validar a instalação com:
dotnet --info
Importante
Após realizar a alteração da variável de ambiente PATH, recomenda-se reiniciar a máquina para garantir que todas as sessões do Windows carreguem corretamente a nova configuração.
Após a reinicialização, execute novamente:
dotnet --version
Conclusão
O erro de importação via API está relacionado à ausência do .NET Runtime 8.0 x86 (32 bits) na estação de trabalho. A instalação dessa dependência permite que a integração encontre os componentes necessários para execução da importação, eliminando a mensagem de erro e restabelecendo o funcionamento normal do processo.
Recomendação: sempre utilizar o instalador oficial da Microsoft e contar com o apoio da equipe de TI para garantir a instalação correta dos pré-requisitos do ambiente.