Vous êtes ici :
API Application de récompense de promotion
Émettez des récompenses non tarifaires et mettez à jour les limites en promotions et en clients lorsque les clients passent leurs commandes.
Éditions requises
| Disponible avec : Lightning Experience |
| Disponible avec : Éditions Enterprise, Unlimited et Developer avec Gestion des offres en temps réel |
Lorsqu'une commande est passée, l'API prend en entrée les détails de la promotion et de la récompense appliquées au panier d'achat. Vous pouvez exécuter l'API pour des contacts et des comptes. Si votre entreprise utilise des comptes personnels pour gérer les clients, spécifiez l'ID de contact associé au compte personnel du client.
La réponse d'API contient les détails des récompenses tarifaires et non tarifaires fournies au client pour sa commande. L'API Application de récompense de promotion peut être exécutée pour fournir les récompenses suivantes :
- Remises
- Coupons
- Jeux
L'API Application de récompense de promotion crée ou met également à jour l'enregistrement d'utilisation associé à la promotion en fonction des paramètres présents dans la requête d'API.
| Paramètre | Enregistrements d'utilisation créés ou mis à jour |
|---|---|
| récompenses | Enregistrements Utilisation de la limite de promotion et Utilisation de la partie de promotion pour les points et les coupons. |
| appliedPromotions | Enregistrements d'utilisation de la partie de promotion indiquant le nombre de fois que les clients ont utilisé la promotion. |
Les enregistrements Utilisation de la limite de promotion aident à suivre l'utilisation de chaque récompense de promotion par rapport aux limites de la promotion. Les enregistrements Utilisation de la partie de promotion aident à suivre l'utilisation de chaque récompense de promotion par les clients par rapport aux limites au niveau client de la promotion.
L'API Application de récompense de promotion gère automatiquement ces limitations.
- Limites en promotions :
- Points
- Coupons
- Limites des clients :
- Points
- Coupons
- Utiliser par client
Vous devez configurer des processus pour gérer les limites par panier d'achat, par élément de ligne, responsabilité et utilisation totale.
Une fois l'API exécutée, la valeur du champ Nombre d'utilisations dans l'utilisation de la partie promotion du client est incrémentée de 1.
API Application de récompense de promotion pour des promotions avec des coupons
Lorsque vous exécutez l'API, spécifiez le code coupon que le client a utilisé pour sa commande. Le code coupon identifie de façon unique la promotion que le client a utilisée pour sa commande.
L'API est composée du paramètre shouldCheckCouponUsageLimit. Si vous avez déjà augmenté l'utilisation du coupon, définissez le paramètre sur False. Pour utiliser l'API afin de vérifier si le coupon est disponible pour l'échange, puis augmenter le nombre d'utilisations du coupon, définissez le paramètre sur True.
