API applicazione premio promozione
Emettere premi senza prezzo e aggiornare i limiti di promozioni e clienti dopo che i clienti hanno effettuato gli ordini.
Versioni (Edition) richieste
| Disponibile nelle versioni: Lightning Experience |
| Disponibile in: Enterprise Edition, Unlimited Edition e Developer Edition con Gestione offerte in tempo reale |
Dopo l'invio di un ordine, l'API prende in input i dettagli della promozione e del premio applicati al carrello. È possibile eseguire l'API per referenti e account. Se la società utilizza gli account personali per gestire i clienti, specificare l'ID referente associato all'account personale del cliente.
La risposta API contiene i dettagli dei premi prezzi e non prezzi forniti al cliente per l'ordine. L'API applicazione premio promozione può essere eseguita per fornire i seguenti premi:
- Sconti
- Voucher
- Giochi
L'API applicazione premio promozione crea o aggiorna anche il record di utilizzo correlato della promozione in base ai parametri presenti nella richiesta API.
| Parametro | Record utilizzo creati o aggiornati |
|---|---|
| premi | Record Utilizzo limite promozione e Utilizzo parte promozione per punti e voucher. |
| appliedPromotions (Promozioni applicate) | Record Utilizzo parte promozione per il numero di volte in cui i clienti hanno utilizzato la promozione. |
I record Utilizzo limite promozione consentono di tenere traccia dell'utilizzo di ogni premio promozione rispetto ai limiti della promozione. I record Utilizzo parte promozione consentono di tenere traccia dell'utilizzo di ogni premio promozione da parte dei clienti rispetto ai limiti a livello di cliente della promozione.
L'API applicazione premio promozione gestisce automaticamente questi limiti.
- Limiti delle promozioni:
- Punti
- Voucher
- Limiti dei clienti:
- Punti
- Voucher
- Utilizzo per cliente
È necessario impostare processi per gestire i limiti per carrello, per voce, di responsabilità e di utilizzo totale.
Dopo l'esecuzione dell'API, il valore del campo Conteggio utilizzo nell'utilizzo della parte promozione del cliente viene incrementato di 1.
API applicazione premio promozione per promozioni con coupon
Quando si esegue l'API, specificare il codice coupon utilizzato dal cliente per l'ordine. Il codice coupon identifica in modo univoco la promozione utilizzata dal cliente per l'ordine.
L'API è costituita dal parametro shouldCheckCouponUsageLimit. Se l'utilizzo del coupon è già aumentato, impostare il parametro su False. Per utilizzare l'API per verificare se il coupon è disponibile per il riscatto e quindi aumentare il conteggio dell'utilizzo del coupon, impostare il parametro su True.
