Descuentos

En Loyal Guru, un descuento es más que una rebaja de precio: es una herramienta promocional versátil para influir en el comportamiento del cliente y reforzar la fidelización.

Audiencias objetivo

Las campañas de descuento pueden acotarse a:

Audiencia	Quién califica
Todos los clientes	Cualquier comprador, incluidos los no inscritos en el programa.
Loyalty members	Solo clientes del programa; filtros opcionales: países de registro, tiers, propiedades del cliente.
Targeted (dirigida)	Una audiencia concreta, entregada mediante una campaña de envío dirigido. Las campañas de descuento dirigidas usan siempre coupon_required = true (códigos únicos por cliente).

Modos de canje

Modo	Descripción
Automático	La campaña se aplica en caja si se cumplen las condiciones de victoria; no hace falta código (salvo que actives un cupón estático opcional).
Basado en código (tiempo real)	El cliente presenta un código en la petición de compra (coupons_desired); el motor resuelve y aplica la campaña en la misma llamada API.
Basado en código (ventana futura)	Las ventanas de validez del voucher (fechas relativas o fijas) marcan cuándo puede canjearse un código dirigido; el canje sigue siendo en tiempo real en la compra cuando es válido.

Cupón frente a voucher

Término	Significado
Cupón	Configuración en la campaña que define cómo funcionan los códigos: código estático compartido (broadcast / loyalty) o códigos dinámicos por cliente para audiencias dirigidas.
Voucher	La relación entre una campaña de descuento y un cliente concreto con un código único, generado al enviar una campaña dirigida.

Las campañas broadcast usan un cupón con código estático para todos los elegibles; las campañas dirigidas emiten un voucher (código único) por cliente.

Casos de uso de ejemplo

• Folleto de descuentos en tienda para miembros — Audiencia loyalty, cupón estático opcional impreso en el folleto, porcentaje o descuento fijo cuando se cumplen las condiciones.
• Doble precio online — Precio miembro vs no miembro mediante campañas solo loyalty, o efectos de tachado / porcentaje combinados con reglas de audiencia.
• Cupones por audiencia — Envío dirigido con códigos de voucher únicos por cliente para ofertas específicas.

Integración API

Loyal Guru admite dos scopes de integración para descuentos. El scope activo se define a nivel de Company (configurations.apply_discounts) y puede sobreescribirse por transacción.

LG como motor promocional (apply_discounts: true)

Loyal Guru evalúa todas las campañas de descuento activas y modifica los valores de las líneas del carrito en la respuesta de la API. El TPV o el checkout de e-commerce recibe los precios ajustados y los aplica directamente, sin necesidad de calcular el descuento en el lado del cliente.

• POST /activities (crear) y POST /activities/simulate (simular): LG calcula la aplicación del descuento y devuelve el carrito con los valores de línea modificados.
• GET /discounts: no devuelve product_ids_rule_* ni locations_* / location_codes (no son necesarios porque LG gestiona el cálculo completo).

Cliente como motor promocional (apply_discounts: false)

Loyal Guru actúa únicamente como servidor de cupones y vouchers. LG indica qué descuentos son aplicables pero no modifica los valores de las líneas del carrito — es el TPV o el sistema de e-commerce quien aplica los importes.

• POST /activities (crear) y POST /activities/simulate (simular): LG devuelve los IDs y códigos de descuento aplicables, pero los valores de línea en la respuesta permanecen sin cambios.
• GET /discounts: rellena product_ids_rule_*, locations_* y location_codes cuando las reglas usan categorías con taxonomía interna, para que el cliente pueda hacer el matching de productos y tiendas — ver Campos para TPV.

Override por transacción

El flag apply_discounts en el payload de POST /activities y POST /activities/simulate sobreescribe la configuración de Company para esa transacción concreta. Por defecto: hereda el valor de la configuración de Company.

Documentación

Página	Temas
Detalles operativos	Secciones de campaña, tipos de efecto, mecánicas retail soportadas
Integraciones — Lectura desde GET	Hub + Respuesta GET, Condiciones, Aplicación, Efectos (bundle: ancla)
Apilamiento	Categorías, stackable frente a mayor descuento, orden de evaluación
Límites	Límites de victoria, presupuesto, tope por transacción
API de campañas	Creación y actualización de campañas de descuento vía Streaming API