Couponcodes

Sie können eindeutige Gutscheincodes generieren, wenn Sie einen Gutschein definieren. Die Gutscheincodes können aus einem externen System importiert und in ein externes System exportiert werden. Die Gutscheincodes können optional einzelnen Kunden zugeordnet werden.

Zum Generieren eindeutiger Gutscheincodes müssen Sie die Zeichensätze zusammen mit dem Format definieren. Nachdem Sie die Zeichensätze definiert haben, müssen Sie sie einer einzelnen Zeichenabkürzung zuordnen. Diese Abkürzung wird (für jede Zeichenposition im generierten Gutscheincode) verwendet, wenn das Format der Codes definiert wird, die als Teil einer Gutscheindefinition generiert werden. Diese Zeichensätze können jeder Position der generierten Zeichenfolge zugeordnet werden.

Beispiele für Zeichensätze:
  • ABC → a
  • ABCXYZ → A
  • '-'-'-'-'-'-'-'-'
  • 1234567890 → d
  • aA1bB2cC3 → m

Außerdem müssen Sie die Couponrichtlinie definieren. Die Gutscheinrichtlinie definiert die Länge des Gutscheincodes, an welcher Position und wie viele Zeichen der Gutschein-ID Teil des generierten Gutscheincodes sein müssen. Pro Preisermittlungsorganisation muss eine Gutscheinrichtlinie vorhanden sein.

Nachdem Sie die Zeichensätze und die Gutscheinrichtlinie definiert haben, können Sie Gutscheincodes zur einmaligen Verwendung für jede Gutscheindefinition generieren. Die wichtigsten Komponenten der Gutscheincodedefinition sind:
  • Anzahl der zu generierenden eindeutigen Gutscheincodes.
  • Format der zu generierenden Gutscheincodes.
  • CouponID Präfix-Die ersten N Zeichen von CouponID sind im generierten Gutscheincode enthalten. Die CouponID kann als Präfix, Suffix oder an einer definierten Position in der Codezeichenfolge eingefügt werden.
Dabei bezieht sich CouponID auf die ID einer vorhandenen Coupondefinition.

Beispiel: DADD-xxxx-MMMMM ist ein generierter Gutscheincode, wobei D, A, x, M Zeichensatzabkürzungen für jede Position sind. Jede Position im generierten Gutscheincode kann mit einem Zeichen angegeben werden, das einen Zeichensatz darstellt. Mit der Anwendung werden einige Beispielzeichensätze bereitgestellt. Administratoren können auch eigene Zeichensätze definieren.

Die vollständige Codezeichenfolge im generierten Gutscheincode ist eine Kombination aus CouponID und der Zeichenfolge CodeFormat . Wenn die Couponrichtlinie beispielsweise definiert, dass die ersten vier Zeichen der CouponID verwendet werden müssen und die CouponID eine Position 0 mit einem CodeFormat von ' DDD-XXX' und einem CouponID=Coupon1eingefügt wird, werden die folgenden Coupons generiert: Coup393-HKE, Coup839-UDK und Coup424-HWC.

Anmerkung : Die Anwendung behält die Logik bei, um die angegebene Anzahl eindeutiger Gutscheincodes zu generieren. Tatsächliche Gutscheinodes werden nur generiert, wenn eine Anforderung zum Exportieren oder Validieren eines Gutscheins vorliegt.

Eindeutige Gutscheincodes werden generiert und in einer temporären CSV-Datei zum Exportieren gespeichert. Sobald ein Gutschein eingerichtet ist, kann die Anwendung anhand eines beliebigen eindeutigen Gutscheincodes prüfen, ob er unter die aktuelle Gutscheindefinition fällt oder nicht.

Eingelöste Gutscheine werden in der Rabattnutzung gespeichert, sodass sie validiert werden können, wenn der Benutzer versucht, sie erneut zu verwenden.

Weitere Informationen zum Implementieren von Gutscheincodes finden Sie im Javadoc.

Validierung des Gutscheincodes

Die API validateCoupon akzeptiert mehrere Couponcodes für eine zu validierende Coupondefinition. Gutscheincodes werden als Referenzen übergeben. Referenzen können extern oder intern sein. Diese Referenzen werden anhand generierter oder importierter Gutscheincodes validiert, wenn ValidateReferences als Y übergeben wird. CouponID wird aus der ersten Referenz in der Eingabe abgeleitet.

Wenn bereits ein eindeutiger Gutscheincode verwendet wird, wird die diesem Gutscheincode zugeordnete Referenz ungültig. Wenn die Gutscheincodes importiert oder Kunden zugewiesen werden, wird der Gutscheincode anhand von YPM_COUPON_CODE validiert. Andernfalls wird der Gutscheincode anhand der Logik zur Gutscheincodegenerierung validiert.
Hinweis: Die Anwendung lässt nicht zu, dass interne und externe Referenzen Teil derselben CouponIDsind.