> ## 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.

# ¡Motor de promociones para el E-Commerce!

> 📌 A continuación presentamos el detalle de las dinámicas promocionales que soporta nuestra tecnología. ⚠️ El motor de promociones funciona basado en…

📌 A continuación presentamos el detalle de las **dinámicas promocionales** que soporta nuestra tecnología.

⚠️ El motor de promociones funciona basado en **reglas y acciones**

🔎 Las reglas son **condiciones que se deben cumplir** para aplicar una acción

🔎 Las acciones: operación u operaciones **aplicables al universo** definido por la regla.

# Reglas

Las reglas modelan las circunstancias de compra que luego generan una acción específica.

Se clasifican en **5 tipos**:

## **1. Productos**

Para el caso de la regla de productos, estos se dividen en dos grupos: **selectores y variaciones**.

#### **a. Selector**

La regla **se puede aplicar** a la orden **que tenga ciertos productos** filtrados **por cualquiera** de sus propiedades. Por ejemplo:

* Productos con SKU 123 o 345
* Productos de la marca MMMMM
* Productos de la categorías CCCCCC

**b. Variaciones**

La regla puede **incluir rangos de cantidades** o la **clasificación** de productos **en una orden.**

Por ejemplo:

* Producto con SKU 123
  * de 5 a 10 unidades
  * de 10 a 50 unidades
  * de 50 a más
* Producto de la subcategoría CCCCC
  * de 1 a 3 unidades
  * de 3 a 10 unidades
  * de 10 a más

## **2. Usuarios**

Regla que **valida** que una orden haya o no haya **sido realizada** por un usuario o grupo de usuarios.

Por ejemplo:

* Un solo uso por usuario
* Órdenes realizadas por los clientes (Identificados por su correo o código de cliente)
* Órdenes realizadas por los clientes con el código C0001 y C002
* Órdenes realizadas por cualquier cliente a excepción del cliente con email [email@empresa.com](mailto:email@empresa.com)

## **3. Métodos de pago**

La regla se puede **aplicar a un método de pago** específico. Por ejemplo:

* Promoción aplica si la orden es pagada en efectivo.
* Promoción aplica si la orden es pagada con yape.
* Promoción aplica si la orden es pagada con tarjeta.

## **4. Canal**

La regla se puede aplicar dependiendo del **canal donde se realiza la compra.** Por ejemplo:

* Promoción aplica si la compra se dio en el ecommerce
* Promoción aplica si la compra se dio en el backoffice

## **5. Órdenes**

### a. Valor de la Orden

Regla que **valida si el valor total de la orden** es mayor o menor a cierto monto. Por ejemplo:

* Órdenes mayores o iguales a USD 350

# Acciones

Las acciones aplican **determinadas operaciones en una orden** siempre y cuando se hayan cumplido las reglas definidas.

Estas acciones se agrupan en **4 tipos:**

## **1. Bonificación**

Esta acción **incluye** un producto o productos **sin costo** a la orden.

Por ejemplo:

* Regalar una unidad del producto SKU 123
* Regalar unidades del producto SKU 123, según:
  * 1 a 4 unidades adquiridas, regalar 2 unidades
  * 5 a 8 unidades adquiridas, regalar 3 unidades
  * 9 a más, regalar 5

## **2. Descuento en Producto**

Esta acción permite cargar a **descontar valores** **a productos filtrados** por cualquier propiedad. Los valores pueden ser porcentuales o montos fijos.

Por ejemplo:

* Descontar 10% del precio del producto con el sku 1234
* Descontar USD 5 del precio de los productos de la categoría CCCCC

## **3. Descuento en Orden**

Esta acción permite **cargar o descontar valores sobre el total de la orden.** Los valores pueden ser porcentuales o montos fijos.

Por ejemplo:

* Descontar 5% del total de la orden
* Descontar USD 20 del total de la orden

## **4. Descuento en delivery**

Esta acción permite aplicar un descuento en el cargo por delivery/flete

Por ejemplo:

* Descontar USD 5 del costo de flete
* Descontar el 100% del cargo por flete

Para que puedas entender mejor cómo funciona nuestro motor de promociones, conoce un ejemplo de aplicación de las promociones generadas a través de un caso de uso:

**🔎 EJEMPLO: Caso de uso**

El siguiente es un caso de uso basado en un fabricante de productos para la industria panadera.

**Promoción 1:** 4% de descuento en Productos Marca 1

* Por la compra de 2 (a más) productos de la categoría Harinas y de la familia Marca1, se aplicará un descuento de 4% sobre los productos de la categoría Mejoradores de la Marca1.
* Aplica para órdenes realizadas por clientes identificados por su correo o código de cliente:

  * Órdenes realizadas por los clientes con el código C0001 y C002
  * Órdenes realizadas por cualquier cliente a excepción del cliente con email "[email@empresa.com](mailto:email@empresa.com)"
* Vigencia del 15.03.2020 al 15.06.2020

**Promoción 2:** Descuento premezclas

Por la compra la categoría Premezclas se tendrá se tendrán los siguientes descuentos:

* Desde 10 hasta 49 sacos, 3% de descuento
* De 50 a 99 sacos, 5% de descuento
* 100 a más, 8% de descuento
* Aplica para órdenes realizadas por clientes identificados por su correo o código de cliente:

  * Órdenes realizadas por los clientes con el código C0001 y C002
  * Órdenes realizadas por cualquier cliente a excepción del cliente con email "[email@empresa.com](mailto:email@empresa.com)"
* Vigencia 01.03.2020 al 31.03.2020

**Promoción 3:** 50 + 1 en Azucar Marca3

* Por la compra de 50 sacos de azucar de la marca3 recibe 1 saco costo cero.

  * Aplica para órdenes realizadas por clientes identificados por su correo o código de cliente:

    * Órdenes realizadas por los clientes con el código C0001 y C002
    * Órdenes realizadas por cualquier cliente a excepción del cliente con email "[email@empresa.com](mailto:email@empresa.com)"
* Vigencia 01.03.2020 al 31.12.2020

**Promoción 4:** Bonificación aceites Marca10

* Por la compra del producto con SKU 1234M10 se bonificará como sigue :

  * De 5 a 10 baldes, se bonifica 1
  * De 10 a 29, se bonifica 2
  * De 30 a 49, se bonifica 3
  * 50 a más, se bonifica 4
  * Aplica para órdenes realizadas por clientes identificados por su correo o código de cliente:

    * Órdenes realizadas por los clientes con el código C0001 y C002
    * Órdenes realizadas por cualquier cliente a excepción del cliente con email "[email@empresa.com](mailto:email@empresa.com)"
* Vigencia 01.04.2020 al 30.04.2020

**Promoción 5:** 1% por pago al contado

* Se aplicará un 1% a las harinas MarcaH por pago de la orden al contado.
* No participan los clientes: C0000234, C000354
* * Aplica para órdenes realizadas por clientes identificados por su correo o código de cliente:

    * Órdenes realizadas por los clientes con el código C0001 y C002
    * Órdenes realizadas por cualquier cliente a excepción del cliente con email "[email@empresa.com](mailto:email@empresa.com)"
* Vigencia 01.03.2020 al 31.03.2020

🌟 📌 De esta manera puedes generar promociones para los clientes de tu plataforma,

* Para incrementar las ventas de ciertos productos o categorías.
* Incentivar el uso de los métodos de pago que te convengan.
* Fidelizar segmentos de clientes o clientes específicos seleccionados.
* Incentivar la compra por los canales que sean necesarios.
* Y mucho más.

## 📩 Envía tus promociones con las reglas y acciones a [soporte@riqra.com](mailto:soporte@riqra.com) 📩

###
