Solução de problemas

Resolva problemas comuns de instalação, conexão, cron e sincronização do Magento.

Comece com verificações não destrutivas. Não desconecte nem reinstale o módulo antes de registrar o erro e verificar o estado atual.

Verificações rápidas

No diretório do projeto, execute:

bin/magento module:status Fullmetrix_Connector
bin/magento fullmetrix:status

O primeiro comando deve indicar Fullmetrix_Connector como ativo. O segundo mostra versão, registro, fila de webhooks e contagens de entidades.

Oculte o código de conexão

fullmetrix:status mostra o código atual. Remova a linha Connection code antes de compartilhar a saída em ticket, chat ou captura.

Confirme o módulo com bin/magento module:status Fullmetrix_Connector.
Execute bin/magento setup:upgrade.
Em produção compilada, execute bin/magento setup:di:compile pelo processo normal.
Execute bin/magento cache:flush, saia e entre novamente.
Confira o acesso ACL do perfil administrativo.

Erro	Solução
`invalid_code_format`	Copie o código novamente. Ele deve seguir `FMTX-XXXX-XXXX-XXXX` sem espaços.
`invalid_store`	Selecione uma visão ativa. Verifique o ID ao usar a CLI.
Código não encontrado ou já usado	Volte ao onboarding ativo da organização correta e use o código atual.
`invalid_response`	Confira HTTPS de saída, DNS, TLS, proxy e logs do Magento. Tente novamente após corrigir a rede.
Erro HTTP ou de transporte	Permita HTTPS para `fullmetrix.com` e verifique firewall, proxy, DNS e certificados.

Abra Marketing > Fullmetrix e confirme Connected.
Confira bin/magento fullmetrix:status. Uma fila crescente indica bloqueio de cron ou envio.
Confirme que o cron principal do Magento está instalado e ativo.
Execute o grupo do conector uma vez para diagnóstico:
```
bin/magento cron:run --group=fullmetrix
```
Confira var/log/system.log, var/log/exception.log e logs do supervisor ou cron do sistema no horário da falha.
Confirme que a Fullmetrix acessa a URL pública sem manutenção, autenticação HTTP ou desafio antibot.

Não reconecte primeiro

Desconectar apaga a conexão local e o estado da sincronização. Preserve erro, fila e horário antes de alterar a conexão.

Envie o seguinte sem senhas, segredos, dados de clientes ou código de conexão: