TOTVS WebAgent no Protheus: versões, arquitetura, atualização e guia completo 2026
Guia completo do TOTVS WebAgent: como funciona com o WebApp, versões 1.0.x e geração 1.1.x, instalação, MSI/GPO, 32/64 bits, Office, DLLs, varejo, segurança e troubleshooting.
# TOTVS WebAgent no Protheus: arquitetura, versões, atualização, segurança e boas práticas
Introdução
A migração do TOTVS Protheus para uma experiência centrada no navegador mudou a arquitetura das estações de trabalho. O SmartClient WebApp permite executar o ERP diretamente em navegadores homologados, enquanto o WebAgent entra em cena quando a aplicação web precisa acessar recursos locais que o sandbox do navegador normalmente bloqueia.
Esse detalhe é fundamental: WebApp e WebAgent não são a mesma coisa.
O WebApp entrega a interface do Protheus pelo navegador. O WebAgent é um componente local, opcional para rotinas puramente web, mas necessário em estações que precisam de recursos como leitura e gravação de arquivos locais, integração com Microsoft Office e consumo de bibliotecas nativas — DLLs no Windows, SOs no Linux e Dylibs no macOS.
A importância do tema aumentou especialmente com o Protheus 12.1.2410. A documentação da TOTVS informa que, nessa geração, o uso do SmartClient Desktop instalado na estação foi descontinuado em favor do acesso via SmartClient WebApp. Na prática, administradores de Protheus passaram a precisar dominar WebApp, WebAgent, versões, certificados, atualização automática, arquitetura 32/64 bits, periféricos e troubleshooting.
Este artigo reúne esses pontos em uma visão operacional e arquitetural.
---
# 1. O que é o WebAgent
Navegadores modernos executam aplicações dentro de um sandbox de segurança. Isso é positivo porque impede que qualquer site tenha acesso irrestrito ao computador do usuário.
Por outro lado, um ERP possui necessidades que vão além de uma página web comum.
Exemplos:
- salvar ou ler arquivos locais;
- abrir documentos;
- integrar com Excel e Word;
- acessar impressoras;
- comunicar com pinpads;
- utilizar balanças e outros periféricos;
- consumir DLLs;
- executar integrações locais;
- manter compatibilidade com rotinas originalmente desenhadas para SmartClient Desktop.
O WebAgent funciona como a ponte entre o WebApp e esses recursos locais.
Arquitetura conceitual:
USUÁRIO
|
v
NAVEGADOR
|
v
SMARTCLIENT WEBAPP
|
| necessidade de recurso local
v
WEBAGENT NA ESTAÇÃO
|
+---- Arquivos locais
+---- Microsoft Office
+---- Impressoras
+---- DLLs / SOs / Dylibs
+---- Periféricos
+---- Recursos do sistema operacional
|
v
ESTAÇÃO DO USUÁRIO
O WebAgent não deve ser interpretado como um substituto do AppServer. Ele atua no lado da estação.
---
# 2. Quando o WebAgent é necessário
A própria documentação técnica da TOTVS classifica o WebAgent como serviço opcional nas estações que precisam utilizar determinados recursos locais.
Para rotinas padrão que não dependem desses recursos, o Protheus pode operar no navegador sem WebAgent.
Cenários típicos que justificam WebAgent
Arquivos locais
Rotinas que precisam abrir, selecionar, ler ou gravar arquivos na estação.
Microsoft Office
Integrações com Excel e Word.
Um exemplo prático é a exportação para Excel em rotinas do Protheus: a Central de Atendimento TOTVS informa que a instalação do WebAgent é necessária quando a funcionalidade depende da integração local com o Microsoft Office.
DLLs
No Windows, bibliotecas utilizadas por integrações ou periféricos precisam estar disponíveis para a arquitetura correta do WebAgent.
Varejo e periféricos
Venda Assistida, TOTVS PDV e cenários que usam:
- impressoras;
- pinpads;
- DLLs específicas;
- outros equipamentos locais.
A documentação de Varejo da TOTVS trata WebApp + WebAgent como combinação necessária para comunicação com esses equipamentos no navegador.
---
# 3. WebApp não significa WebAgent obrigatório para todos
Esse é um dos pontos mais confundidos.
WebApp obrigatório
≠
WebAgent obrigatório em toda estação
O WebApp é a camada de acesso web.
O WebAgent é necessário quando a rotina precisa atravessar a barreira do navegador e chegar a recursos locais.
Portanto, uma estratégia de implantação madura pode classificar estações em grupos:
PERFIL A
Usuário administrativo sem integração local
→ WebApp
PERFIL B
Usuário que exporta para Office
→ WebApp + WebAgent
PERFIL C
Caixa / PDV / periféricos
→ WebApp + WebAgent + bibliotecas específicas
PERFIL D
Rotina especializada
→ WebApp + WebAgent + dependências homologadas
Essa classificação reduz instalações desnecessárias e facilita suporte.
---
# 4. Segurança do WebAgent
A TOTVS documenta mecanismos específicos para restringir a comunicação local.
Entre eles:
- comunicação entre navegador e WebAgent por WebSocket Secure — WSS;
- comunicação local pelo endereço localhost;
- utilização do protocolo de comunicação da tecnologia SmartClient/AppServer.
O princípio arquitetural é importante.
O navegador não ganha acesso irrestrito ao computador. O WebAgent funciona como componente controlado para executar capacidades previstas pela plataforma.
Em ambientes corporativos, isso deve ser complementado por:
- gestão de endpoint;
- controle de versões;
- política de instalação;
- antivírus/EDR;
- GPO quando aplicável;
- homologação de DLLs;
- inventário das estações;
- restrição de privilégios;
- atualização controlada.
---
# 5. Compatibilidade básica
A documentação técnica histórica do WebAgent estabelece compatibilidade com WebApp e Application Server mínimos, mas a matriz precisa ser analisada conforme a geração do WebAgent utilizada.
Isso é especialmente importante porque não se deve atualizar WebAgent isoladamente e assumir compatibilidade universal.
A análise deve considerar pelo menos:
Release Protheus
LIB
Application Server
WebApp
WebAgent
Sistema Operacional
Arquitetura 32/64 bits
Navegador
DLLs/periféricos
Em ambientes atuais, essa matriz deve ser registrada formalmente.
---
# 6. Evolução das versões 1.0.x
As notas de release oficiais disponíveis no TDN mostram uma evolução importante da linha 1.0.x.
WebAgent 1.0.12
Entre os ajustes documentados:
- correção relacionada ao
cGetFileno macOS; - assinatura do instalador;
- traduções do calendário;
- correção relacionada a domínio na tela de login.
A TOTVS registrou dependência específica de WebApp e AppServer para uma das correções dessa versão, reforçando a importância da matriz de compatibilidade.
---
# 7. WebAgent 1.0.13
A versão 1.0.13 trouxe correções relacionadas a:
- arquivos e pastas no macOS;
- autenticação com Active Directory;
- execução via
launchcom--no-tray; - bloqueio de arquivos ao encerrar sessão.
Esses itens mostram que o WebAgent não evolui apenas em funcionalidades visíveis. Grande parte das releases trata comportamento do sistema operacional, sessão, integração e estabilidade.
---
# 8. WebAgent 1.0.15 — uma versão muito importante
A 1.0.15 representa um marco operacional.
As notas oficiais registram:
- correção de tela em branco quando o WebAgent não estava iniciado;
- correção de comunicação WebSocket no Linux;
- atualização automática de arquivos extras no Windows;
- distribuição de instalador MSI para Windows.
O MSI é especialmente relevante para empresas com dezenas ou centenas de estações.
Com ele, torna-se viável distribuir o WebAgent usando mecanismos corporativos como GPO.
Atualização automática de arquivos extras
A documentação também descreve, a partir do WebAgent 1.0.15 combinado com WebApp compatível, a possibilidade de distribuir arquivos extras.
Exemplo de aplicação:
DLL_SIGALOJA_Win64.zip
O administrador pode disponibilizar um ZIP que será descompactado na estrutura do WebAgent.
Isso é particularmente útil no varejo.
---
# 9. Certificados no Linux a partir da 1.0.15
Outro avanço importante foi a automação do registro do certificado necessário à comunicação segura entre WebAgent e navegador.
Nas versões anteriores, havia procedimentos manuais.
A partir da 1.0.15, a TOTVS informa que o instalador Linux realiza automaticamente o registro do certificado.
Em ambientes com muitas estações Linux, essa mudança reduz bastante a complexidade operacional.
---
# 10. WebAgent 1.0.16
As notas oficiais registram correções como:
shellExecuterespeitando o parâmetro relacionado a abertura;- listagem de impressoras locais no macOS;
- inicialização da versão Windows 32 bits.
Mas existe uma mudança arquitetural particularmente interessante.
A partir da 1.0.16, a documentação permite trabalhar com duas instalações do WebAgent na mesma estação em cenários específicos de arquitetura.
Exemplo:
Windows 64 bits
Office 32 bits
DLL específica 64 bits
Nesse cenário, pode ser necessário manter WebAgent 32 e 64 bits.
---
# 11. 32 bits ou 64 bits?
Não escolha apenas com base na arquitetura do Windows.
A arquitetura do WebAgent precisa considerar o recurso que será carregado.
WebAgent 32 bits
Pode ser necessário para:
- Microsoft Office 32 bits;
- DLLs 32 bits;
- periféricos cujos drivers/bibliotecas são 32 bits.
WebAgent 64 bits
Adequado para integrações nativas 64 bits.
O erro clássico é:
Windows = 64 bits
logo
WebAgent = obrigatoriamente 64 bits
Isso não é necessariamente verdade.
Se a integração precisa carregar uma DLL 32 bits, a arquitetura do processo precisa ser compatível.
---
# 12. WebAgent 1.0.17
As notas de release registram:
- alteração no retorno de informações de versão do Linux e kernel pela função
GetRmtInfo; - ajuste do auto-update quando WebAgent é utilizado com WebApp 9.2.x.
Para administradores, esse segundo ponto é relevante porque atualização automática precisa ser tratada como parte da compatibilidade WebApp/WebAgent.
---
# 13. WebAgent 1.0.18
As notas de release consultadas registram a implementação do modo kiosk.
O parâmetro:
--kiosk
permite iniciar o ERP em tela cheia por meio do comando launch.
Esse recurso é particularmente interessante para:
- caixas;
- totens;
- terminais dedicados;
- operação de loja;
- estações em que o usuário deve permanecer dentro do ERP.
Exemplo conceitual:
web-agent launch "<endereço WebApp>" --kiosk --browser="<navegador>"
A TOTVS ressalta particularidades do comportamento dos navegadores e informa restrição de homologação do kiosk no macOS para determinado comportamento de interação.
---
# 14. WebAgent 1.0.19
Nas notas de release oficiais indexadas, a versão 1.0.19 aparecia como em desenvolvimento na última revisão daquela página disponível ao mecanismo de pesquisa.
Os itens registrados incluíam correções para:
- retorno de versão da printer;
- execução do binário
barcodescan; - integração com planilha Excel usando Broker HTTP;
- Content-Type via JumpServer;
- timeout de requisição do JumpServer.
Essa lista é interessante porque revela áreas críticas do WebAgent:
IMPRESSÃO
BARCODE
EXCEL
BROKER HTTP
JUMPSERVER
Atenção sobre “última versão”
Não é correto afirmar, com base apenas nessa página histórica de notas, que 1.0.19 seja a versão atual em setembro de 2026. A documentação oficial de compatibilidade evoluiu depois dessa revisão. Portanto, antes de instalar, consulte sempre a Central de Downloads e a matriz oficial vigente.
---
# 15. Geração 1.1.x e nova matriz tecnológica
Documentação técnica secundária que referencia atualização posterior do TDN registra uma mudança de geração: WebAgent 1.1.0 ou superior passa a exigir uma pilha mais recente, com Application Server 24.3.0.0+, WebApp 10.2.0+ e LIB Protheus 12.1.2410+.
Como o índice oficial do TDN acessível nesta pesquisa não expôs diretamente as notas completas dessa geração, este artigo não atribui um número de “última versão estável” sem confirmação na Central de Downloads.
A orientação operacional é simples:
Use a versão homologada para sua combinação de AppServer, WebApp e LIB, não apenas o maior número de versão encontrado na internet.
---
# 16. Release 12.1.2410 e a mudança do SmartClient Desktop
A release 12.1.2410 é central para entender o WebAgent.
A TOTVS anunciou a descontinuidade do SmartClient Desktop instalado na estação em favor do acesso via navegador usando SmartClient WebApp.
O WebAgent foi posicionado como o componente capaz de devolver ao ambiente web acessos locais antes naturalmente disponíveis no SmartClient Desktop.
Isso muda a topologia:
Modelo anterior
ESTAÇÃO
|
SmartClient Desktop
|
AppServer
Modelo WebApp
ESTAÇÃO
|
Navegador
|
WebApp
|
AppServer
Modelo com recurso local
ESTAÇÃO
|
Navegador
|
WebApp
|
+------ WebAgent ------ Recursos locais
|
AppServer
---
# 17. Como configurar a distribuição pelo AppServer.ini
A TOTVS permite definir o download/versão do WebAgent por configuração do ambiente.
Estrutura conceitual:
[WEBAGENT]
VERSION=<versão>
A configuração pode incluir os instaladores por sistema operacional e arquitetura.
O campo VERSION informa a versão disponibilizada aos usuários.
Um detalhe importante documentado pela TOTVS:
ao atualizar os instaladores na pasta de download, atualize também a versão declarada.
O mecanismo pode ser usado tanto para upgrade quanto para downgrade.
---
# 18. Configuração por JSON
A TOTVS também disponibiliza configuração por arquivo JSON.
A vantagem arquitetural é que o JSON pode ser compartilhado entre diferentes AppServers, enquanto a configuração via AppServer.ini precisa ser replicada nos ambientes correspondentes.
Isso é especialmente interessante em:
BROKER
|
+-- AppServer 01
+-- AppServer 02
+-- AppServer 03
+-- AppServer 04
Uma configuração central reduz risco de divergência.
---
# 19. Atualização via GPO
A partir da 1.0.15, o MSI abre uma alternativa corporativa.
Fluxo:
TI
|
v
GPO / Gestão de Endpoint
|
v
MSI WebAgent
|
v
Estações
A TOTVS recomenda atenção para não manter dois mecanismos concorrentes de atualização.
Se a organização decidiu controlar WebAgent por GPO, a atualização automática configurada pelo ambiente deve ser analisada/desabilitada para Windows conforme a estratégia adotada.
Caso contrário:
GPO tenta instalar versão A
+
WebApp tenta atualizar para versão B
=
conflito operacional
---
# 20. Linha de comando
O WebAgent possui parâmetros úteis para administração e diagnóstico.
Versão
web-agent --version
ou:
web-agent -v
Console
web-agent --console
Porta
web-agent --port 21023
A documentação informa a porta padrão 21021.
Log local
web-agent --locallog 1
O log deve ser ativado principalmente quando necessário para diagnóstico/suporte.
---
# 21. Comando launch
O WebAgent pode abrir diretamente o navegador apontando para o ambiente.
Isso permite criar estações com inicialização mais controlada.
Exemplo conceitual:
web-agent launch "<WebApp>"
Com kiosk:
web-agent launch "<WebApp>" --kiosk
Essa combinação é muito interessante para PDV e terminais dedicados.
---
# 22. WebAgent no varejo
No Protheus Varejo, o tema é ainda mais crítico.
A Central de Atendimento TOTVS informa que, para utilizar Venda Assistida, Venda Direta ou TOTVS PDV pelo navegador com equipamentos locais, é necessário configurar WebApp e WebAgent.
Os equipamentos podem incluir:
- impressora;
- pinpad;
- periféricos de caixa;
- DLLs utilizadas pela operação.
Em março de 2026, a TOTVS também publicou orientação específica sobre atualização das DLLs do Protheus Varejo, incluindo validação da versão do SmartClient/WebAgent e localização dos arquivos necessários.
---
# 23. DLLs extras e SIGALOJA
Um ambiente pode estar com WebAgent funcionando e ainda falhar ao abrir uma integração.
Exemplo:
WebAgent OK
+
DLL ausente
=
rotina falha
A partir da geração que suporta arquivos extras, a TI pode automatizar a distribuição das DLLs.
Isso reduz o problema clássico:
Caixa 01 funciona
Caixa 02 funciona
Caixa 03 não funciona
porque alguém copiou uma DLL manualmente apenas em algumas máquinas.
---
# 24. Microsoft Office
A integração com Office merece inventário próprio.
Perguntas que a TI deveria responder:
Office é 32 ou 64 bits?
WebAgent é 32 ou 64 bits?
Qual rotina usa Excel?
Qual rotina usa Word?
Existe DLL intermediária?
A integração está homologada nessa combinação?
Uma incompatibilidade de arquitetura pode parecer erro da rotina quando, na verdade, é problema de bitness.
---
# 25. Sistemas operacionais
A documentação técnica atualizada do WebAgent lista suporte para Windows, Linux e macOS dentro de versões específicas.
Entre os ambientes documentados aparecem:
- Windows 11 Pro/Enterprise;
- Ubuntu 22.04 LTS;
- Ubuntu 24.04 LTS ou superior em versões compatíveis do WebAgent;
- Fedora;
- Oracle Linux;
- Red Hat Enterprise Linux Desktop;
- macOS Ventura ou superior dentro da matriz documentada.
A homologação deve ser conferida no momento da implantação.
---
# 26. O que não é homologado
A TOTVS informa que o WebAgent não é homologado em sistemas como:
- ChromeOS;
- iOS;
- iPadOS;
- Android.
Também há restrições para utilização através de determinadas camadas de virtualização/acesso remoto, como:
- Citrix;
- Windows Remote Desktop;
- Go Global;
- VMware Horizon, conforme artigo de suporte atualizado em 2026.
Isso não significa que o WebApp em si seja equivalente ao WebAgent nesses sistemas. Novamente:
WEBAPP
≠
WEBAGENT
---
# 27. Broker HTTP
Ambientes com balanceamento merecem atenção especial.
As notas de release do WebAgent mostram correções relacionadas ao Broker HTTP, Excel e JumpServer.
Isso significa que testes não devem validar apenas:
Navegador → AppServer direto
Se produção usa Broker, o teste precisa reproduzir:
Navegador
↓
Broker HTTP
↓
AppServer
↓
WebAgent local
Diferenças de rota podem revelar problemas que não aparecem no acesso direto.
---
# 28. Troubleshooting: WebAgent não inicia
Checklist:
- confirme instalação;
- valide processo em execução;
- consulte a versão;
- confirme porta;
- verifique certificado;
- valide navegador homologado;
- verifique política de endpoint/firewall;
- teste acesso sem Broker, quando tecnicamente possível;
- ative log local apenas para diagnóstico;
- compare com estação funcional.
---
# 29. Troubleshooting: impressora não aparece
Investigue:
Sistema operacional
↓
Driver
↓
Arquitetura
↓
WebAgent
↓
Rotina Protheus
Não comece alterando a rotina.
A Central TOTVS possui artigos recentes orientando uso de WebApp/WebAgent em cenários de impressão e Automação/Coleta de Dados.
---
# 30. Troubleshooting: Excel não funciona
Verifique:
- WebAgent instalado;
- Office instalado;
- arquitetura do Office;
- arquitetura do WebAgent;
- permissões da rotina;
- versão WebApp/WebAgent;
- acesso via Broker;
- logs;
- pacote/LIB.
Há documentação TOTVS específica indicando que determinadas funções de exportação para Excel via WebApp dependem do WebAgent.
---
# 31. Troubleshooting: DLL não abre
Fluxo recomendado:
1. Qual DLL?
2. Onde ela está?
3. 32 ou 64 bits?
4. WebAgent tem a mesma arquitetura?
5. Existem dependências?
6. A versão é a homologada?
7. A DLL foi atualizada junto com o pacote?
8. Funciona em outra estação?
No Varejo, a TOTVS publicou em 2026 orientações específicas para atualização de DLLs no WebAgent.
---
# 32. Troubleshooting: Precondition Required
A Central de Atendimento TOTVS publicou em 2026 um caso no módulo Contabilidade em que a mensagem Precondition Required pode estar relacionada a componentes desatualizados.
A orientação envolve verificar atualização do ambiente, incluindo:
- WebApp/WebAgent;
- LIB;
- pacote acumulado;
- AppServer;
- demais binários necessários.
Isso reforça um princípio:
WebAgent deve ser administrado como parte da plataforma Protheus, e não como executável isolado.
---
# 33. Como controlar versões em uma empresa
Crie um inventário.
Exemplo:
| Estação | Usuário | SO | WebAgent | Arquitetura | Office | Perfil | Status |
|---|---|---|---|---|---|---|---|
| CX01 | Caixa | Win 11 | versão homologada | 32 | — | PDV | OK |
| FIN01 | Financeiro | Win 11 | versão homologada | 64 | 64 | Office | OK |
| ADM03 | Administrativo | Win 11 | — | — | — | Web puro | OK |
Esse inventário permite saber quem realmente precisa do agente.
---
# 34. Dashboard de governança do WebAgent
Um BI ou painel de infraestrutura pode controlar:
Estações com WebAgent
Versões instaladas
Versões divergentes
Arquitetura
Sistema operacional
Última atualização
Perfil de uso
Falhas registradas
DLLs exigidas
Office 32/64
Indicadores
% estações na versão homologada
% estações desatualizadas
% estações com arquitetura incompatível
falhas por versão
falhas por SO
falhas por rotina
tempo médio de atualização
Isso transforma o WebAgent em um ativo gerenciado.
---
# 35. Estratégia de homologação
Nunca atualize centenas de estações diretamente.
Sugestão:
LAB
↓
TI
↓
Usuários-chave
↓
Piloto 5%
↓
Piloto 20%
↓
Produção
Teste:
- login;
- arquivos;
- impressão;
- Excel;
- Word;
- DLLs;
- pinpad;
- PDV;
- Broker;
- kiosk;
- rotinas críticas.
---
# 36. Política de atualização
Uma política profissional pode estabelecer:
Nenhuma versão nova de WebAgent entra em produção sem validar a matriz WebApp + AppServer + LIB.
DLLs de varejo devem ser versionadas.
GPO e auto-update não devem disputar o controle da versão.
Estações com Office precisam registrar arquitetura.
Mudanças devem possuir rollback.
A versão instalada deve ser inventariada.
---
# 37. WebAgent e TSS 12.1.2510
Em documentação publicada em 2026 para migração do TSS 12.1.2510, a TOTVS informa que o SmartClient foi descontinuado nessa release do TSS e que o acesso às interfaces gráficas passa a utilizar WebApp, com instalação de WebAgent e atualização do componente WebApp quando necessário.
Isso mostra que a arquitetura web não está restrita ao ERP principal: ela também afeta componentes da plataforma TOTVS.
---
# 38. O futuro operacional
O movimento arquitetural é claro:
ANTES
Aplicativo desktop como interface principal
AGORA
Navegador como interface
+
agente local apenas quando necessário
Esse modelo é comum em arquiteturas modernas porque separa interface e acesso privilegiado ao endpoint.
Para a TI, o resultado é uma nova disciplina:
gerenciamento do WebAgent como componente de endpoint.
---
# 39. Checklist de implantação
Servidor
- AppServer compatível;
- WebApp compatível;
- LIB compatível;
- configuração WebAgent;
- instaladores publicados;
- versão declarada corretamente;
- Broker testado;
- HTTPS/WSS revisados.
Estação
- SO homologado;
- navegador homologado;
- WebAgent instalado quando necessário;
- arquitetura correta;
- certificado;
- Office compatível;
- DLLs corretas;
- periféricos testados.
Operação
- login;
- arquivo local;
- impressão;
- Excel;
- Word;
- DLL;
- PDV;
- pinpad;
- kiosk, quando aplicável.
---
# 40. Conclusão
O TOTVS WebAgent é uma peça pequena em tamanho, mas estratégica na arquitetura atual do Protheus.
Ele existe para resolver uma limitação intencional dos navegadores: aplicações web não devem acessar livremente os recursos locais da máquina.
O WebAgent cria a ponte controlada necessária para que o SmartClient WebApp consiga trabalhar com arquivos, Office, DLLs, impressoras e periféricos.
A evolução das versões mostra uma trajetória clara:
1.0.12/1.0.13
estabilidade, autenticação, macOS e sessão
1.0.15
MSI, arquivos extras, certificados Linux e melhorias de estabilidade
1.0.16
melhorias Windows/macOS e cenários 32/64 simultâneos
1.0.17
GetRmtInfo e auto-update com WebApp 9.2.x
1.0.18
modo kiosk
1.0.19
correções documentadas em desenvolvimento na revisão histórica das release notes
1.1.x
nova geração associada a uma pilha tecnológica mais recente, cuja versão exata homologada deve ser confirmada na documentação/download oficial vigente
O principal aprendizado para administradores Protheus é não perguntar apenas:
“Qual é a última versão do WebAgent?”
A pergunta correta é:
“Qual versão do WebAgent está homologada para meu AppServer, WebApp, LIB, sistema operacional, arquitetura e integrações locais?”
Essa diferença evita grande parte dos problemas de atualização.
Em ambientes corporativos, WebAgent deve ter inventário, matriz de compatibilidade, homologação, distribuição controlada, monitoramento e rollback.
Com a consolidação do WebApp nas releases modernas do Protheus, dominar essa camada deixou de ser um conhecimento periférico. Tornou-se parte da administração cotidiana da plataforma.
Fontes e referências
- WebApp - WebAgent — TOTVS TDN · Acessar fonte · acesso 2026-09-15
- WebAgent - Notas de Release — TOTVS TDN · Acessar fonte · acesso 2026-09-15
- Release 12.1.2410 - Expedição em Outubro/2024 — TOTVS TDN · Acessar fonte · acesso 2026-09-15
- Como configurar WebAPP e WebAgent para uso de equipamentos no Protheus Varejo — Central de Atendimento TOTVS · Acessar fonte · acesso 2026-09-15
- Protheus funciona com WebAgent em dispositivo mobile? — Central de Atendimento TOTVS · Acessar fonte · acesso 2026-09-15
- Como atualizar as DLL do Protheus Varejo — Central de Atendimento TOTVS · Acessar fonte · acesso 2026-09-15
- SIGACTB - Erro Precondition Required — Central de Atendimento TOTVS · Acessar fonte · acesso 2026-09-15
- TSS - Migração para 12.1.2510 — Central de Atendimento TOTVS · Acessar fonte · acesso 2026-09-15
Este artigo é informativo e não substitui orientação profissional individualizada.
Conteúdos relacionados
Configurador de Tributos TOTVS Protheus: tabelas, relacionamentos e BI para governança fiscal
Guia avançado do CFGTRIB/FISA170: principais tabelas do Configurador de Tributos, relacionamentos, F2B, F2D, perfis, escrituração, apuração e arquitetura de BI para controlar regras fiscais.
Rejeição 1026 no Protheus: como corrigir Alíquota do IBS da UF inválida no CFGTRIB
Entenda a Rejeição 1026 no TOTVS Protheus, a relação entre IBS Estadual, CST 200, cClassTrib, redução de alíquota, CJ3 e XML da NF-e.
Rejeição 1026 no Protheus: Impactos em ERP, processos e compliance
Análise atualizada de rejeição 1026 no protheus com fontes oficiais, aplicação prática, riscos, sistemas e próximos passos.