fullmetrixDocs

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

  1. Abre directamente la dirección /admin/fullmetrix de 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.
  2. Si la dirección devuelve un error 404, las rutas no están importadas. Tu desarrollador revisa el archivo config/routes/fullmetrix.yaml y ejecuta bin/console debug:router fullmetrix_admin_connection, que debe mostrar la ruta.
  3. 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:status y 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 mostradoQué significaQué hacer
invalid_code_formatEl código no tiene la forma FMTX-XXXX-XXXX-XXXXVuelve a copiarlo desde Fullmetrix. Nunca contiene las letras O e I ni los dígitos 0 y 1.
storage_failedEl plugin no pudo guardar sus ajustesProbablemente no se ejecutó la migración. Tu desarrollador ejecuta bin/console doctrine:migrations:migrate.
Code de connexion introuvableEste código no existe en FullmetrixVuelve a copiar el código que se muestra en tu organización, sin caracteres de más
Plateforme incorrecte pour ce codeEl código se creó para otra plataformaEn 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 siteUna tienda ya ha aceptado este códigoConsulta la sección siguiente
Trop de tentatives, réessayez dans quelques minutes.Demasiados intentos en poco tiempoEspera 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 FullmetrixUsa 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 tiendaSe requiere una suscripción, consulta Facturación
invalid_response, register_failed o un mensaje de redEl servidor no pudo comunicarse correctamente con FullmetrixTu 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

  1. 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.
  2. Lee el recuadro Recent activity. Una línea sync_error contiene la causa del error. Anótala antes de hacer clic en Clear logs.
  3. 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.
  4. Tu desarrollador comprueba que las direcciones /fullmetrix/api/ atraviesan el proxy, la caché y el firewall. Si usas Cloudflare, sigue Cloudflare y firewalls.
  5. 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.

En esta página