Solución de problemas
Resuelve problemas de instalación, ruta, código, webhook y sincronización de Fullmetrix en Sylius.
Anota el error exacto, hora y zona horaria, versiones del plugin, Sylius y PHP, y el commit desplegado antes de cambiar la instalación.
Composer no puede instalar el plugin
- Ejecuta
composer why-not fullmetrix/sylius-plugin '*'. - Confirma PHP 8.1 o posterior y las extensiones cURL y JSON.
- Comprueba las versiones de Sylius, Symfony y Doctrine.
- Verifica la autenticación de Composer al repositorio del paquete.
- Resuelve las dependencias en desarrollo y despliega el archivo de bloqueo resultante.
Symfony no carga FullmetrixPlugin
Comprueba esta entrada en config/bundles.php:
Fullmetrix\SyliusPlugin\FullmetrixPlugin::class => ['all' => true],Ejecuta composer dump-autoload, comprueba vendor/fullmetrix/sylius-plugin y limpia la caché con el mismo APP_ENV que la aplicación web. Revisa cada nodo.
Fullmetrix no aparece en el menú
- Comprueba el bundle y la importación de rutas.
- Ejecuta
bin/console debug:router fullmetrix_admin_connection. - Limpia la caché.
- Abre
/admin/fullmetrixdirectamente con una cuenta administradora. - Si la ruta funciona, revisa menús o temas personalizados.
La migración falla
- Haz una copia de seguridad nueva antes de reintentar.
- Consulta
bin/console doctrine:migrations:statusy el primer error SQL. - Comprueba permisos para crear y modificar tablas.
- No crees las tablas manualmente ni marques una migración fallida como ejecutada sin revisión.
El código es rechazado
- Genéralo desde la organización y plataforma correctas.
- Copia todo el valor
FMTX-…sin espacios ni puntuación. - No reutilices un código de otro CMS u organización.
- Comprueba URL HTTPS, DNS, proxy, certificados y acceso saliente de PHP.
- Crea otro código solo después de confirmar que el anterior no fue aceptado.
Nunca envíes un código activo en una captura
El código es un secreto. Soporte puede investigar con el ID de organización, URL, hora, versión del plugin y una captura con el código completamente cubierto.
Connected, pero la importación no termina
- Mantén abierta la página Fullmetrix hasta que detecte el plugin.
- Comprueba Waiting for sync, Sync in progress o Sync complete en Marketing > Fullmetrix.
- Revisa Recent activity y conserva el mensaje
sync_errorantes de borrar el registro. - Comprueba el acceso a
/fullmetrix/api/*a través del proxy o WAF. - Revisa los registros PHP y del servidor web en la misma hora.
- Comprueba base compartida y versión idéntica en todos los nodos.
Falta el seguimiento de la tienda
- Comprueba que el plugin siga mostrando Connected.
- Carga una página pública, no una ruta administrativa o API.
- Busca el rastreador en el código fuente y la red del navegador.
- Revisa gestor de consentimiento, CSP, proxy, caché y tema.
Información para soporte
Envía, sin contraseñas, códigos, secretos, datos de clientes ni contenido de producción:
- URL pública e ID o slug de organización
- Versiones de Sylius, plugin, PHP, Symfony y Doctrine
- Error, hora, zona horaria y commit
- Resultado de
debug:router fullmetrix_admin_connection - Estado actual y actividad reciente redactada
- Código de estado pertinente del proxy o servidor
Antes de retirar nada, consulta Desconectar y desinstalar.