API Convalida coupon

Come funziona la convalida dei coupon

Integrare l'API Convalida coupon con sistemi come siti di shopping e sistemi POS (point-of-sale). Per convalidare i coupon, specificare fino a 1.000 codici coupon immessi manualmente nella proprietà della richiesta couponsToValidate.

Se il carrello contiene già codici coupon nei campi coupon, anche l'API li rileva e convalida. Non è necessario copiare tali codici in couponsToValidate. Per i coupon che superano i controlli a livello di coupon, l'API valuta l'idoneità della promozione in base alla posizione in cui è allegato ogni codice.

• Per un coupon allegato all'intestazione del carrello, l'API valuta l'intero carrello.
• Per un coupon allegato a una riga carrello, l'API valuta solo quella riga. La linea deve partecipare a una promozione associata al coupon.

Fornire il carrello e le relative voci nella richiesta, utilizzando la stessa struttura del carrello dell'API Promozioni idonee e dell'API Valutazione ed esecuzione promozioni.

Risultati convalida coupon

Per ogni codice coupon, la risposta fornisce i seguenti dettagli.

• Stato aggregato negli ambiti applicabili. Lo stato è Valid quando il coupon supera la convalida per almeno un ambito applicabile. In caso contrario, lo stato è Invalid.
• Per un coupon valido, l'ambito valido, l'ID promozione associato e, per un ambito Line, gli ID voce carrello applicabili.
• Per un coupon non valido, il motivo per cui la convalida non è riuscita.