Cuando una regla de validación de Shopify no muestra ningún mensaje, normalmente ocurre una de estas cuatro cosas: la validación está desactivada, la Function falló y el checkout siguió sin ella, la regla solo se ejecuta en el checkout, o el tema recibió el error y no lo mostró. Prueba la página de producto, el carrito y el checkout uno por uno para ver cuál es.
Esta guía trata de la validación del checkout creada con Shopify Functions, que es como las apps de límites de pedidos, pedido mínimo y horario de tienda (OrderRules incluida) bloquean pedidos. Si es nuevo para ti, empieza por cómo funciona la validación del checkout de Shopify.
Dónde muestra Shopify los errores de validación
Dónde aparece el mensaje depende de dónde esté el cliente.
| Dónde está el cliente | Qué ocurre | Quién muestra el mensaje |
|---|---|---|
| Checkout | El error bloquea el paso. Un error sobre todo el carrito aparece en la página actual del checkout; un error sobre un campo aparece junto a ese campo. | Shopify |
| Página de producto o carrito (al añadir o cambiar artículos) | La solicitud del carrito falla y devuelve el error. | Tu tema, si lee el error |
| Tienda headless | Los errores aparecen en el carrito de la Storefront API. | Tu front end |
| Checkout exprés (Shop Pay, Apple Pay, Google Pay, PayPal, Comprar ahora) | La validación se ejecuta igual que en el checkout. | Shopify |
La fila del medio es donde se pierden los mensajes. Shopify devuelve el error; que el comprador lo vea depende del JavaScript del tema.
Las 9 causas, por síntoma
| Síntoma | Causa probable | Solución |
|---|---|---|
| Ninguna regla se activa, en ningún sitio | 1. Validación no activa | Actívala en Checkout rules |
| Funciona con carritos pequeños, no con grandes | 2. La Function falló o se quedó sin instrucciones | Informa al desarrollador de la app con la hora y el tamaño del carrito |
| Nada en la página del carrito, se bloquea en el checkout | 3. La regla solo se ejecuta en el checkout | Es lo esperado; avisa a los clientes de antemano |
| "Sold out" o un error genérico en lugar de tu mensaje | 4. El tema oculta o reemplaza el error del carrito | Prueba en Dawn; corrige el manejo de errores del tema |
| Funciona desde el carrito, no desde Comprar ahora | 5. El checkout exprés omitió los atributos del carrito | Guarda la elección por línea de artículo, o exígela en el checkout |
| El primer pedido tras el límite se completó | 6. Los recuentos aún no se habían actualizado | Deja margen; los recuentos se actualizan tras cada pedido |
| Aparece un mensaje distinto | 7. Otra regla u otra app falló primero | Comprueba que las reglas de pedidos estén activas |
El mensaje muestra ' u otro código | 8. Mensaje escapado dos veces | Informa al desarrollador de la app |
| El pedido llegó sin ninguna comprobación | 9. El pedido vino de un canal que omite la validación | Los pedidos de POS, renovaciones, ediciones y API no se validan |
1. La validación no está activa
Instalar una app con una Function de validación no siempre la activa. Ve a Configuración → Checkout → Reglas de checkout y comprueba que la regla de la app aparece en la lista y está activada. Si está apagada, ninguna regla de esa app se ejecuta en ninguna superficie. En OrderRules, la lista de comprobación de reglas que no se aplican empieza por esto.
2. La Function falló, agotó el tiempo o se quedó sin instrucciones
Un error de validación siempre bloquea el checkout. Una ejecución fallida no. Si la Function lanza un error o supera los límites de Shopify, el checkout continúa por defecto sin esa validación, y el cliente no ve nada. La app puede cambiarlo con un ajuste blockOnFailure al crear la validación.
El límite que más afecta en la práctica son 11 millones de instrucciones por ejecución en carritos de hasta 200 líneas. El coste crece con cada línea del carrito, así que una regla que funciona con 3 artículos puede fallar con 40. Si tu límite se cumple en carritos pequeños y falla en grandes, esta es la causa probable. Los comerciantes no pueden ver los registros de ejecución de las Functions; el desarrollador de la app sí, en su Partner Dashboard. Envíale la hora del pedido y el número de líneas del carrito. La lista completa de límites está en límites de recursos de las Functions.
3. La regla solo se ejecuta en el checkout
Shopify le indica a la Function dónde está el comprador: cambiando el carrito o en el checkout. Muchas apps comprueban algunas reglas solo en el checkout, para que añadir al carrito nunca falle por, digamos, una fecha de entrega que el cliente aún no ha elegido. Esas reglas no muestran nada en la página del carrito y bloquean en el checkout.
En OrderRules, tienda cerrada, límites de pedidos, límites por producto y variante, cantidades mínimas y de paso, y límites por etiqueta y colección se comprueban al añadir artículos. Los límites por cliente y las comprobaciones de entrega y recogida se ejecutan solo en el checkout, porque puede que el cliente aún no haya iniciado sesión ni elegido una fecha. Si quieres que los clientes lo sepan antes del checkout, muestra la regla en la página con un mensaje en la tienda.
4. El tema oculta o reemplaza el error
Cuando una regla rechaza un añadir al carrito o un cambio de cantidad, el tema recibe una solicitud fallida con el mensaje dentro. Lo que pasa después es código del tema:
- Dawn (16.x) muestra el mensaje bajo el botón de añadir al carrito. También puede cambiar el botón a "Sold out", de modo que el producto parece no disponible cuando sí lo está.
- Los botones de añadido rápido en las páginas de colección suelen mostrar solo "Sold out" o un error genérico breve.
- Los carritos desplegables personalizados pueden ignorar el error por completo y simplemente no añadir el artículo.
Para confirmar que es el tema: abre las herramientas de desarrollo del navegador, ve a la pestaña Network y vuelve a añadir el producto. Una solicitud fallida a /cart/add.js o /cart/change.js cuya respuesta contiene tu mensaje significa que la regla funcionó y el tema no lo mostró. Prueba la misma acción en una vista previa de Dawn sin modificar. Si Dawn muestra el mensaje, pide a quien desarrolla tu tema que muestre el error de la solicitud de carrito fallida.
5. El checkout exprés omitió un atributo del carrito
La referencia de validación de Shopify indica que el checkout acelerado desde la página de producto omite los atributos del carrito. Si una regla depende de algo que el cliente eligió en la página del carrito y guardó como atributo del carrito, como una fecha de entrega o una nota de regalo, un botón Comprar ahora o Shop Pay en la página de producto nunca lo envía. Según cómo esté construida la app, la regla o no puede ver la elección o bloquea el pedido con un mensaje de "elige una fecha".
La solución está en la app: guardar la elección en cada línea de artículo, que los botones de la página de producto sí transportan, o exigirla en el checkout. OrderRules guarda en la línea de artículo la fecha de entrega elegida en la página de producto, así que los pedidos con Comprar ahora la conservan. Prueba este botón en tu tienda antes de un día de mucho movimiento.
6. Los recuentos no estaban al día
Una Function no puede llamar al servidor de la app durante el checkout. Lee los recuentos que la app guardó antes, y la app los actualiza tras cada pedido. Por eso el primer checkout después de alcanzar un límite puede pasar, y dos checkouts simultáneos por la última unidad pueden pasar ambos. No falta ningún mensaje; la regla vio el recuento antiguo. Deja un poco de margen en un tope que no puedes superar, y consulta límites por checkout vs por cliente para ver cómo se cuentan los límites por cliente.
7. Otra regla u otra app respondió primero
Shopify ejecuta todas las Functions de validación activas, hasta 25 por tienda, y basta con que una devuelva un error para bloquear el checkout. Dentro de una misma app, las reglas suelen comprobarse en un orden fijo. En OrderRules, una tienda cerrada muestra solo el mensaje de cierre aunque el carrito también esté por debajo del mínimo. El cliente corrige una cosa y luego ve la siguiente. Consulta qué mensaje ve el cliente para el orden completo.
Si el mensaje no es de tu app, bloquea la validación de otra app. Revisa la lista en Configuración → Checkout → Reglas de checkout.
8. El mensaje muestra código
Un apóstrofo que aparece como ', o un ampersand como &, indica que el mensaje se escapó como HTML dos veces entre la app y la página. Es un fallo de visualización de la app o del tema, no de tus ajustes. Informa al desarrollador de la app de la página y el mensaje exactos.
9. El pedido nunca pasó por la validación del checkout
Algunos pedidos no ejecutan la validación del carrito y del checkout en absoluto, así que no hay mensaje que mostrar:
- Ventas de Shopify POS
- Pedidos de renovación de suscripción (el primer checkout de la suscripción sí se valida)
- Ediciones de pedidos tras la compra
- Pedidos creados por otras apps o integraciones mediante la Create Order API
- Compras de preventa y de prueba antes de comprar
Los pedidos borrador pagados mediante el checkout de la factura sí se validan. En OrderRules, los pedidos de los canales anteriores no se bloquean, pero sí cuentan para tus límites. La tabla completa está en compatibilidad y limitaciones.
Prueba cada superficie en 10 minutos
Usa una tienda de desarrollo o un producto de prueba, y define una regla que puedas romper a propósito, como un máximo de 2.
- Página de producto: añade 3. Fíjate en qué hacen el botón y el mensaje.
- Añadido rápido en la colección: añade el producto desde una página de colección.
- Página del carrito y carrito desplegable: cambia la cantidad a 3.
- Checkout: ve al checkout con 3 en el carrito. Deberías ver el mensaje y no poder pagar.
- Comprar ahora y Shop Pay: compra 3 desde la página de producto con cada botón.
- Con y sin sesión iniciada: repite el checkout de ambas formas si usas límites por cliente.
- Un carrito grande: añade 40 líneas o más si tu tienda vende muchos artículos pequeños.
Mantén abierta la pestaña Network mientras pruebas. Cualquier paso que bloquee sin mensaje en pantalla es un problema del tema (causa 4). Cualquier paso que pase cuando no debería corresponde a las causas 1, 2, 5 o 9.
Lecturas relacionadas
- Cómo funciona la validación del checkout de Shopify
- Reglas que no se aplican: la lista de comprobación de OrderRules
- Dónde se comprueban las reglas de OrderRules: compatibilidad y limitaciones
- Mensajes en la tienda
Fuentes
- Shopify.dev: Cart and Checkout Validation Function API (objetivos, pasos del recorrido del comprador, ejecuciones fallidas y
blockOnFailure, superficies compatibles, checkout acelerado y atributos del carrito) - Shopify.dev: Function APIs: resource limits
- Shopify Dawn en GitHub:
assets/product-form.js(gestión de errores al añadir al carrito, versión 16.2.0)