> ## Documentation Index
> Fetch the complete documentation index at: https://docs.riqra.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Códigos de descuento y límites de uso

> Cómo funcionan los códigos que ingresa el comprador, cómo limitar sus usos y qué ve el comprador cuando un código no aplica.

Una promoción **Con código** se aplica solo cuando el comprador ingresa su código. El código no cambia el descuento. La promoción define qué se descuenta y el código es la llave para recibirlo.

## Reglas del código

* Entre 3 y 64 caracteres. Letras de la A a la Z sin tildes ni ñ, números, guiones y guiones bajos.
* Se guarda en mayúsculas. El comprador puede escribirlo en minúsculas.
* Es único en tu tienda. Dos promociones no pueden compartir un código.

Si cambias el código de una promoción, los carritos que tenían el código anterior lo pierden. Los pedidos ya confirmados conservan el código con el que se compraron.

## Dónde lo ingresa el comprador

En el carrito y en el checkout, en el campo **Código de descuento**. Un carrito admite hasta 5 códigos a la vez. Si el campo no aparece en el carrito, revisa el ajuste **Permitir descuentos** de la sección **Carrito** en el editor de tu tema. En algunos temas viene desactivado. El campo del checkout siempre está visible.

Un código ingresado se queda en el carrito y se vuelve a evaluar con cada cambio. Si el comprador quita productos y deja de cumplir la condición, el código sigue visible con el motivo, y vuelve a aplicarse cuando el carrito cumple otra vez.

## Qué ve el comprador

Al ingresar un código, el carrito rechaza los que el comprador no puede arreglar y muestra «Este código no se puede aplicar». Pasa cuando el código no existe, su promoción no está activa, el comprador no cumple la elegibilidad o la condición de Compra X lleva Y, se agotaron los usos o el comprador ya usó una promoción de un uso por persona. Con 5 códigos en el carrito, el mensaje es «Solo puedes usar 5 códigos por carrito».

Los demás casos se aceptan y quedan visibles con su motivo, porque el comprador puede resolverlos:

| Mensaje | Qué falta |
| - | - |
| **No alcanzas el mínimo** | Cumplir el requisito mínimo. |
| **No aplica a los productos de tu carrito** | Agregar alguno de los productos que participan. |
| **Se aplica al elegir el envío** | Elegir la entrega en el checkout. Solo en envío gratis. |
| **No cubre el envío elegido** | El envío elegido cuesta más que el monto máximo de la promoción. |
| **Se aplica al elegir un método de pago válido** | Elegir el método de pago en el checkout. |
| **No aplica al método de pago elegido** | Elegir uno de los métodos permitidos. |
| **No se combina con otro descuento** | Nada. Otra promoción que ahorra más ocupó su lugar. |
| **El envío ya es gratis** | Nada. El envío no tenía costo. En recojo en tienda dice **No aplica al recojo en tienda**. |

Mientras un código está en un estado que el comprador puede resolver, el checkout no deja confirmar el pedido y muestra «Quita el código … para continuar». Si el código espera un método de pago, el mensaje es «Elige un método de pago válido para el código … o quítalo para continuar». Los dos últimos mensajes no bloquean, porque el comprador no pierde nada al confirmar.

Si un código ya ingresado cae después en uno de los casos que se rechazan al ingresarlo, por ejemplo porque la promoción expiró, se queda en el carrito con su motivo (**Código no disponible**, **No aplica a tu carrito**, **Código agotado** o **Ya usaste este código**) y el checkout pide quitarlo.

## Límites de uso

En la sección **Usos máximos del descuento**:

* **Limitar el número total de usos.** Cuántos pedidos pueden usar la promoción en total, entre todos los compradores.
* **Un uso por persona.** Cada comprador puede usarla en un solo pedido. Se identifica por su cuenta o, si compra sin cuenta, por el correo que escribe en el checkout. Una compra con cuenta y otra sin cuenta con el mismo correo cuentan como compradores distintos.

Un uso se registra al confirmar el pedido, antes del pago. Un pago rechazado no consume otro uso, porque el comprador reintenta el pago sobre el mismo pedido. Si el pedido se cancela o vence, el uso no vuelve. Si se agotó el límite total, súbelo. Si un comprador ya gastó su único uso, desmarca **Un uso por persona** o crea otro código.

Puedes bajar el límite por debajo de los usos ya registrados. La promoción deja de aplicarse.

La ficha de la promoción muestra los usos acumulados junto al estado. Eliminar la promoción borra ese contador.

## Códigos en una cotización

Cuando el comprador guarda una cotización, los códigos del carrito se guardan con ella. Cuando pasa la cotización al carrito para comprarla, los códigos se aplican de nuevo con las condiciones de ese momento. Un código que el carrito rechaza se omite y el comprador ve cuáles quedaron fuera.
