Configurar SmartClient WebApp (browser)

SmartClient WebApp permite acesso ao Protheus via browser (Chrome, Edge, Firefox) — sem precisar instalar SmartClient desktop. Util pra usuarios remotos, mobile, integradores.

1. Habilitar no appserver.ini

[WEBAPP]
ENABLE=1
PORT=8080
INSTANCES=1,5
INSTANCENAME=WEBAPP
WEBAPPLISTENERVISIBLE=1

; HTTPS (recomendado pra producao):
[WEBAPP]
SECURITYLEVEL=1
SECURITYTYPE=2
CERTIFICATE=\certs\appserver.pfx
CERTIFICATEPASSWORD=senha

2. Disponibilizar arquivos do WebApp

SmartClient WebApp e composto de arquivos JS/HTML/CSS que vem no pacote do TOTVS:

• Pasta padrao: {AppServer}/SmartClient_Web
• Copiar pra pasta servida pelo AppServer (geralmente web/)

3. Configurar app.json (parametros do WebApp)

{
  "server": "localhost",
  "port": 1234,
  "smartclientURL": "http://localhost:8080/webapp/",
  "environment": "PRODUCAO",
  "program": "SIGAFAT"
}

4. Restart e acessar

# Restart do servico
systemctl restart appserver  # Linux

# Acessar:
https://seu-server.com:8080/webapp/?program=SIGAFAT&env=PRODUCAO

5. Customizar tema/logo

Edite os arquivos em web/:

• logo.png: logo do cliente (192x192 recomendado)
• app.json: cores principais
• favicon.ico: icone do browser

6. Pegadinhas comuns

• CORS: se acessar de dominio diferente, configurar Access-Control-Allow-Origin no AppServer
• Permissoes: alguns modulos (TAF, Compras) nao funcionam 100% em WebApp — testar antes
• Impressao: WebApp usa printer do browser — pode quebrar relatorios DOS-style
• Sessao: timeout do browser e separado do AppServer — usuario pode "desconectar" sem fechar tela
• Versao do TOTVS: SmartClient WebApp evolui rapido — Mantenha o mesmo build do AppServer

7. Validacao via curl

# Verifica se WebApp esta respondendo:
curl -I http://localhost:8080/webapp/

# Esperado: HTTP/1.1 200 OK