Usted está aquí:
API de promociones aptas
Utilice la API de promociones aptas para proporcionar a los clientes una lista de promociones aptas para carritos de clientes. La API puede obtener la lista de promociones aptas para contactos, cuentas y miembros del programa de fidelidad.
Ediciones necesarias
| Disponible en: Lightning Experience |
| Disponible en: Ediciones Enterprise, Unlimited y Developer con Gestión de ofertas en tiempo real |
Proporcione a sus clientes una lista de promociones aptas para su carrito. La API toma los detalles del carrito de un cliente como la solicitud y proporciona los detalles de las promociones activas aptas para el carrito como la respuesta. Cuando busque promociones aptas para un artículo, la API explora 5 niveles de la jerarquía de categorías del producto.
Si un carrito contiene un producto que no existe en el catálogo de Salesforce, la API ignora los productos no sincronizados mientras evalúa promociones a nivel de línea y a nivel de línea cruzada y muestra promociones aptas para el carrito.
Si una organización tiene múltiples bibliotecas de reglas de tipo Gestión de promociones globales, los integradores del sistema deben especificar qué biblioteca de reglas ejecuta la API. También deben confirmar que la solicitud de API contiene valores que la definición de contexto de la biblioteca de reglas requiere para evaluar carritos.
La respuesta de API proporciona estos detalles de promoción.
- Detalles principales de la promoción como fechas de inicio y finalización
- Valores de campo personalizados de promoción
- Límites de promoción
- Reglas de promoción aptas para el carrito del cliente
- Valores de campo personalizados de promoción asignados en la definición de contexto de promoción.
Para proporcionar a los clientes sus promociones aptas en tiempo real, integre la API de promociones aptas con sistemas externos que gestionan carritos de clientes. Consulte Promociones aptas.
Después de que el uso de una promoción cumpla el límite de la promoción para un carrito concreto, la API de promociones aptas no proporciona la recompensa en el resultado de API para ningún cliente. Después de que el uso de un cliente de una recompensa cumpla el límite a nivel de cliente de la promoción, la API de promociones aptas ya no ofrece la recompensa al cliente.
Este es el aspecto de la solicitud de API de promoción apta cuando se ejecuta la API desde el sitio de compras en línea de Cloud Kicks.
{
"cart":{
"Accessory":[
{
"activityStartDate":"2023-06-14T12:45:19Z",
"contactId":"003xx000004WjzAAAS",
"transactionAmount":85,
"currencyISOCode":"INR",
"cartLineDetails":[
{
"CartLineProductCategory":"Sneaker Shields",
"cartLineProductCatalogId:"0ZSSB0000002d8X4AQ"",
"AttributeKey:"Premium"
}
]
}
]
}
}API de promociones aptas para promociones con cupones
Cuando se agregan cupones a una promoción, la API de promociones aptas toma los detalles del carrito de un cliente como la solicitud y responde con los detalles de los cupones activos para las promociones aptas para el carrito del cliente. El cliente puede utilizar el cupón de la promoción que desea aplicar a su carrito.
Para promociones aptas que incluyen un cupón, la respuesta de la API incluye estos detalles de cupón.
- Código de cupón
- Fechas de inicio y finalización
- Estado
La API solo devuelve promociones que tienen al menos un cupón activo y válido para la fecha de actividad del cliente. Aunque una promoción puede constar de múltiples cupones, la API no muestra el código del cupón en estos escenarios.
- Si hay varios cupones activos aptos para la fecha de actividad
- Si ningún cupón está activo para la fecha de actividad
- Si el cupón activo apto alcanzó su límite de uso
