Validatie-API voor coupons

Hoe validatie van coupons werkt

Integreer de API voor couponvalidatie met systemen zoals winkelsites en kassasystemen. Geef voor het valideren van coupons maximaal 1000 handmatig ingevoerde couponcodes op in de verzoekeigenschap couponsToValidate.

Als het winkelwagentje al couponcodes in de couponvelden bevat, ontdekt en valideert de API die codes ook. U hoeft deze codes niet te kopiëren naar couponsToValidate. Voor coupons die de controles op couponniveau doorstaan, evalueert de API de aanspraak op speciale actie op basis van waar elke code is bijgevoegd.

• Voor een coupon die aan de koptekst van het winkelwagentje is gekoppeld, evalueert de API het gehele winkelwagentje.
• Voor een coupon die is gekoppeld aan een regel voor winkelwagentje, evalueert de API alleen die regel. De lijn moet deelnemen aan een speciale actie die is gekoppeld aan de coupon.

Geef het winkelwagentje en de bijbehorende regelitems op in de aanvraag, met behulp van dezelfde winkelwagentjesstructuur als de API In aanmerking komende speciale acties en de API Evaluatie en uitvoering speciale actie.

Validatieresultaten van coupons

Voor elke couponcode bevat de respons deze details.

• Een geaggregeerde status voor de van toepassing zijnde bereiken. De status is Valid wanneer de coupon de validatie doorstaat voor minstens één van de van toepassing zijnde bereiken. Anders is de status Invalid.
• Voor een geldige coupon, het geldige bereik, de gekoppelde ID van speciale actie en, voor een Line, de van toepassing zijnde ID's van winkelwagentjesregels.
• Voor een ongeldige coupon, de reden dat validatie is mislukt.