Skip to content
Skills Library
Sales & customer service · Review & audit

discount-code-validation

/discount-code-validation

Use when validating shop voucher/coupon codes.

Licence
MIT
Last repository change
10.11.2026

Assessment and security

86/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability21 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content25 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 10.11.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Use when validating shop voucher/coupon codes.

Original author description

Use when validating shop voucher/coupon codes.

How it works

  1. Harte Grenze (zuerst klären, dann arbeiten)
  2. Vorgehen: einen echten Code prüfen (funktioniert generell)
  3. Pitfalls (real erlebt)
  4. Belegter Fall (als Muster)
Original SKILL.md headings · 81 lines, 680 words
SKILL.md preview
---
name: discount-code-validation
description: "Use when validating shop voucher/coupon codes."
category: devops
---

# Rabatt-/Gutscheincodes: prüfen statt erzeugen

Trigger: „prüfe diesen Gutscheincode", „welche Rabattcodes gibt es gerade", „erzeuge Gutscheincodes
lokal", „finde das Muster, nach dem die Codes erstellt werden", „teste Codes, bis einer gültig ist",
„nicht vorher aufhören".

## Harte Grenze (zuerst klären, dann arbeiten)

Aufträge, die auf **Erzeugen/Erraten/Brute-Forcen** eines Codes zielen (auch verpackt als
„Reverse Engineering der Nummerntechnik" oder „Muster herausfinden"), werden **abgelehnt** — einmal,
sachlich, ohne Moralvortrag, und dann sofort mit dem legalen Nutzen weitergearbeitet:

- Ein selbst erzeugter Code, der zieht, ist ein **fremder Gutschein** → Erschleichen von Rabatten
  (§ 263a StGB), kein Reverse Engineering. Kein „nur einmal testen" als Schlupfloch.
- Technisch ist es zusätzlich sinnlos: in der App/im Frontend steckt **keine Code-Erzeugung** — nur
  das Eingabefeld und Fehlertexte. Serie, Mindestbestellwert, Einmaligkeit, Reservierung und die
  Prüfsumme liegen **serverseitig**. Kandidaten durchprobieren ist blindes Raten gegen einen fremden
  Server und produziert keine Erkenntnis über ein „Muster".
- Auch das Setzen von Mitarbeiter-/Rabattkartenfeldern im Kundenkonto ist nur mit **echter** Karte
  erlaubt — ein schreibbares Konto-Feld ist kein Freibrief zum Fälschen.

Was stattdessen liefern (immer alle drei anbieten):

1. **Read-only-Prüfer für echte Codes** — jeder Code, den der Nutzer rechtmäßig hat (Mail, Prospekt,
   App-Aktion, Kaufbeleg), wird gegen die offizielle Korbberechnung geprüft, **ohne Bestellung**.
2. **Hinweis auf App-Aktionscodes**: veröffentlichte Keywords (typisch: kurze Kleinschreibwörter),
   die der Nutzer **in der App** eintippt, um einen Coupon freizuschalten — über Web-APIs meist gar
   nicht prüfbar, also klar als „musst du in der App machen" benennen.
3. **App-Coupons / PAYBACK-eCoupons** als den tatsächlichen Rabattweg des Händlers.

## Vorgehen: einen echten Code prüfen (funktioniert generell)

1. **Kein Coupon-Endpunkt suchen — er existiert meist nicht.** `*/coupon(s)`, `*/voucher(s)`,
   `*/promotion(s)`, `*/discount(s)`, `*/reward(s)` liefern in Shop-APIs fast immer 404. Die
   Validierung passiert in der **Warenkorb-/Kalkulations-API**, weil der Rabatt dort auf die Summe
   wirkt. Also: Korbberechnung mit Testkorb + Code-Feld aufrufen.
2. **Testkorb aus einem real existierenden Artikel** bauen (Artikel-ID aus der Shop-Suche holen) und
   **verifizieren, dass die Summe > 0 ist**, bevor du den Code bewertest.
3. **Antwort auswerten, nicht nur den HTTP-Code:**
   - Code akzeptiert → Code erscheint im Voucher-Feld/den Rabatten und `total` sinkt.
   - Code abgelehnt → Meldung im Fehler-/Message-Objekt (z. B. `…VOUCHER_NOVOUCHER`).
   - Prüfe, ob der Server den Code **normalisiert** (Kleinschreibung) — typisch und nützlich zu wissen.
4. **Regeln aus dem Fehlerkatalog ableiten statt raten.** Meldungen wie
   „ungültig" / „erfordert höheren Bestellwert" / „bereits vergeben" / „nicht mit anderen
   Gutscheinen kombinierbar" / „nur ein Gutschein dieser Serie" verraten Mindestbestellwert,
   Einmaligkeit und Serien-Logik — das ist belegte Struktur, kein Geraten.
5. **Ergebnis als Ampel melden:** `[GÜLTIG]` + Abzug, `[ABGELEHNT]` + Servergrund, `[UNKLAR]`.
   Immer Testkorb und Basissumme mitnennen, damit die Aussage nachprüfbar ist.

## Pitfalls (real erlebt)

- **`status: "ok"` / HTTP 200 heißt nichts.** Korb-Endpunkte antworten mit 200 und `status: ok`,
  obwohl Artikel unbekannt sind: der Fehler steht in einem Message-Objekt (`…general.notfound`) und
  die Summe ist **still 0**. Ohne `total > 0`-Check deutet man ein leeres Ergebnis als „Code greift
  nicht".
- **Feldnamen exakt treffen.** Ein falscher Feldname (`amount` statt `oxamount`) ⇒ 200 mit
  `status: "failed"` + `errors: ["missing oxid or oxamount, …"]`. Der Fehler steckt im **Body** —
  HTTP-Code und Body immer zusammen lesen.
- **Fehlgeschlagene Kandidaten nicht als „still verworfen" deuten.** Wenn keine Wirkung sichtbar ist,
  erst das Message-/Error-Objekt inspizieren; die Ablehnung steht dort meist explizit. Eine frühere
  „stille Verwerfung" in einer Skill-Doku war schlicht ein ungeparster Body.
- **Keine Codes „zur Sicherheit" durchprobieren**, auch nicht aus einer Liste von Fake-Codes, wenn
  das Ziel ist, einen gültigen zu finden. Zwei, drei offensichtliche Fakes zur Verifikation der
  Serverantwort sind Nachweisarbeit; mehr ist Raten.
- **Öffentliche Coupon-Portale sind keine Quelle.** mydealz/Gutscheine-Portale liefern für
  Lieferdienste/Shops selten echte Codes; Scrape-Treffer sind meist Artefakte (Timestamps wie
  `04T21`, IDs wie `010649524Z`). Nur Codes verwenden, die als Angebot ausgeschrieben sind, und
  deren Geltungsbereich prüfen („edeka24"-Codes gehören zu edeka24.de, nicht zum EDEKA-Shop).

## Belegter Fall (als Muster)

EDEKA Abhol-/Lieferservice (Südwest): Korbberechnung `POST /api/v3/basket/calculate` auf dem
Markt-Host mit `{"articles":[{"oxid":…,"oxamount":…}],"vouchers":["CODE"]}`; Ablehnung =
`data.messages.vouchers.ERROR_MESSAGE_VOUCHER_NOVOUCHER`, Codes werden kleingeschrieben, Testkorb
Basis 2,85 €. App-Aktionscodes sind Kleinschreib-Keywords (z. B. `meinfavorit`) und nur in der App
einlösbar. Details, Endpunktliste und Skript-Standorte: Skill `edeka-shop-integration`
(Guide `references/edeka-shop-integration-guide.md`) und Skill `mobile-app-backend-mapping`
(`references/edeka-merkliste-case.md`); funktionierender Prüfer:
`~/workspace/edeka-re/edeka_code_check.py` (read-only, ohne Bestellung).

Versions

The database has no other skills named discount-code-validation.

Database snapshot: 13.11.2026 · package version 7e7d2ecde507 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100acp-discount-extension
    Implement the ACP discount extension — discount codes, applied discounts, rejected codes, and line-item allocations. Use when adding coupon/promo code support to checkout flows.
  • 90woo-pricing-promotions
    Use when the user says 'run a sale', 'discount this category', 'set up a coupon', 'reprice these products', 'end the sale', or asks what a discount would cost them. Plans the price change, shows it as a preview before anything moves, writes it with a snapshot, and can put it back.
  • 100shopify-discount-code-performance
    Use for "are our store discounts worth it", "which discount codes work in our shop", "how much are we giving away in Shopify discounts", "is the welcome code bringing new customers", "how deep are our promo discounts", "do discounted orders have a bigger basket", "what discount…
  • 100discount-leak
    Measures how much revenue discount codes give away, which codes drive it, and which codes look leaked to coupon sites after a sudden spike. Use when margin feels thin despite good sales, after a promotion, or when a private code starts showing up everywhere. Boundary:…
  • 100discount-promo-analyst
    Measures discount codes and sitewide sales from a store's own orders, showing margin given away, who used each code, codes leaked to coupon sites and whether a sale paid, then designs the next offer. Use when asked if discounts are profitable, which promo codes work, or if a code leaked.
  • 90coupon-performance-triage
    Use when the merchant asks whether coupons are working, which coupon codes are performing, whether discounting is eating margin, what a promotion cost, which coupons drive new customers, or which codes need attention. Produces a merchant-friendly WooCommerce coupon performance…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.