Data de publicação: 28/04/2026
🎯 Objetivo
Orientar o uso do SmartClient HTML (WebApp) em dispositivos móveis, destacando os cenários homologados, limitações de uso em smartphones, comportamento da opção “Site para computador” e recomendações práticas de usabilidade. (TDN)
🧩 Ambiente
TOTVS TEC – SmartClient HTML (WebApp)
Página técnica atualizada em 02/03/2026. A documentação trata especificamente do uso do WebApp em dispositivos móveis. (TDN)
🔎 Visão geral
A TOTVS informa que o SmartClient WebApp possui suporte específico para determinados dispositivos móveis e navegadores, e que a documentação apresenta os cenários homologados, limitações conhecidas e recomendações de uso. (TDN)
De forma objetiva, o ponto principal é que o uso móvel foi pensado com foco em tablets, especialmente no contexto do ERP Protheus, enquanto o uso em smartphones não é homologado. (TDN)
✅ Dispositivos homologados
Tablets
Segundo a TOTVS, o SmartClient WebApp é homologado para uso em tablets, exclusivamente no contexto do ERP Protheus. A experiência foi projetada considerando dispositivos com maior área de tela e uso corporativo. (TDN)
Smartphones
A documentação é clara ao informar que o uso em smartphones não é homologado. Entre os problemas que podem ocorrer nesse tipo de dispositivo, a TOTVS destaca:
problemas de usabilidade;
elementos sobrepostos;
dificuldade de navegação;
redução de produtividade. (TDN)
⚠️ Uso da opção “Site para computador”
Em navegadores móveis, existe a opção “Site para computador” ou “Versão para desktop”, porém a TOTVS informa que essa opção não é homologada para uso com o SmartClient WebApp. (TDN)
Ao habilitar esse recurso, o navegador passa a simular um ambiente desktop, o que pode alterar:
a identificação do dispositivo móvel;
o comportamento do viewport;
as regras de responsividade;
recursos específicos para dispositivos móveis. (TDN)
A documentação também alerta que, ao simular um ambiente desktop, os recursos do WebAgent podem aparecer como se estivessem disponíveis no dispositivo móvel, o que pode:
impactar o fluxo normal de utilização;
induzir à tentativa de instalação do pacote do WebAgent;
gerar inconsistências operacionais. (TDN)
🛠️ WebAgent em dispositivos móveis
A TOTVS esclarece que o pacote do WebAgent é fornecido somente para ambientes homologados, com binários específicos para:
Linux
macOS
Windows (TDN)
Não há suporte nem homologação do WebAgent para execução em dispositivos móveis. Por isso, para garantir o funcionamento correto do SmartClient WebApp, a recomendação oficial é utilizar o sistema no modo padrão de navegação móvel, sem ativar a opção “Site para computador”. (TDN)
🌐 Navegadores homologados
A recomendação da TOTVS é utilizar navegadores modernos baseados em Chromium, devidamente atualizados. A própria página ainda direciona para a documentação complementar de navegadores homologados. (TDN)
⌨️ Recomendações de usabilidade
Para melhorar a experiência de uso em dispositivos móveis, a TOTVS recomenda desativar no teclado virtual as opções:
sugerir emojis;
sugerir stickers ao digitar;
substituição automática;
sugerir correção de texto. (TDN)
Segundo a documentação, essas funcionalidades podem:
sobrepor campos de entrada;
reduzir a área útil da tela;
impactar a digitação em telas com múltiplos campos. (TDN)
A TOTVS também orienta verificar na documentação do ERP os requisitos mínimos de resolução e formato de tela. (TDN)
✅ Resultado esperado
Com a utilização em tablet homologado, em navegador compatível e no modo padrão de navegação móvel, o SmartClient WebApp tende a oferecer uma experiência mais estável e aderente ao cenário validado pela TOTVS. Já o uso em smartphone ou com simulação de site desktop aumenta o risco de problemas operacionais e de usabilidade. Essa conclusão é uma síntese direta das restrições e recomendações descritas na documentação oficial. (TDN)
💡 Boas práticas
priorizar o acesso ao WebApp em tablets, e não em smartphones;
evitar o uso da opção “Site para computador” no navegador móvel;
não tentar utilizar WebAgent em dispositivo móvel;
manter o navegador sempre atualizado, preferencialmente baseado em Chromium;
ajustar o teclado virtual para reduzir interferências na digitação;
validar resolução e formato de tela conforme a documentação do ERP. (TDN)
❓ FAQ
1. O SmartClient WebApp é homologado para smartphone?
Não. A TOTVS informa que o uso em smartphones não é homologado. (TDN)
2. O uso em tablet é permitido?
Sim. O uso é homologado em tablets, exclusivamente no contexto do ERP Protheus. (TDN)
3. Posso usar a opção “Site para computador” no navegador?
Não é recomendado. A TOTVS informa que essa opção não é homologada para o SmartClient WebApp. (TDN)
4. O WebAgent funciona em celular ou tablet?
Não. A documentação informa que não há suporte nem homologação do WebAgent para dispositivos móveis. (TDN)
5. Quais navegadores são recomendados?
A TOTVS recomenda navegadores modernos baseados em Chromium, devidamente atualizados. (TDN)
6. O teclado do celular pode impactar a usabilidade?
Sim. A TOTVS recomenda desativar sugestões automáticas e correções do teclado porque esses recursos podem sobrepor campos e reduzir a área útil da tela. (TDN)
👤 Autor
Fabrizio Augusto Ventavolo
Consultor Especialista TOTVS — Mastersiga Consultoria
“Conectamos tecnologia, processos e pessoas para acelerar resultados com excelência em sistemas TOTVS.”