Ir al contenido

Cuando algo no funciona

Busca abajo lo que ves y sigue las comprobaciones en el orden dado. Están ordenadas de la causa más frecuente a la más rara, así que para en cuanto una falle: esa es.


El caso más común, y casi siempre es una de las cinco condiciones que hacen falta a la vez.

1. ¿La Guía de configuración está al 6/6? Ábrela en el inicio de la app. Si algún paso está pendiente, ahí tienes la respuesta — sigue ese paso y vuelve.

2. ¿El formulario está Activo y Sincronizado? Ajustes del formulario. Hacen falta las dos cosas. Activo pero Sin sincronizar significa que tus cambios aún no han salido a la tienda: pulsa Sincronizar ahora y espera al verde.

3. ¿Este producto tiene formulario asignado? Pestaña Productos del formulario. Un formulario perfecto sin asignar no aparece en ninguna parte. Si lo asignaste por colección, comprueba que el producto está realmente en esa colección.

4. ¿El bloque está en la plantilla que usa este producto? Esta es la que más despista. Si tienes varias plantillas de producto, el bloque hay que añadirlo en cada una. Mira en el producto, barra lateral derecha, Plantilla de tema, cuál usa — y comprueba que el bloque está en esa.

5. ¿Estás mirando el tema publicado? Los ajustes de tema no se comparten entre temas. Si añadiste el bloque a un borrador, en el tema en vivo no está.


Añadiste el bloque dos veces. Pasa con facilidad: el enlace de la Guía ya deja el bloque puesto en el editor, así que si además añades otro a mano, quedan dos.

En el editor de temas, sobre la plantilla de producto, borra el que sobre y guarda.


El botón sale, pero al pulsarlo no pasa nada

Sección titulada «El botón sale, pero al pulsarlo no pasa nada»

Casi siempre es que el embed está desactivado. El botón lo pinta un bloque, pero el formulario lo carga el embed: sin él, hay botón y no hay motor.

Ve a la Guía de configuración y comprueba el paso “Activa el embed de la app”. Si está en verde y sigue sin abrir, escríbenos con el nombre y la versión de tu tema.


Por ejemplo, eliges el color negro y llega el azul.

El formulario lee la variante en el momento de abrirlo y otra vez al añadir al carrito, así que cambiar de variante con el formulario abierto es seguro.

Si aun así falla, tu tema anuncia la variante de una forma poco común. Tiene arreglo sin tocar código: en los ajustes del bloque hay un campo para indicárselo. Escríbenos con la URL del producto y te decimos exactamente qué poner.


El pedido se ha añadido —compruébalo abriendo el carrito— pero la pantalla no se actualiza sola.

  1. Recarga la página y mira el carrito. Si el producto está, es un problema de refresco visual, no de venta.
  2. En los ajustes del embed, comprueba que “Keep the cart in sync” está activado.
  3. Si tu tema es poco habitual, en el apartado Advanced de ese mismo embed hay campos para indicarle dónde está tu carrito. Escríbenos antes de tocarlos: normalmente no hacen falta.

Los tratamientos salen sueltos en el carrito

Sección titulada «Los tratamientos salen sueltos en el carrito»

Deberían verse debajo de la montura, indentados, como parte del conjunto.

Cuando salen como líneas independientes, es que tu tema pinta el carrito de una forma que la app no reconoce. No afecta a la venta: los precios, el pedido y el checkout son correctos; solo se ve peor.

Escríbenos con el nombre del tema. Suele resolverse con unas líneas en Custom CSS.


El cliente puede cambiar la cantidad de un tratamiento

Sección titulada «El cliente puede cambiar la cantidad de un tratamiento»

Es a propósito, no es una avería. La app coloca las líneas de tratamiento debajo de la montura, pero no les esconde ni la cantidad ni la papelera.

El motivo: esconder un botón no impide la acción —quien quiera puede cambiar esa línea igual desde la API del carrito— y esa misma fila la usan otras apps para garantías y seguros de envío; taparles la papelera dejaría a tu cliente con un cargo ajeno que no puede quitar.

Lo que sí está garantizado siempre: borrar la montura borra todo su conjunto, lo pinte como lo pinte el tema.

Si lo que quieres es que esas líneas pesen menos visualmente, enciende Compactar las líneas de complementos en la incrustación de la app. Ver Diseño y carrito.


Los precios del formulario no cuadran con los de la ficha

Sección titulada «Los precios del formulario no cuadran con los de la ficha»
  1. ¿Estás mirando la misma variante? Los precios cambian por variante.
  2. ¿Tienes varios países o monedas activos? Comprueba desde el mismo país que el cliente.
  3. Si tienes descuentos automáticos, recuerda que muchos se aplican en el checkout, no en el carrito.

El formulario entero en otro idioma: revisa Idiomas y textos. Lo más habitual es haber escrito un texto en las cajas del paso, que se aplica a todos los idiomas.

Solo el botón: si escribiste algo en Button text, ese texto se usa tal cual en todos los idiomas. Déjalo vacío y se traduce solo.

Un formulario traído de otra tienda: al importarlo se ajusta al idioma de tu tienda automáticamente. Si algún campo no tenía traducción, se queda en el idioma de origen — edítalo con el selector de idioma.


“N productos referenciados ya no existen en tu catálogo”.

Significa que algún tratamiento o accesorio vinculado a una opción se ha borrado de Shopify.

  • Si de verdad los borraste, pulsa Quitar referencias eliminadas.
  • Si te suenan y crees que siguen existiendo, no pulses nada y escríbenos. Ese botón borra los addons de las opciones, y si el aviso fuera equivocado perderías configuración.

Guardar no publica. Pulsa Sincronizar ahora en el formulario y espera a que ponga Sincronizado.

Si dice Error de sincronización, vuelve a intentarlo. Si insiste, escríbenos con el nombre del formulario.


Cuanto más de esto nos mandes, antes lo resolvemos:

  • URL del producto donde falla (y la contraseña de la tienda si está protegida)
  • Nombre y versión del tema
  • Qué esperabas y qué pasó
  • Una captura o un vídeo corto
  • Si sabes hacerlo: activa Debug mode en los ajustes del embed, repite el fallo, abre la consola del navegador (F12) y cópianos lo que salga

Ese último punto es el que más acelera las cosas: nos dice exactamente por dónde pasó la app antes de fallar.

support@getoptical.app