Resolución de problemas
Soluciona los problemas del módulo de Magento, desde un menú que no aparece hasta errores de conexión y datos que dejan de moverse.
Empieza siempre por comprobaciones que no cambian nada. No hagas clic en Disconnect ni en Magento ni en Fullmetrix para "empezar de nuevo". En Magento, desconectar borra el vínculo con Fullmetrix y el código no se puede reutilizar. En Fullmetrix, borra los datos importados.
Varias comprobaciones de esta página se hacen por línea de comandos. Pásaselas a tu desarrollador.
Los dos comandos de diagnóstico
Desde la carpeta del proyecto Magento, tu desarrollador ejecuta estos dos comandos.
bin/magento module:status Fullmetrix_Connector
bin/magento fullmetrix:statusEl primero confirma que el módulo está activado. El segundo muestra el estado de la conexión, línea por línea.
| Línea | Qué muestra |
|---|---|
Version | La versión instalada del módulo |
Registered | yes si la tienda está conectada a Fullmetrix, no en caso contrario |
Connection code | El código en uso. Oculta esta línea antes de compartir el resultado. |
Webhooks | enabled si se están enviando los cambios |
Queue | El número de cambios pendientes de envío y la antigüedad del más antiguo |
orders, customers, products... | El número de elementos que la tienda puede enviar, por tipo |
Es normal que Queue se mantenga en 0 o cerca. Una cola que crece hora tras hora significa que el cron no está funcionando o que el envío a Fullmetrix está bloqueado.
El menú de Fullmetrix no aparece en Magento
- Cierra sesión en el panel de administración de Magento y vuelve a iniciarla. A menudo el menú queda en la caché de la sesión.
- Tu desarrollador comprueba que el módulo está activado con
bin/magento module:status Fullmetrix_Connector. Si no lo está, ejecutabin/magento module:enable Fullmetrix_Connector. - Ejecuta
bin/magento setup:upgrade, luegobin/magento setup:di:compilesi la tienda está en modo producción, y despuésbin/magento cache:flush. - Si usas un rol de administrador personalizado, comprueba que el recurso Fullmetrix está marcado, como se explica en Compatibilidad.
Mensajes de error de conexión
Cuando la conexión falla, Magento muestra Échec de la connexion (fallo de conexión) seguido de un motivo. En la línea de comandos, el motivo sigue al mensaje Connexion echouee. Algunos motivos aparecen en francés incluso en un panel de administración en inglés. Se citan a continuación tal como aparecen.
| Motivo mostrado | Qué significa | Qué hacer |
|---|---|---|
invalid_code_format | El código no tiene el formato FMTX-XXXX-XXXX-XXXX | Cópialo de nuevo desde Fullmetrix. Nunca contiene las letras O e I ni los dígitos 0 y 1. |
invalid_store | La vista de tienda elegida no existe o no está activa | Elige una vista activa. En la línea de comandos, comprueba el número que pasas a --store-id. |
| Code de connexion introuvable | Este código no existe en Fullmetrix | Copia de nuevo el código que aparece en tu organización, sin caracteres adicionales |
| Plateforme incorrecte pour ce code | El código se creó para otra plataforma | En Fullmetrix, vuelve a la elección de plataforma, elige Magento, copia el código que aparece e inténtalo de nuevo |
| Ce code est déjà associé à un autre site | Una tienda ya ha aceptado este código | Consulta la sección siguiente |
| Trop de tentatives, réessayez dans quelques minutes. | Demasiados intentos en poco tiempo | Espera diez minutos antes de volver a intentarlo |
| Cette boutique est déjà connectée à une autre Organization. | La tienda ya pertenece a otra organización de Fullmetrix | Usa esa organización o elimina antes la tienda de ella |
| Cette boutique a déjà bénéficié d'un essai Fullmetrix... | La prueba gratuita ya se usó para esta tienda | Hace falta una suscripción, consulta Facturación |
invalid_response, HTTP seguido de un número, o un mensaje de red | El servidor no pudo contactar correctamente con Fullmetrix | Tu desarrollador comprueba que el servidor puede abrir conexiones HTTPS salientes hacia fullmetrix.com (firewall, proxy, DNS, certificados) |
El código ya está "asociado a otro sitio"
Un código solo funciona una vez. Este mensaje, Ce code est déjà associé à un autre site, aparece cuando vuelves a intentarlo con un código que ya se aceptó, por ejemplo después de hacer clic en Disconnect en Magento, o si otra instalación (un sitio de pruebas, por ejemplo) lo usó antes.
Si la tarjeta de la tienda en Fullmetrix sigue funcionando, no hay nada que hacer, la conexión está establecida. Si desconectaste la tienda en Magento y quieres volver a conectarla, necesitas un código nuevo. Abre Ajustes y luego Integraciones, haz clic en Desconectar en la tarjeta de Magento, confirma y vuelve a agregar la tienda para obtener un código nuevo. Esto borra los datos importados en Fullmetrix, que se vuelven a importar desde tu tienda.
La tienda está conectada pero los datos dejan de moverse
-
En Magento, abre Marketing y luego Fullmetrix, y comprueba que la insignia Connected sigue apareciendo.
-
Tu desarrollador ejecuta
bin/magento fullmetrix:statusy mira la líneaQueue. Si crece, el cron no está funcionando o el envío está bloqueado. -
Comprueba que el cron de Magento está instalado y en marcha, y ejecuta una vez el grupo de Fullmetrix para probar.
bin/magento cron:run --group=fullmetrix -
Revisa
var/log/system.logyvar/log/exception.logen torno al momento del problema. -
En Fullmetrix, abre Ajustes y luego Integraciones, y lee la tarjeta de Magento. Un mensaje rojo indica la causa del último error.
La tarjeta de Fullmetrix dice que la tienda es inaccesible
El mensaje La última sincronización no pudo conectarse con tu tienda. Comprueba que esté en línea y sea accesible públicamente. No se ha actualizado ningún dato. significa que Fullmetrix no pudo llamar a tu sitio. Comprueba que la tienda está en línea, que no está en modo de mantenimiento y que ninguna protección bloquea las direcciones /fullmetrix/api/. Si usas Cloudflare, sigue Cloudflare y firewalls.
Después de un error, el botón Sincronizar deja su lugar a Reanudar y Reiniciar. Una vez corregida la causa, haz clic en Reanudar para continuar desde donde se detuvo la importación. Si Reanudar no se ofrece, haz clic en Reiniciar, que pone el progreso a cero y reinicia la sincronización sin borrar los pedidos ya importados. Esto también vale cuando la tarjeta muestra Sincronización automática desactivada tras N errores consecutivos, aunque ese mensaje mencione el botón Sincronizar. Los demás estados de la tarjeta se describen en Estado de sincronización.
Aparecen errores después de actualizar el módulo
En una tienda en modo producción, cada actualización del módulo debe ir seguida de bin/magento setup:upgrade, bin/magento setup:di:compile y bin/magento cache:flush. Si se olvidó alguno de estos comandos, pueden aparecer errores en el panel de administración o en el pago. Tu desarrollador vuelve a ejecutar los tres comandos, en este orden.
El seguimiento de visitantes no recibe nada
- Comprueba que la tienda está conectada, con la insignia Connected en Magento.
- Vacía la caché de páginas de Magento o tu caché externa, para que las páginas servidas incluyan el seguimiento.
- Haz tu prueba después de aceptar las cookies si hay un banner de consentimiento.
- Comprueba la entrega en Script de seguimiento.
Contacta con el soporte
Si el problema persiste, contáctanos con lo siguiente.
- La versión de Magento o Adobe Commerce y la versión de PHP.
- El resultado de
bin/magento fullmetrix:status, sin la líneaConnection code. - La vista de tienda conectada y la dirección pública de la tienda.
- El mensaje exacto y la hora a la que apareció.
- Si hay un firewall, Cloudflare, modo de mantenimiento o una contraseña en el sitio.
- Las líneas relevantes de los registros de Magento, sin datos de clientes.
No envíes nunca una contraseña ni el código de conexión.