Resolución de problemas
Soluciona los problemas del plugin de Sylius, desde una instalación fallida hasta una importación que no termina.
Empieza siempre por comprobaciones que no cambian nada. No hagas clic en Disconnect en Sylius, ni en Desconectar en Fullmetrix, para "empezar de cero". En Sylius, desconectar corta el vínculo y el código no se puede reutilizar. En Fullmetrix, elimina los datos importados.
Varias comprobaciones de esta página afectan al código del proyecto. Pásaselas a tu desarrollador, con la hora y el mensaje exacto del problema.
Composer se niega a instalar el plugin
Tu desarrollador ejecuta este comando para saber qué lo bloquea.
composer why-not fullmetrix/sylius-plugin '*'Las causas habituales son una versión de PHP inferior a 8.1, una extensión cURL o JSON que falta, o una versión de Sylius, Symfony o Doctrine fuera de la lista de Compatibilidad. Resuelve las dependencias en su máquina y despliega después el archivo composer.lock resultante. Copiar la carpeta vendor/ de una máquina a otra es mala idea si las versiones de PHP difieren.
Symfony no carga el plugin
Si bin/console cache:clear falla o no existe ninguna ruta de Fullmetrix, comprueba que config/bundles.php contiene esta línea.
Fullmetrix\SyliusPlugin\FullmetrixPlugin::class => ['all' => true],Tu desarrollador ejecuta entonces composer dump-autoload y vacía la caché con el mismo entorno que el sitio en producción. Si hay varios servidores, los revisa uno por uno.
La página de Fullmetrix no aparece en la administración
- Abre directamente la dirección
/admin/fullmetrixde tu tienda con una cuenta de administrador. Si la página aparece, solo falta el menú, a menudo por un menú de administración o un tema personalizados. - Si la dirección devuelve un error 404, las rutas no están importadas. Tu desarrollador revisa el archivo
config/routes/fullmetrix.yamly ejecutabin/console debug:router fullmetrix_admin_connection, que debe mostrar la ruta. - Vacía la caché y después recarga la página.
La migración falla
- Haz una copia de seguridad de la base de datos antes de volver a intentarlo.
- Tu desarrollador revisa
bin/console doctrine:migrations:statusy el primer error que aparece. - Comprueba que el usuario de la base de datos tiene permiso para crear tablas.
- No crea las tablas a mano ni marca la migración como ejecutada sin entender el error.
Mensajes de error de conexión
Cuando falla la conexión, la página muestra Connection failed seguido de un motivo. Algunos motivos llegan en francés. Se citan a continuación tal como aparecen.
| Motivo mostrado | Qué significa | Qué hacer |
|---|---|---|
invalid_code_format | El código no tiene la forma FMTX-XXXX-XXXX-XXXX | Vuelve a copiarlo desde Fullmetrix. Nunca contiene las letras O e I ni los dígitos 0 y 1. |
storage_failed | El plugin no pudo guardar sus ajustes | Probablemente no se ejecutó la migración. Tu desarrollador ejecuta bin/console doctrine:migrations:migrate. |
| Code de connexion introuvable | Este código no existe en Fullmetrix | Vuelve a copiar el código que se muestra en tu organización, sin caracteres de más |
| Plateforme incorrecte pour ce code | El código se creó para otra plataforma | En Fullmetrix, vuelve a la elección de plataforma, elige Sylius, copia el código que aparece y vuelve a intentarlo |
| 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 retira 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 | Se requiere una suscripción, consulta Facturación |
invalid_response, register_failed o un mensaje de red | El servidor no pudo comunicarse correctamente con Fullmetrix | Tu desarrollador comprueba que PHP puede abrir conexiones HTTPS salientes a fullmetrix.com (firewall, proxy, DNS, certificados) |
No compartas un código activo
El código es un secreto. Si envías una captura de pantalla de la página de Fullmetrix en Sylius, oculta por completo el campo Connection code.
El código está "ya asociado a otro sitio"
Un código funciona una sola 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 Sylius, 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. Si desconectaste la tienda en Sylius y quieres reconectarla, necesitas un código nuevo. Abre Ajustes y luego Integraciones, haz clic en Desconectar en la tarjeta de Sylius, confirma y vuelve a añadir la tienda para obtener un código nuevo. Esto borra los datos importados en Fullmetrix, que se importan de nuevo desde tu tienda.
Conectada, pero la importación no termina
- En Sylius, abre Marketing y luego Fullmetrix, y mira el recuadro Sync activity. Anota si muestra Waiting for sync, Sync in progress o Sync complete.
- Lee el recuadro Recent activity. Una línea
sync_errorcontiene la causa del error. Anótala antes de hacer clic en Clear logs. - En Fullmetrix, lee la tarjeta de Sylius en Ajustes y luego Integraciones. El mensaje La última sincronización no pudo conectarse con tu tienda significa que Fullmetrix no pudo llamar a tu sitio.
- Tu desarrollador comprueba que las direcciones
/fullmetrix/api/atraviesan el proxy, la caché y el firewall. Si usas Cloudflare, sigue Cloudflare y firewalls. - Revisa los registros de PHP y del servidor web en el momento del problema, y comprueba que cada servidor ejecuta la misma versión del plugin.
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. Los demás estados de la tarjeta se describen en Estado de sincronización.
La dirección de la tienda es incorrecta en Fullmetrix
La tarjeta muestra la dirección que envió el plugin cuando te conectaste. Si es una dirección interna, una dirección HTTP u otro dominio, la administración se abrió con esa dirección, o Symfony no confía en el proxy que hay delante del sitio. Tu desarrollador corrige la configuración del proxy. Para registrar la dirección correcta, hay que reconectar la tienda con un código nuevo, como se explica más arriba.
El seguimiento de visitantes no recibe nada
- Comprueba que la página de Fullmetrix en Sylius sigue mostrando Connected.
- Haz la prueba en una página pública de la tienda, no en la administración.
- Vacía cualquier caché de páginas que haya delante del sitio.
- Haz tu prueba después de aceptar las cookies si hay un banner de consentimiento.
- Comprueba la recepción en Script de seguimiento.
Contacta con el soporte
Si el problema persiste, contáctanos con lo siguiente.
- La dirección pública de la tienda y el nombre de tu organización de Fullmetrix.
- Las versiones de Sylius, del plugin, de PHP, de Symfony y de Doctrine.
- El mensaje exacto, la hora a la que apareció y la zona horaria.
- El resultado de
bin/console debug:router fullmetrix_admin_connection. - Una captura de pantalla de los recuadros Sync activity y Recent activity, con el código oculto.
Nunca envíes una contraseña, un código de conexión ni un extracto de tu base de datos de producción.