fullmetrixDocs

Resolução de problemas

Resolva problemas do módulo Magento, desde um menu em falta até erros de ligação e dados que deixam de circular.

Comece sempre por verificações que não alteram nada. Não clique em Disconnect nem em Desligar, no Magento ou no Fullmetrix, para "recomeçar do zero". No Magento, desligar apaga a ligação com o Fullmetrix e o código não pode ser reutilizado. No Fullmetrix, elimina os dados importados.

Várias verificações desta página fazem-se na linha de comandos. Passe-as ao seu programador.

Os dois comandos de diagnóstico

A partir da pasta do projeto Magento, o seu programador executa estes dois comandos.

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

O primeiro confirma que o módulo está ativado. O segundo mostra o estado da ligação, linha a linha.

LinhaO que mostra
VersionA versão instalada do módulo
Registeredyes se a loja está ligada ao Fullmetrix, no caso contrário
Connection codeO código em uso. Oculte esta linha antes de partilhar o resultado.
Webhooksenabled se as alterações estão a ser enviadas
QueueO número de alterações à espera de serem enviadas e a idade da mais antiga
orders, customers, products...O número de itens que a loja pode enviar, por tipo

Uma Queue que fica em 0 ou perto disso é normal. Uma fila que cresce hora após hora significa que o cron não está a funcionar ou que o envio para o Fullmetrix está bloqueado.

O menu Fullmetrix não aparece no Magento

  1. Termine a sessão na administração do Magento e inicie-a de novo. O menu fica muitas vezes em cache na sessão.
  2. O seu programador verifica se o módulo está ativado com bin/magento module:status Fullmetrix_Connector. Se não estiver, executa bin/magento module:enable Fullmetrix_Connector.
  3. Executa bin/magento setup:upgrade, depois bin/magento setup:di:compile se a loja estiver em modo de produção, e depois bin/magento cache:flush.
  4. Se usa uma função de administração personalizada, verifique se o recurso Fullmetrix está assinalado, como explicado em Compatibilidade.

Mensagens de erro de ligação

Quando a ligação falha, o Magento mostra Échec de la connexion (falha da ligação) seguido de um motivo. Na linha de comandos, o motivo segue-se à mensagem Connexion echouee. Alguns motivos voltam em francês mesmo numa administração em inglês. São citados abaixo tal como aparecem.

Motivo mostradoO que significaO que fazer
invalid_code_formatO código não tem o formato FMTX-XXXX-XXXX-XXXXCopie-o de novo a partir do Fullmetrix. Nunca contém as letras O e I nem os algarismos 0 e 1.
invalid_storeA vista de loja escolhida não existe ou não está ativaEscolha uma vista ativa. Na linha de comandos, verifique o número passado a --store-id.
Code de connexion introuvableEste código não existe no FullmetrixCopie de novo o código mostrado na sua organização, sem carateres a mais
Plateforme incorrecte pour ce codeO código foi criado para outra plataformaNo Fullmetrix, volte à escolha da plataforma, escolha Magento, copie o código mostrado e tente de novo
Ce code est déjà associé à un autre siteUma loja já aceitou este códigoVeja a secção seguinte
Trop de tentatives, réessayez dans quelques minutes.Demasiadas tentativas num curto espaço de tempoAguarde dez minutos antes de tentar de novo
Cette boutique est déjà connectée à une autre Organization.A loja já pertence a outra organização do FullmetrixUse essa organização, ou remova primeiro a loja dela
Cette boutique a déjà bénéficié d'un essai Fullmetrix...O período de teste gratuito já foi usado para esta lojaÉ necessária uma subscrição, veja Faturação
invalid_response, HTTP seguido de um número, ou uma mensagem de redeO servidor não conseguiu contactar corretamente o FullmetrixO seu programador verifica se o servidor consegue abrir ligações HTTPS de saída para fullmetrix.com (firewall, proxy, DNS, certificados)

O código está "already associated with another site"

Um código só funciona uma vez. Esta mensagem, Ce code est déjà associé à un autre site, aparece quando tenta de novo com um código que já foi aceite, por exemplo depois de clicar em Disconnect no Magento, ou se outra instalação (um site de teste, por exemplo) o usou primeiro.

Se o cartão da loja no Fullmetrix ainda funciona, não há nada a fazer, a ligação está feita. Se desligou a loja no Magento e quer voltar a ligá-la, precisa de um novo código. Abra Definições e depois Integrações, clique em Desligar no cartão do Magento, confirme e adicione depois a loja de novo para obter um código novo. Isto apaga os dados importados no Fullmetrix, que são depois importados de novo a partir da sua loja.

A loja está ligada mas os dados deixam de circular

  1. No Magento, abra Marketing e depois Fullmetrix e verifique se o selo Connected continua a aparecer.

  2. O seu programador executa bin/magento fullmetrix:status e vê a linha Queue. Se cresce, o cron não está a funcionar ou o envio está bloqueado.

  3. Verifica se o cron do Magento está instalado e a funcionar e executa uma vez o grupo Fullmetrix para testar.

    bin/magento cron:run --group=fullmetrix
  4. Consulta var/log/system.log e var/log/exception.log por volta da hora do problema.

  5. No Fullmetrix, abra Definições e depois Integrações e leia o cartão do Magento. Uma mensagem vermelha indica a causa do último erro.

O cartão do Fullmetrix diz que a loja está inacessível

A mensagem A última sincronização não conseguiu aceder à sua loja. Certifique-se de que está online e acessível publicamente. Nenhum dado foi atualizado. significa que o Fullmetrix não conseguiu chamar o seu site. Verifique se a loja está online, sem modo de manutenção, e se nenhuma proteção bloqueia os endereços /fullmetrix/api/. Se usa o Cloudflare, siga Cloudflare e firewalls.

Depois de um erro, o botão Sincronizar dá lugar a Retomar e Repor. Depois de corrigida a causa, clique em Retomar para continuar de onde a importação parou. Se Retomar não for proposto, clique em Repor, que volta a pôr o progresso a zero e reinicia a sincronização sem eliminar as encomendas já importadas. Isto aplica-se também quando o cartão mostra Auto-sincronização desativada após vários erros consecutivos, embora essa mensagem mencione o botão Sincronizar. Os outros estados do cartão estão descritos em Estado da sincronização.

Aparecem erros depois de uma atualização do módulo

Numa loja em modo de produção, cada atualização do módulo tem de ser seguida de bin/magento setup:upgrade, bin/magento setup:di:compile e bin/magento cache:flush. Se um destes comandos foi esquecido, podem aparecer erros na administração ou no checkout. O seu programador volta a executar os três comandos, por esta ordem.

O rastreio de visitantes não recebe nada

  • Verifique se a loja está ligada, com o selo Connected no Magento.
  • Limpe a cache de páginas do Magento ou a sua cache externa, para que as páginas servidas incluam o rastreio.
  • Faça o seu teste depois de aceitar os cookies, se existir um banner de consentimento.
  • Verifique a receção em Script de rastreio.

Contactar o suporte

Se o problema persistir, contacte-nos com o seguinte.

  • A versão do Magento ou do Adobe Commerce e a versão do PHP.
  • O resultado de bin/magento fullmetrix:status, sem a linha Connection code.
  • A vista de loja ligada e o endereço público da loja.
  • A mensagem exata e a hora a que apareceu.
  • Se existe uma firewall, o Cloudflare, o modo de manutenção ou uma palavra-passe no site.
  • Linhas relevantes dos registos do Magento, sem dados de clientes.

Nunca envie uma palavra-passe nem o código de ligação.

Nesta página