Gutscheine per MCP verwalten

Der KI-Agent kann Gutscheincodes auf Gültigkeit prüfen, bevor er sie auf eine Bestellung anwendet. Das Tool validate_coupon liefert sofort einen klaren Status — ohne eine Bestellung oder Sitzung anzulegen.

Gutscheincode validieren

Rufen Sie das Tool mit dem zu prüfenden Code auf:

„Prüfe, ob der Gutscheincode ‚SOMMER20' gültig ist."

Das Tool gibt zurück:

ob der Gutschein gültig ist (valid: true oder valid: false)
bei Gültigkeit: Rabatttyp und Rabattwert
bei Ungültigkeit: den genauen Ablehnungsgrund

Erfolgsantwort

Wenn der Code gültig ist, enthält die Antwort:

Feld	Beschreibung
`valid`	`true`
`discount_type`	`percent` (Prozent) oder `fixed` (Festbetrag)
`discount_value`	Numerischer Rabattwert (z. B. `20` für 20 % oder `15` für 15 €)

Beispiel:

„Der Gutscheincode SOMMER20 ist gültig: 20 % Rabatt."

Fehlerantwort und Ablehnungsgründe

Wenn der Code ungültig ist, gibt valid: false zurück — zusammen mit einem der folgenden Ablehnungsgründe:

Ablehnungsgrund	Bedeutung
Gutschein nicht gefunden	Der Code existiert nicht im Shop
Gutschein ist inaktiv	Der Gutschein wurde deaktiviert
Gutschein ist abgelaufen	Das Ablaufdatum liegt in der Vergangenheit
Gutschein noch nicht aktiv	Das Startdatum liegt in der Zukunft
Nutzungslimit erreicht	Der Gutschein wurde bereits so oft eingelöst wie erlaubt

Der Agent kann auf dieser Grundlage eine passende Fehlermeldung für den Kunden formulieren.

Hinweise

Der Parameter code ist Pflicht — fehlt er, schlägt der Aufruf fehl.
Das Tool ist schreibgeschützt: Es verändert weder den Gutschein noch dessen Nutzungszähler.
Eine laufende Bestellung oder aktive Sitzung ist nicht erforderlich — der Aufruf kann jederzeit erfolgen.
Das Tool eignet sich für die Vorab-Validierung im Checkout-Prozess ebenso wie für manuelle Prüfungen durch den Agenten.