Descuentos escalonados de Shopify en 2026: Compra más, ahorra más con funciones

Por Eoin Villarin, 2026-11-15

Cómo crear descuentos por cantidad por tramos en Shopify después de que se retiraran los Scripts: opciones incorporadas, apps de descuento y una Discount Function JavaScript funcional con tramos en metafield.

¿Cómo crear descuentos por tramos en Shopify?

Crea descuentos escalonados por cantidad en Shopify con una Función de Shopify creada en la API de Función de Descuento, o con una app de descuento impulsada por Funciones de la Tienda de Apps de Shopify. La Función cuenta la cantidad de la cesta, selecciona el nivel coincidente y devuelve una operación productDiscountsAdd. Las apps públicas funcionan en cualquier plan; las apps personalizadas con Funciones necesitan Shopify Plus.

Aspectos clave

  • Los Shopify Scripts dejaron de ejecutarse el 30 de junio de 2026, por lo que los descuentos escalonados ahora necesitan Shopify Functions.
  • Descuentos de producto y pedido utilizan el objetivo cart.lines.discounts.generate.run.
  • Almacena los niveles como JSON en el metafield de configuración de la función $app para que cambien sin implementar.
  • Las aplicaciones de descuento públicas funcionan en cualquier plan; las aplicaciones personalizadas con Funciones requieren Shopify Plus.
  • Muestra la tabla de niveles en la página del producto para que los clientes vean el ahorro antes del carrito.

Para crear descuentos de cantidad escalonados en Shopify en 2026 (por ejemplo, compra 3 ahorra 10%, compra 5 ahorra 15%, compra 10 ahorra 20%), utiliza una función de Shopify creada en la API de función de descuento, o una aplicación de descuento impulsada por funciones de la tienda de aplicaciones de Shopify. Los Shopify Scripts solían hacer esto en Shopify Plus, pero dejaron de ejecutarse el 30 de junio de 2026. A continuación, se muestra la ruta sin código, los límites de los descuentos automáticos integrados de Shopify y una función de JavaScript que puedes adaptar, con niveles almacenados en un metafield para que el marketing pueda cambiarlos sin una implementación.

Tres formas de hacer descuentos escalonados en Shopify

MétodoPlanificaciónEsfuerzoLímites
Descuentos automáticos incorporados (uno por tramo)CualquierMinutosCada descuento tiene un mínimo; varios tramos dependen de la configuración de combinación de descuentos y pueden acumularse o entrar en conflicto
App de descuentos impulsada por FunctionsCualquierUna horaTarifa mensual de la aplicación, las reglas limitadas a la configuración de la aplicación
App personalizada con una Discount FunctionShopify Plus para aplicaciones personalizadas1 a 5 díasDesarrollo y mantenimiento; control total

Para uno o dos tramos simples, prueba primero los descuentos automáticos incorporados. Para varios tramos, reglas de etiquetas de clientes, reglas de colecciones o cualquier cosa en la que tu tienda confiaba en Scripts, usa una Function.

Bolsa de mano reutilizable impresa con Rotterdam 010 en una vitrina de tienda
Los niveles de volumen elevan el valor promedio de los pedidos en productos que la gente compra en múltiplos. Foto: Donald Trung Quoc Don, CC BY-SA 4.0, vía Wikimedia Commons

Cómo funciona la API de Discount Function

  • Una Function es un pequeño módulo WebAssembly que Shopify ejecuta durante el carrito y el checkout. Puedes escribirla en JavaScript o Rust; Shopify recomienda Rust para carritos grandes.
  • Descuentos de producto y pedido utilizan el objetivo cart.lines.discounts.generate.run. Los descuentos de envío utilizan cart.delivery-options.discounts.generate.run.
  • La función devuelve operaciones como productDiscountsAdd, orderDiscountsAdd o deliveryDiscountsAdd.
  • las clases del descuento (PRODUCT, ORDER, SHIPPING) llegan a la entrada, así una Function puede comprobar qué está permitido aplicar.
  • La configuración se almacena en un metafield en el descuento (namespace $app, clave function-configuration), leer como JSON.

Paso 1: Generar la función

shopify app init
cd your-app
shopify app generate extension --template discount --name tiered-discount

Elige JavaScript cuando la CLI pregunte por un lenguaje. El generador crea la carpeta de la extensión con una configuración TOML, una consulta de entrada y una función run.

Paso 2: La consulta de entrada

query CartInput {
  cart {
    lines {
      id
      quantity
    }
  }
  discount {
    discountClasses
    metafield(namespace: "$app", key: "function-configuration") {
      jsonValue
    }
  }
}

Paso 3: La función de ejecución

import { DiscountClass, ProductDiscountSelectionStrategy } from '../generated/api';

const DEFAULT_TIERS = [
  { min: 3, percent: 10 },
  { min: 5, percent: 15 },
  { min: 10, percent: 20 },
];

export function cartLinesDiscountsGenerateRun(input) {
  if (!input.cart.lines.length) {
    return { operations: [] };
  }
  if (!input.discount.discountClasses.includes(DiscountClass.Product)) {
    return { operations: [] };
  }
  const config = input.discount.metafield?.jsonValue;
  const tiers = Array.isArray(config?.tiers) && config.tiers.length ? config.tiers : DEFAULT_TIERS;
  const totalQuantity = input.cart.lines.reduce((sum, line) => sum + line.quantity, 0);
  const tier = [...tiers].sort((a, b) => b.min - a.min).find((t) => totalQuantity >= t.min);
  if (!tier) {
    return { operations: [] };
  }
  return {
    operations: [
      {
        productDiscountsAdd: {
          selectionStrategy: ProductDiscountSelectionStrategy.First,
          candidates: [
            {
              message: `${tier.percent}% off ${tier.min}+ items`,
              targets: input.cart.lines.map((line) => ({ cartLine: { id: line.id } })),
              value: { percentage: { value: String(tier.percent) } },
            },
          ],
        },
      },
    ],
  };
}

Notas: los valores porcentuales son Decimales y deben enviarse como cadenas. Para limitar el descuento a una colección, agrega merchandise con inAnyCollection a la consulta de entrada y filtrar las líneas antes de contar.

Paso 4: Implementar y crear el descuento

  1. Ejecutar shopify app dev para probar en una tienda de desarrollo, luego shopify app deploy.
  2. Crea un descuento automático de app que use tu Function (por ejemplo con el discountAutomaticAppCreate mutación de Admin API), establece su clase de descuento a product y guarda el JSON de los tramos en el $app / function-configuration metacampo:
{"tiers":[{"min":3,"percent":10},{"min":5,"percent":15},{"min":10,"percent":20}]}
  1. Establece las reglas de combinación de descuentos (con producto, pedido y descuentos de envío) para que coincidan con tu política de promoción.
  2. Carros de prueba con 2, 3, 5 y 10 artículos, productos mezclados, un código de descuento en la parte superior y diferentes mercados.

Muestra los niveles en la página del producto

Los clientes solo compran más si pueden ver la oferta. Añade una pequeña tabla de tramos debajo del precio ("3+ ahorra 10%, 5+ ahorra 15%, 10+ ahorra 20%") usando un bloque de app de tema o un metafield en tu tema, y muestra el ahorro en el carrito. Mantén el texto de la tabla igual que los tramos de la Function para que el carrito nunca difiera de la página del producto.

Inicio de sesión de Shopify en un directorio de edificios de oficinas
Las Discount Functions se ejecutan dentro del checkout de Shopify, por lo que funcionan con Checkout Extensibility y Shop Pay. Foto: Raysonho @ Open Grid Scheduler / Grid Engine, CC0, via Wikimedia Commons

Problemas habituales

  • El descuento no se aplica: el descuento no está activo, su clase no incluye producto o la función no devolvió operaciones (revisa los registros de ejecución de la función en el panel de socios o en shopify app dev).
  • Acumulación con códigos: la configuración de combinación de descuentos decide si un código se aplica encima. Establece deliberadamente.
  • Nivel incorrecto: asegúrate de contar la cantidad en las líneas correctas (todas las líneas, una colección o un producto).
  • Carritos grandes: los carros muy grandes pueden alcanzar los límites de la función en JavaScript; Rust es más rápido si ves fallas.

¿Necesitas que lo construya?

Desarrollo Shopify Functions, apps de descuento y extensiones Checkout UI para tiendas Shopify y Shopify Plus. Si tu precios por tramos dejó de funcionar cuando se retiraron los Scripts, lee Los Shopify Scripts dejaron de funcionar: cómo solucionarlo o ver mi Servicios de desarrollo de Shopify.

Preguntas frecuentes

¿Puede Shopify hacer descuentos escalonados sin una app?

En parte. Puedes crear un descuento automático por nivel con una cantidad mínima, pero varios niveles dependen de la configuración de combinación de descuentos y pueden comportarse de manera impredecible. Una Función o app impulsada por Funciones ofrece niveles fiables.

¿Necesito Shopify Plus para descuentos escalonados?

Ninguna aplicación de descuento pública que utilice Shopify Functions funciona en cualquier plan. Solo una aplicación personalizada con tu propia función requiere Shopify Plus.

¿Qué reemplazó a Shopify Scripts para precios escalonados?

La API de Función de Descuento. Los descuentos de producto y pedido utilizan el objetivo cart.lines.discounts.generate.run y devuelven operaciones productDiscountsAdd u orderDiscountsAdd.

¿Puedo cambiar los niveles de descuento sin redeployar?

Sí. Almacena los niveles como JSON en el metafield de configuración de la función de descuento y léelo en la entrada de la Función.

¿Pueden los descuentos escalonados aplicarse a una sola colección?

Sí. Consulta la mercancía de cada línea con inAnyCollection y solo cuenta y descuenta las líneas de esa colección.

¿Debería escribir Shopify Functions en JavaScript o Rust?

JavaScript es más rápido de escribir y está bien para la mayoría de las tiendas. Shopify recomienda Rust para el rendimiento, especialmente con cestas grandes.

Fuentes

Lectura relacionada