---
title: Promociones
description: Crea códigos de descuento automático o promoción y controla quién puede usarlos.
---

Usa Promociones para definir un descuento, su experiencia del cliente, sus reglas de elegibilidad y si está activo o aún es un borrador.

## Por qué y cuándo usar Promociones

Crea una promoción para una campaña planificada, incentivo del cliente, oferta de envío gratis o oferta de compra y obtén. Comienza en Borrador mientras verificas los detalles; usa Activo solo cuando el descuento debe ser elegible en el pago.

## Disponibilidad y requisitos previos

- Abre un proyecto de Runner con un backend de tienda listo.
- Crea los productos referenciados por una regla Compra X Obtén Y antes de construir esa promoción.
- Confirma la moneda de mercado relevante y la configuración de envío antes de ofrecer descuentos basados en cantidad o envío gratis.
- Prueba el comportamiento del pago con un pedido de prueba apropiado antes de compartir un código públicamente.

## Abre Promociones

**Ruta de acceso:** **Espacio de trabajo → elige una tienda → Operaciones de tienda → Promociones**

## Controles principales

| Control | Por qué lo usas | Qué sucede cuando se selecciona |
| --- | --- | --- |
| **Crear** / **Agregar primera promoción** | Elige un nuevo tipo de descuento | Abre un menú para Cantidad de descuento del pedido, Porcentaje de descuento del pedido, Compra X Obtén Y o Envío gratis. La lista vacía usa **Agregar primera promoción**. |
| **Cantidad de descuento del pedido** | Descuenta el total del pedido por una cantidad fija | Abre un formulario con cantidad, método, estado y configuraciones de elegibilidad. |
| **Porcentaje de descuento del pedido** | Descuenta el total del pedido por un porcentaje | Abre un formulario con un valor de porcentaje y la configuración compartida. |
| **Compra X Obtén Y** | Da productos seleccionados después de una compra calificada | Abre selectores de cantidad y producto para lo que el cliente compra y obtiene. |
| **Envío gratis** | Elimina tarifas de envío elegibles | Abre una promoción cuyo descuento se aplica al envío. |
| **Descuento automático** | Aplica la promoción sin pedir al cliente un código | El pago evalúa las reglas automáticamente, pero el formulario aún requiere un valor de código para identificar la promoción. |
| **Código de promoción** | Requiere un código ingresado por el cliente | Los clientes deben ingresar el código requerido en el pago. |
| **Activo** / **Borrador** | Controla si la promoción es utilizable | Guarda el estado operativo elegido con la promoción. |
| **Agregar condición** | Limita quién puede usar la promoción | Agrega campos de atributo del cliente, operador y valor. |
| **Guardar** | Aplica un formulario de creación o edición válido | Crea o actualiza la promoción y vuelve a la lista de promociones después del éxito. |
| Fila de promoción | Inspecciona una promoción | Abre tipo, método, estado, código, uso y acciones disponibles. |
| **Editar** | Cambia la promoción seleccionada | Abre el formulario de edición para ese tipo de promoción existente. |
| **Eliminar** | Elimina permanentemente la promoción | Desde la lista de escritorio, abre una confirmación irreversible nombrando el código de promoción. La vista móvil actual no muestra esta acción. |

## Crea una promoción

1. Selecciona **Crear**, o **Agregar primera promoción** cuando la lista esté vacía.
2. Elige el tipo que coincida con la oferta.
3. Elige **Descuento automático** o **Código de promoción**.
4. Ingresa el valor de código requerido. Para **Código de promoción**, ingresa el código exacto que los clientes deben usar; para **Descuento automático**, los clientes no lo ingresan.
5. Elige **Borrador** mientras preparas o **Activo** cuando debe ser elegible.
6. Ingresa el valor de Descuento, o selecciona los productos Compra y Obtén y cantidades.
7. Deja la elegibilidad como todos los clientes o selecciona **Agregar condición** y completa cada campo de condición.
8. Revisa el resumen, luego selecciona **Guardar**.
9. Vuelve a la lista y confirma el Tipo, Método, Estado, Código y valores Usados.

## Edita o elimina una promoción

1. Selecciona una fila de promoción.
2. Elige **Editar**, cambia los campos deseados y selecciona **Guardar**.
3. Prueba la regla actualizada antes de compartirla con los clientes.
4. Para eliminarla, vuelve a la lista de escritorio, selecciona **Eliminar** y lee el código en la confirmación.
5. Continúa solo si la eliminación permanente es intencional.

## Estados y límites

- **Borrador** se almacena pero no está destinado a ser utilizable en el pago.
- **Activo** es elegible para aplicar cuando su método y condiciones coinciden.
- **Inactivo** puede aparecer en la lista cuando una promoción existente no está actualmente activa.
- Un valor de porcentaje debe estar entre 1 y 100.
- El formulario requiere un valor de código para ambos métodos. Los clientes lo ingresan solo cuando se selecciona **Código de promoción**.
- Compra X Obtén Y requiere tanto el producto calificado como el producto gratuito.
- Cada condición agregada necesita un atributo, operador y valor.
- Con un descuento automático, el pago decide si sus reglas coinciden; el cliente no ingresa el valor de código del formulario.

## Solución de problemas

- **Guardar está deshabilitado o muestra un error:** Completa el valor, código, producto, cantidad o campos de condición nombrados por el formulario.
- **Un código no funciona en el pago:** Confirma ortografía exacta, estado Activo, elegibilidad del cliente, requisitos de producto, mercado y el pago actual.
- **Un descuento automático no se aplica:** Verifica que el pedido cumpla con cada condición y que otra promoción no esté cambiando el resultado esperado.
- **Una promoción de envío gratis no tiene efecto visible:** Confirma que el pedido tiene una opción de envío guardada elegible y que la promoción está Activa.
- **La lista de promociones no se carga:** Actualiza la página y confirma el proyecto correcto antes de intentar crear un duplicado.

## Guías relacionadas

- [Productos](./products)
- [Clientes](./customers)
- [Envío](./shipping)
- [Pedidos](./orders)
