Pular para conteúdo

Troubleshooting / FAQ

Problemas comuns e onde olhar. Para o significado das tabelas, veja Cadastros e Tabelas e rotinas.

Autenticação

Endpoint responde 401
  • Token ausente/expirado — o front deveria reautenticar (retry único). Confirme AUTH_ENABLED=true e AUTH_USER/AUTH_PASS no config.json.
  • AUTH_PASS precisa ser o MD5 da senha real gravada em MLTEC_0053.SENHA.
  • Conta APONTA com senha placeholder (TROCAR-APONTA) ou ATIVO='0' → login falha.
  • tlppdata do appserver.ini deve apontar para u_validaToken/u_paramsProvider.
Token emite, mas todos os apt* dão 401

Verifique o noCheckUri e se o validaToken está compilado. Ao trocar de appserver/proxy, revalide a isenção do endpoint de token.

Apontamento

Não consigo apontar / pausar (operação bloqueada)

A OP provavelmente está encerrada (SC2.C2_DATRF preenchido) — os guardas U_ApOpFechada / U_ApSessOpFechada bloqueiam escrita. Descarte de sessão (apt008) continua permitido.

Erro 400 ao buscar OP/produto/operador

Entrada fora do formato esperado (whitelist utilApt): OP = 11 dígitos, operação ≤ 5 dígitos, recurso ≤ 6, produto ≤ 15, operador ≤ 14. Confira o valor enviado.

\"Sessão já ativa\" ao iniciar

Índice único parcial em MLTEC_0051 impede duas sessões ativas (I/P) na mesma OP+Operação. Encerre/descarte a sessão anterior.

Apontamento não aparece no Protheus

A gravação usa MSExecAuto (MATA681/MATA685/MATA250). Verifique o log do endpoint e a auditoria (MLTEC_0054) — o campo MENSAGEM/RESULTADO traz o erro do ExecAuto. Confira também empresa/filial do ambiente (RestConfigurationOnStart).

Estorno

Estorno negado (401) mesmo com supervisor

apt012 valida a senha no servidor (PswSeek/PswName). Confirme usuário/senha de supervisor válidos no Protheus. apt011 é só pré-checagem de UX — não autoriza.

Documentos (PDF)

Documento não abre na base de conhecimento

O apt023 só retorna anexos com BASE64 válido (AC9/ACB). Se o objeto estiver sem conteúdo, a linha é ignorada. Verifique o anexo na Gestão do Conhecimento (GED).

Frontend / rede

Banner de offline aparece / operações bloqueadas

navigator.onLine detectou queda de rede. Operações que exigem o ERP ficam indisponíveis até a conexão com o Protheus voltar. Verifique a LAN e o servidor REST.

Acentuação estranha na tela

Textos da UI são UTF-8. As respostas do backend usam EncodeUTF8; os fontes .tlpp permanecem ASCII. Se algo vier torto, verifique ContentTypes (charset UTF-8) no appserver.ini.

CORS bloqueado no modo hospedado

CORS AllowOrigins no appserver.ini deve casar exatamente com o domínio do front (ex.: https://CLIENTE.mltecnologia.com.br).

Cadeado inválido / chamadas ao ERP falham por certificado

No modo direto, um fetch() para um endpoint com certificado não confiável falha sem aviso de "avançar". Instale a raiz (totvs_certificate_CA.crt) nas estações e confira que o SAN do certificado inclui o IP/host usado. Se o IP mudou, regenere a folha — ver Certificado HTTPS (TLS).

Token dá 401 no modo direto (mas funciona no proxy)

O oauth2/token do TLPP lê grant_type/username/password da query string, não do corpo. No modo proxy o proxy.php traduz corpo→query; no modo direto o front precisa enviar esses parâmetros na URL (POST com corpo vazio). Verifique a montagem da requisição de token.

PWA não atualiza após deploy

Suba a versão do cache do Service Worker (apontamento-producao-vN) e version.json. O SW serve do cache até detectar a nova versão.

Auditoria vazia

MLTEC_0054 sem registros / apt030 vazio

Alinhe empresa/filial do deploy — há hardcodes '01' em mltecLog/paramsProvider. Confirme o RpcSetEnv do RestConfigurationOnStart para a empresa/filial reais do cliente.