---
title: "Cómo funciona la validación del checkout de Shopify (y cómo la usan las apps para bloquear pedidos)"
description: "Cómo funcionan las Functions de Cart and Checkout Validation de Shopify: dónde se ejecutan y dónde no, qué datos puede ver una Function, qué puede y qué no puede hacer, qué planes pueden usarla y cómo apps como OrderRules la usan para bloquear pedidos."
contentType: "blog"
locale: "es"
localized: true
source: "https://orderrules.com/es/blog/shopify-checkout-validation-functions-block-orders"
slug: "shopify-checkout-validation-functions-block-orders"
date: "2026-05-03"
tags:
  - "shopify"
  - "checkout validation"
  - "shopify functions"
  - "server-side validation"
  - "block checkout outside business hours"
  - "order limits"
---
**La validación del checkout de Shopify es una Shopify Function, de la Cart and Checkout Validation API, que una app instala en tu tienda.** Shopify la ejecuta en sus propios servidores cada vez que cambia un carrito o un checkout. Si la Function devuelve un error, el checkout muestra el mensaje y el comprador no puede completar el pedido hasta resolver el problema. Se ejecuta en el checkout normal, en botones exprés como Shop Pay y Apple Pay, en checkouts headless y en pedidos borrador, en cualquier plan de Shopify cuando proviene de una app pública. No se ejecuta en POS, renovaciones de suscripciones, ediciones de pedidos ni pedidos creados mediante la API. Puede bloquear un pedido, pero no puede cambiar el carrito ni reservar stock.

Última verificación: **8 de octubre de 2026**, con la documentación para desarrolladores y el centro de ayuda de Shopify. Las fuentes están al final.

*Aviso: OrderRules es una app de validación del checkout. Esta guía explica primero la plataforma Shopify y después cómo la usamos.*

![Validación del checkout comparada con apps de scripts en el carrito en el checkout estándar, Shop Pay, Apple Pay, Google Pay, enlaces directos al checkout y tiendas headless](/images/blog/shopify-checkout-validation-functions-block-orders.png)

## Qué es una Function de validación

Shopify Functions permite a las apps añadir su propia lógica al backend de Shopify. Cada API de Functions cubre una tarea: descuentos, opciones de entrega, métodos de pago, etc. La validación es la que decide si un carrito puede pasar por el checkout.

Así funciona:

1. **Una app incluye la Function.** Se compila a WebAssembly y se despliega con la app. Tú instalas la app; no tocas código.
2. **La ejecuta Shopify, no tu tema.** La Function se ejecuta dentro de la infraestructura de Shopify, no en el navegador del comprador. Desactivar JavaScript o editar la página no la evita.
3. **Lee una entrada y devuelve errores.** Shopify le pasa el carrito y datos relacionados. La Function devuelve una lista de errores, cada uno con un mensaje y un destino (todo el carrito o un campo concreto).
4. **El checkout muestra el mensaje.** Lista vacía: el checkout continúa. Si hay errores: Shopify muestra los mensajes y bloquea la finalización hasta que el comprador cambie algo.

Shopify ejecuta la Function en varios puntos del recorrido del comprador: interacciones con el carrito, interacciones con el checkout y finalización del checkout. Una Function puede comprobar en qué paso está y decidir bloquear solo en el checkout, para que añadir al carrito nunca falle.

Shopify mantiene las Functions pequeñas y rápidas. Cada ejecución tiene límites estrictos de instrucciones y de tamaño de entrada, así que la lógica debe ser sencilla y los datos compactos.

Este es un ejemplo simplificado en JavaScript del target actual, `cart.validations.generate.run`. Es ilustrativo, no es el código de OrderRules:

```javascript
// Ejemplo simplificado, no es código de producción.
// La entrada proviene de una consulta de entrada GraphQL (líneas del carrito, identidad del comprador, metacampos).
export function cartValidationsGenerateRun(input) {
  const limits = input.shop.limits?.jsonValue ?? {}; // escrito por la app de antemano
  const errors = [];

  for (const line of input.cart.lines) {
    const productId = line.merchandise.product?.id;
    const remaining = limits[productId];
    if (remaining !== undefined && line.quantity > remaining) {
      errors.push({
        message: `Only ${remaining} left for today. Lower the quantity to continue.`,
        target: "$.cart",
      });
    }
  }

  return { operations: [{ validationAdd: { errors } }] };
}
```

Fíjate en lo que falta: ninguna consulta a base de datos, ninguna llamada a API, ningún «contar los pedidos de hoy». La Function solo ve lo que hay en su entrada. Eso condiciona todo lo que sigue.

## Dónde se ejecuta y dónde no

Shopify documenta qué superficies ejecutan Functions de validación. La tabla sigue la referencia de la Cart and Checkout Validation API.

| Superficie | ¿Se ejecuta la validación? | Notas |
|---|---|---|
| Carrito y checkout de la tienda online | **Sí** | Carrito y checkout figuran por separado; ambos compatibles |
| Shop Pay, Apple Pay, Google Pay, PayPal exprés, Comprar ahora | **Sí** | Figuran como Storefront Accelerated Checkout |
| Tiendas headless (Storefront API) | **Sí** | Incluye Hydrogen y frontends personalizados |
| Checkout B2B | **Sí** | Los compradores de empresas reciben la misma validación |
| Pedidos borrador (admin y checkout de factura) | **Sí** | Figuran como Draft Order (Admin and Checkout) y Shopify Admin |
| Shopify POS | **No** | Las ventas en tienda física no se validan |
| Pedidos de renovación de suscripciones | **No** | Solo se valida el primer checkout de la suscripción |
| Ediciones de pedidos | **No** | Editar un pedido después de la compra evita la validación |
| Create Order API | **No** | Pedidos creados por otras apps o integraciones |
| Preventa y probar antes de comprar | **No** | Las opciones de compra diferida no son compatibles |

Así que «no se puede eludir» no es exacto. Un comprador no puede saltarse la validación desde la tienda online ni con un botón exprés. Pero un pedido de POS, una renovación, una edición o la API nunca pasa por ella. Si dependes de un límite, comprueba cuáles de esos canales usa tu tienda.

## Qué puede ver una Function

Una Function declara una **consulta de entrada**, escrita en GraphQL, y Shopify la rellena en cada ejecución. Entre los campos útiles están:

- **Líneas del carrito:** cantidad, variante, producto, peso, atributos de línea.
- **Identidad del comprador:** si ha iniciado sesión y, para clientes, campos como el número de pedidos y el importe gastado.
- **Metacampos:** de la tienda, productos, variantes y clientes.
- **Atributos del carrito:** por ejemplo, una fecha de entrega elegida en la página del carrito.
- **El paso del recorrido del comprador:** interacción con el carrito, interacción con el checkout o finalización del checkout.

Lo que no puede hacer en una app pública: acceder a la red. No puede preguntar al servidor de la app «¿cuántos pedidos hoy?» durante el checkout. En su lugar, la app cuenta en otro sitio. Escucha las notificaciones de pedidos de Shopify, actualiza sus totales y los escribe en metacampos. La Function lee esos metacampos en la siguiente ejecución.

Por eso los recuentos en una Function son **instantáneas**. Están tan actualizados como la última escritura en los metacampos, no en tiempo real.

## Qué puede y qué no puede hacer

**Puede bloquear con un mensaje.** Esa es toda su salida. Los mensajes pueden dirigirse a todo el carrito o a un campo concreto del checkout, y una app puede dejarte escribir tu propio texto.

**No puede cambiar cantidades.** Una Function de validación no puede reducir una cantidad, quitar una línea ni cambiar un precio. Los antiguos Shopify Scripts podían editar el carrito sin avisar; la validación no. El comprador lee el mensaje y corrige el carrito. Otras APIs de Functions, como Cart Transform o los descuentos, se encargan de modificar el carrito, y no bloquean el checkout.

**No puede reservar stock ni franjas.** La Function lee una instantánea y dice sí o no. No retiene nada. Si dos compradores pasan por el checkout por la última unidad, o la última plaza de una franja de entrega, casi en el mismo momento, ambos pueden leer «queda 1» y ambos pueden pasar. La validación hace fiables los límites con tráfico normal. No garantiza que nunca te pases.

**Hasta 25 Functions de validación por tienda.** Shopify limita cuántas Functions de validación pueden estar activas a la vez. Varias apps pueden añadir una cada una, y se ejecutan todas; basta con que una devuelva un error para bloquear el checkout.

## Planes

- **Las apps públicas de la App Store con Functions funcionan en todos los planes de Shopify.** No necesitas Plus para instalar una app de validación.
- **Las apps personalizadas con Functions requieren Shopify Plus.** Es para tiendas que crean su propia Function privada.
- **Shopify Scripts ya no existen.** Los Scripts dejaron de ejecutarse el 30 de junio de 2026. Muchos límites de cantidad vivían en scripts de artículos de línea. Si era tu caso, consulta [cómo sustituir Shopify Scripts por Functions para reglas de cantidad y de checkout](/blog/shopify-scripts-to-functions-order-limits).

## JavaScript del tema vs validación

Muchas herramientas de límites se ejecutan en el tema: ocultan un botón, limitan un campo de cantidad o muestran un aviso en la página del carrito. Es útil para mostrar los límites pronto. No es aplicarlos.

| | JavaScript del tema o de la página del carrito | Function de validación |
|---|---|---|
| Checkout normal de la tienda online | Solo si el comprador pasa por la página del carrito con JavaScript activado | **Sí** |
| Botones de Shop Pay, Apple Pay, Google Pay en páginas de producto | No, se saltan la página del carrito | **Sí** |
| Enlaces directos al checkout | No | **Sí** |
| Tiendas headless | No, no hay tema | **Sí** |
| Pedidos borrador | No | **Sí** |
| POS | No | No |
| Renovaciones de suscripciones, ediciones de pedidos, pedidos por API | No | No |
| Puede mostrar los límites antes del checkout | **Sí** | No, solo mensajes cuando se comprueba el carrito |
| Se puede eludir desactivando JavaScript | Sí | No |

Ninguna de las dos cubre POS ni renovaciones. La mejor configuración usa ambas: mensajes en la tienda para que los compradores vean los límites pronto y una Function de validación como freno definitivo en el checkout.

Lo mismo ocurre con las fechas de entrega. Un selector de fechas atenúa los días completos o cerrados en el navegador, pero los botones exprés y los enlaces directos al checkout se saltan la página donde está el calendario. Solo una Function de validación vuelve a comprobar la fecha elegida en el checkout. Mira cómo se [comparan las apps de selector de fecha de entrega para Shopify en validación del checkout](/blog/best-shopify-delivery-date-picker-apps).

## Cómo la usa OrderRules

OrderRules instala una Function de validación. Tú defines las reglas en la app; la app lleva los recuentos y los escribe en metacampos; la Function los lee en el checkout y bloquea los pedidos que incumplen una regla. Comprueba:

- **Horario de tienda y festivos:** cierra el checkout fuera de tu horario.
- **Topes de pedidos:** topes diarios para toda la tienda, además de topes semanales y mensuales en los planes de pago.
- **Topes por producto, variante y colección:** totales compartidos entre todos los compradores.
- **Cantidad mínima de pedido y cantidad por incrementos:** por producto o variante, por pedido.
- **Límites por cliente:** pedidos, unidades, gasto o peso por período, para clientes con sesión iniciada.
- **Fechas de entrega y franjas de recogida** en el plan Advanced: horas de corte, fechas bloqueadas y topes por franja.

El mensaje de cada tipo de regla se puede editar en Ajustes. Las reglas se comprueban en todas las superficies de la tabla anterior donde se ejecuta la validación. Los pedidos de POS y las renovaciones no se bloquean, pero sí cuentan para tus límites. Los recuentos son instantáneas, así que dos checkouts casi simultáneos por la última plaza pueden pasar los dos.

La aplicación en el checkout está incluida en todos los planes, también en el plan gratuito Starter. Todos los detalles: [dónde se comprueban las reglas de OrderRules: compatibilidad y limitaciones](/docs/guides/compatibility-and-limitations).

## Lecturas relacionadas

- [Cómo configurar límites de pedidos en Shopify](/blog/how-to-set-order-limits-shopify)
- [Evita la sobreventa: estrategias para tiendas con capacidad limitada](/blog/prevent-overselling-shopify)
- [Límites de pedidos por cliente: guía](/blog/per-customer-order-limits-shopify-guide)
- [Mensajes dinámicos en la tienda](/docs/guides/storefront-messaging)
- [Las mejores apps de selector de fecha de entrega para Shopify, comparadas en validación del checkout](/blog/best-shopify-delivery-date-picker-apps)
- [Validación de la fecha de entrega en Shopify: las comprobaciones y los mensajes que ve el cliente](/blog/shopify-delivery-date-validation)
- [Límites de pedidos nativos de Shopify vs apps (2026)](/blog/shopify-native-order-limits-vs-orderrules)
- [Dónde se comprueban las reglas de OrderRules: compatibilidad y limitaciones](/docs/guides/compatibility-and-limitations)
- [Sustituir Shopify Scripts por Functions para reglas de cantidad y de checkout](/blog/shopify-scripts-to-functions-order-limits)

## Fuentes

- Shopify.dev: [Cart and Checkout Validation Function API](https://shopify.dev/docs/api/functions/latest/cart-and-checkout-validation) (targets, superficies compatibles y no compatibles, límite por tienda)
- Shopify.dev: [Crear una Function de validación del carrito y del checkout](https://shopify.dev/docs/apps/build/checkout/cart-checkout-validation)
- Shopify.dev: [Shopify Functions](https://shopify.dev/docs/apps/build/functions) (disponibilidad por plan para apps públicas y personalizadas)
- Changelog de Shopify.dev: [Shopify Scripts will be deprecated on June 30, 2026](https://shopify.dev/changelog/shopify-scripts-will-be-deprecated-on-june-30-2026)
- Centro de ayuda de Shopify: [Transición de Scripts a Functions](https://help.shopify.com/en/manual/checkout-settings/script-editor/transitioning-to-functions)

## Pruébalo en tu tienda

Instala OrderRules desde la [Shopify App Store](https://apps.shopify.com/orderrules-limit-sales?utm_source=blog&utm_medium=inline_cta&utm_campaign=shopify-checkout-validation-functions-block-orders). La validación del checkout está incluida en todos los planes, y los planes de pago tienen una prueba gratuita de 14 días.
