Solución de problemas
Resuelve problemas comunes de instalación, conexión, cron y sincronización de Magento.
Empieza con comprobaciones no destructivas. No desconectes ni reinstales el módulo hasta haber anotado el error y verificado el estado actual.
Comprobaciones rápidas
Desde el directorio del proyecto, ejecuta:
bin/magento module:status Fullmetrix_Connector
bin/magento fullmetrix:statusEl primer comando debe indicar que Fullmetrix_Connector está activado. El segundo muestra la versión, el registro, la cola de webhooks y el número de entidades.
Oculta el código de conexión
fullmetrix:status muestra el código actual. Elimina la línea Connection code antes de pegar la salida en un ticket, chat o captura.
No aparece el menú Fullmetrix
- Confirma el módulo con
bin/magento module:status Fullmetrix_Connector. - Ejecuta
bin/magento setup:upgrade. - En producción compilada, ejecuta
bin/magento setup:di:compilemediante tu proceso habitual. - Ejecuta
bin/magento cache:flush, cierra la sesión y vuelve a iniciarla. - Comprueba que el rol tenga acceso al recurso ACL de Fullmetrix.
Errores de conexión
| Error | Qué hacer |
|---|---|
invalid_code_format | Copia el código de nuevo. Debe usar FMTX-XXXX-XXXX-XXXX sin espacios. |
invalid_store | Selecciona una vista activa. Verifica su ID si usas la CLI. |
| Código no encontrado o ya usado | Vuelve al asistente activo de la organización correcta y usa su código actual. |
invalid_response | Comprueba HTTPS saliente, DNS, TLS, proxy y registros de Magento. Reintenta solo cuando la red funcione. |
| Error HTTP o de transporte | Permite HTTPS hacia fullmetrix.com y comprueba cortafuegos, proxy, DNS y certificados. |
Hay conexión, pero los datos no se actualizan
-
Abre Marketing > Fullmetrix y confirma Connected.
-
Revisa
bin/magento fullmetrix:status. Una cola creciente indica un bloqueo del cron o del envío saliente. -
Confirma que el cron principal de Magento esté instalado y activo.
-
Ejecuta una vez el grupo del conector para diagnosticar:
bin/magento cron:run --group=fullmetrix -
Revisa
var/log/system.log,var/log/exception.logy los registros del supervisor o cron del sistema cerca de la hora del fallo. -
Confirma que Fullmetrix pueda acceder a la URL pública sin mantenimiento, autenticación HTTP ni desafío antibot.
No reconectes primero
La desconexión borra la conexión local y el estado de sincronización. Conserva el error, el estado de la cola y la hora antes de cambiar nada.
Información para soporte
Envía lo siguiente sin contraseñas, secretos, datos de clientes ni código de conexión:
- Versión de Magento o Adobe Commerce y versión de PHP
- Versión del conector Fullmetrix
- ID de la vista y URL pública
- Error exacto y hora aproximada con zona horaria
- Estado del cron y evolución de la cola Fullmetrix
- Líneas pertinentes y anonimizadas de los registros
- Detalles de cortafuegos, proxy, mantenimiento o protección antibot
Para eliminar la integración, sigue Desconectar, desactivar o desinstalar.