クーポン・コード

クーポンの定義の一部として、固有のクーポン・コードを生成できます。クーポン・コードは、外部システムからインポートすることも、外部システムにエクスポートすることもできます。クーポン・コードは、オプションで個々の顧客に割り当てることができます。

固有のクーポン・コードを生成するには、フォーマットとともに文字セットを定義する必要があります。文字セットを定義した後、それらを単一文字の省略形に割り当てる必要があります。この省略形は、クーポン定義の一部として生成するコードのフォーマットを定義する際に (生成されるクーポン・コード内の各文字位置に対して) 使用されます。これらの文字セットは、生成されるストリングの各位置に割り当てることができます。

文字セットの例を以下に示します。

ABC → A
「ABCXYZ」→「A」
双医国宝化 → c
1234567890 → d
aA1bB2cC3 → m

さらに、クーポン・ポリシーも定義する必要があります。クーポン・ポリシーは、クーポン・コードの長さ、生成されるクーポン・コードに含める必要があるクーポン ID の位置と文字数を定義します。価格設定組織ごとに 1 つのクーポン・ポリシーが必要です。

文字セットおよびクーポン・ポリシーを定義した後、任意のクーポン定義に対して単一使用クーポン・コードを生成できます。クーポン・コード定義の主要コンポーネントは以下のとおりです。

生成する固有のクーポン・コードの数。
生成するクーポン・コードのフォーマット。
CouponID 接頭部- CouponID の最初の N 文字は、生成されるクーポン・コードの一部として含まれます。 CouponID は、接頭部または接尾部として表示することも、コード・ストリング内の定義された位置に挿入することもできます。

ここで、 CouponID は、既存のクーポン定義の ID を指します。

例えば、DADD-xxxx-MMMMM は生成されたクーポン・コードです。ここで、D、A、x、M は各位置の文字セットの省略形です。生成されたクーポン・コード内の各位置は、文字セットを表す文字を使用して指定できます。アプリケーションには、いくつかのサンプル文字セットが用意されています。管理者は、独自の文字セットを定義することもできます。

生成されるクーポン・コードの完全なコード・ストリングは、 CouponID と CodeFormat ストリングの組み合わせです。例えば、クーポン・ポリシーで CouponID の最初の 4 文字を使用する必要があることが定義されており、 CouponID に位置 0 を挿入する必要があるとします。 CodeFormat が「DDD-XXX」で CouponID=Coupon1の場合、生成されるクーポン・コードは次のとおりです: Coup393-HKE。

注: アプリケーションは、指定された数の固有クーポン・コードを生成するロジックを保持します。実際のクーポン・コードは、クーポンをエクスポートまたは検証する要求がある場合にのみ生成されます。

固有のクーポン・コードが生成され、エクスポートする一時 CSV ファイルに保管されます。クーポンがセットアップされると、アプリケーションは、現在のクーポン定義に該当するかどうかに関係なく、特定の固有のクーポン・コードから検証できます。

引き換えられたクーポンは、ユーザーが再度使用しようとしたときに検証できるように、プロモーション使用に保管されます。

クーポン・コードの実装について詳しくは、 Javadocを参照してください。

クーポン・コード検証

validateCoupon API は、検証するクーポン定義に対して複数のクーポン・コードを受け入れます。クーポン・コードは参照として渡されます。参照は外部または内部にすることができます。これらの参照は、 ValidateReferences が Y として渡されると、生成されたクーポン・コードまたはインポートされたクーポン・コードに対して検証されます。 CouponID は、入力の最初の参照から派生します。

固有のクーポン・コードが既に使用されている場合、そのクーポン・コードに関連付けられた参照は無効になります。クーポン・コードが顧客にインポートまたは割り当てられている場合、そのクーポン・コードは YPM_COUPON_CODE に対して検証されます。それ以外の場合、クーポン・コードは、クーポン・コード生成ロジックに照らして検証されます。

注: アプリケーションでは、内部参照と外部参照の両方を同じ CouponIDの一部にすることはできません。