AUTH311: Rota REST ausente

O que isso significa

A rota da loja do WCPOS está indisponível.

Peça ao administrador do site que verifique se algum plugin de segurança ou de proxy está removendo os cabeçalhos das requisições do WCPOS.

O que fazer

É necessário alterar uma configuração antes que isso funcione. Tente de novo depois de fazer a alteração acima; repetir sem ela falhará da mesma forma.

Seus dados

Nenhum dado de pedido ou produto é afetado. Se isso persistir, procure a pessoa responsável pelo seu site WordPress.

Solução de problemas

1. Confirme que o WCPOS está ativo no site: WP Admin → Plugins.
2. Teste as duas formas de REST compatíveis em um navegador: o endereço /wp-json/ da sua loja e /index.php?rest_route=/. Só diagnostique um bloqueio de REST se nenhum dos dois endereços retornar JSON.
3. Se nenhuma das formas de REST funcionar, pergunte ao administrador do site se algum plugin de segurança, proxy ou CDN está removendo os cabeçalhos das requisições do WCPOS ou bloqueando requisições REST — regras de firewall e opções de proteção que desativam a API REST são as causas mais comuns.
4. Em alguns servidores, salvar novamente os links permanentes (Configurações → Links permanentes → Salvar) restaura rotas REST ausentes.

Onde verificar

Quando o WCPOS consegue salvar este erro, ele é registrado no dispositivo que o gerou. Abra Saúde da loja → Logs (o ícone de batimento cardíaco na parte inferior do menu de navegação), localize a entrada marcada com este código e expanda-a: a linha expandida mostra o motivo em linguagem simples e o contexto capturado no momento da falha. Em uma requisição à loja, esse contexto pode incluir o código de erro do próprio servidor (serverCode), o status HTTP ou o endpoint; os campos exibidos dependem de onde a falha ocorreu. Ao relatar um problema, use Copiar informações de depuração no topo da tela de Logs (Compartilhar informações de depuração em celulares e tablets) em vez de capturas de tela: isso reúne a versão do aplicativo, o estado da conexão e os erros mais recentes. Os logs são mantidos por no máximo 30 dias, portanto colete-os enquanto o problema estiver recente. Copie também qualquer erro do console do navegador que tenha aparecido antes de o POS conseguir gravar sua própria entrada de log.

Além do log no aplicativo, esta falha pode deixar evidências em:

• Inspetor de rede (web e desktop): abra as ferramentas de desenvolvedor — pressione F12 no navegador ou use Avançado → Alternar ferramentas de desenvolvedor no menu do aplicativo desktop — e selecione a aba Rede. Siga primeiro as orientações de nova tentativa desta página; só reproduza a ação quando esses passos indicarem que é seguro. Uma requisição com falha mostra o status HTTP e o corpo bruto da resposta, incluindo páginas de erro que nunca chegam ao log do POS.
• WooCommerce → Status → Logs: no site WordPress, verifique o fatal-errors-*.log mais recente em busca de falhas do PHP, além de qualquer fonte de log com o nome de um plugin envolvido na falha. Um erro da classe 500 vindo da loja quase sempre deixa sua causa aqui.

Detalhes

• Código: AUTH311 (REST_ROUTE_MISSING)
• Severidade: error
• Introduzido em: WCPOS 1.10.0