Saltar al contenido principal
Técnico

¿No aparece el error de validación del carrito o checkout de Shopify? 9 causas y soluciones

Jahangir Alam21 de noviembre de 2026Datos verificados el 21 de noviembre de 202610 min read

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 clienteQué ocurreQuién muestra el mensaje
CheckoutEl 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 headlessLos 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íntomaCausa probableSolución
Ninguna regla se activa, en ningún sitio1. Validación no activaActívala en Checkout rules
Funciona con carritos pequeños, no con grandes2. La Function falló o se quedó sin instruccionesInforma 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 checkout3. La regla solo se ejecuta en el checkoutEs lo esperado; avisa a los clientes de antemano
"Sold out" o un error genérico en lugar de tu mensaje4. El tema oculta o reemplaza el error del carritoPrueba en Dawn; corrige el manejo de errores del tema
Funciona desde el carrito, no desde Comprar ahora5. El checkout exprés omitió los atributos del carritoGuarda 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 actualizadoDeja margen; los recuentos se actualizan tras cada pedido
Aparece un mensaje distinto7. Otra regla u otra app falló primeroComprueba que las reglas de pedidos estén activas
El mensaje muestra ' u otro código8. Mensaje escapado dos vecesInforma al desarrollador de la app
El pedido llegó sin ninguna comprobación9. El pedido vino de un canal que omite la validaciónLos 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.

  1. Página de producto: añade 3. Fíjate en qué hacen el botón y el mensaje.
  2. Añadido rápido en la colección: añade el producto desde una página de colección.
  3. Página del carrito y carrito desplegable: cambia la cantidad a 3.
  4. Checkout: ve al checkout con 3 en el carrito. Deberías ver el mensaje y no poder pagar.
  5. Comprar ahora y Shop Pay: compra 3 desde la página de producto con cada botón.
  6. Con y sin sesión iniciada: repite el checkout de ambas formas si usas límites por cliente.
  7. 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

Fuentes

Preguntas frecuentes

Las causas más comunes son: la validación no está activada en Configuración → Checkout → Reglas de checkout; la Function falló o se quedó sin instrucciones, así que el checkout continuó sin ella; la regla solo se ejecuta en el checkout, por lo que no se ve nada en la página del carrito; o el tema captura el error del carrito y muestra un mensaje genérico o "Sold out". Prueba por separado la página de producto, el carrito y el checkout para ver cuál es.

En el checkout, un error dirigido a todo el carrito aparece en el paso actual, y un error dirigido a un campo aparece junto a ese campo. En la tienda online, un error devuelto al añadir o cambiar artículos llega al tema como una solicitud de carrito fallida. El tema decide si lo muestra y dónde. Las tiendas headless leen los errores del carrito de la Storefront API.

Si una regla de validación rechaza una solicitud de añadir al carrito, algunos temas tratan cualquier fallo como agotado. Dawn, por ejemplo, muestra el mensaje de error bajo el botón y también puede cambiar el botón a "Sold out". El producto no está agotado; la regla bloqueó esa cantidad o ese carrito. Comprueba qué regla se aplica al producto.

No por defecto. Si una ejecución de la Function falla, por ejemplo por tiempo de espera o por quedarse sin instrucciones en un carrito grande, Shopify deja continuar el checkout sin esa validación, salvo que la app la haya creado con blockOnFailure activado. El cliente no ve ningún mensaje y el pedido se completa.

La validación se ejecuta en Shop Pay, Apple Pay, Google Pay, PayPal exprés y Comprar ahora. Una salvedad: el checkout exprés desde la página de producto omite los atributos del carrito, así que una regla que dependa de algo que el cliente eligió en la página del carrito, como una fecha de entrega guardada como atributo, no puede verlo ahí.

Las ventas del POS, los pedidos de renovación de suscripción, las ediciones de pedidos, los pedidos creados mediante la API y las compras de preventa o de prueba antes de comprar no ejecutan la validación del carrito y del checkout, así que no pueden mostrar su mensaje. Los pedidos borrador pagados mediante el checkout de la factura sí la ejecutan.

¿Comparando apps?

Mira cómo se compara OrderRules con todas las demás apps de Shopify en esta categoría.

¿Listo para tomar el control de tus pedidos?

Prueba OrderRules gratis