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.
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.