Solução de problemas
Resolva problemas comuns de instalação, conexão, cron, REST API e sincronização do plugin WooCommerce.
Comece em WooCommerce > Fullmetrix. Registre a mensagem exata e o horário antes de desconectar, desativar ou reinstalar o plugin.
O plugin não pode ser ativado
- Confirme que o WooCommerce está instalado e ativo. A Fullmetrix se desativa quando o WooCommerce não está disponível.
- Verifique se o WordPress é 6.2 ou posterior e o PHP é 7.4 ou posterior.
- Em Plugins > Installed Plugins, confirme que existe somente um conector da Fullmetrix.
- Consulte o log de depuração do WordPress e o log de erros do PHP no horário da ativação.
O menu da Fullmetrix não aparece
- Abra Plugins > Installed Plugins e confirme que a Fullmetrix está ativa.
- Confirme que a conta atual pode gerenciar o WooCommerce.
- Limpe qualquer cache de objetos persistente e recarregue o painel administrativo do WordPress.
- Se o próprio WooCommerce estiver inativo, ative-o primeiro.
Erros de conexão
| Mensagem | O que fazer |
|---|---|
| Please enter a connection code. | Cole o código completo do onboarding ativo da Fullmetrix. |
| Invalid code format. | Copie o código novamente. Ele deve seguir FMTX-XXXX-XXXX-XXXX, sem espaços. |
| Connection code not found. | Confirme que está na organização Fullmetrix correta e use o código atual do onboarding dela. |
| Connection error: … | Verifique DNS, TLS, HTTPS de saída e regras de proxy e firewall para fullmetrix.com. |
| Registration failed: … | Registre a mensagem retornada. Não tente reconectar repetidamente até corrigir a causa. |
Conectado, mas a sincronização não avança
- Abra WooCommerce > Fullmetrix e confirme que ainda mostra Connected.
- Em WooCommerce > Status > Scheduled Actions, pesquise
fullmetrixe verifique as ações com falha. - Confirme que o cron do WordPress não está desativado, exceto se um cron real do sistema chamar
wp-cron.php. - Confirme que
/wp-json/e/wp-json/fullmetrix/v1/não são bloqueados por plugins de segurança, autenticação HTTP, Cloudflare ou um web application firewall. - Consulte WooCommerce > Status > Logs, o log de depuração do WordPress, o log de erros do PHP e os logs do servidor perto do horário da falha.
- Confirme que solicitações loopback e HTTPS de saída funcionam a partir do WordPress.
Não desconecte primeiro
A desconexão apaga credenciais locais e o estado da sincronização. Preserve o erro, os detalhes da ação com falha e o horário antes de alterar a conexão.
Informações para enviar ao suporte
Envie os itens abaixo sem senhas, dados de clientes, segredo da conexão ou código de conexão:
- Versões do WordPress, WooCommerce, PHP e plugin da Fullmetrix
- URL pública da loja
- Se HPOS e WooCommerce Subscriptions estão ativos
- Erro exato e horário aproximado, incluindo fuso horário
- Detalhes editados de ações agendadas com falha e dos logs
- Informações de firewall, proxy, modo de manutenção, plugin de segurança ou proteção contra bots
Se precisar remover a integração, siga Desconectar, desativar ou excluir.