الكوبونات وأكواد الترويج

عرّف خصمًا، اربط بيه أكواد ترويج بيشوفها العميل، واقرا إيه اللي اتسدّد فين.

الـ CouponAPI هو خصم قابل لإعادة الاستخدام بتعرّفه مرة واحدة وتطبّقه وقت الدفع. والـ Promotion codeAPI هو النص اللي بيشوفه العميل وبتديهوله علشان يستخدم الكوبون ("FRIENDS20"). الكوبون الواحد يقدر يشيل كذا كود ترويج، كل واحد بقيوده الخاصة، فتقدر تشغّل كذا عرض من نفس الخصم الأساسي.

الصفحة دي بتشرح إزاي تلاقي كوبون، وإزاي تعمل واحد، وإزاي تربط بيه أكواد ترويج، وإيه اللي تقدر وماتقدرش تغيّره بعد ما الكوبون يبقى شغّال.

الكوبونات في مقابل أكواد الترويج

دول حاجتين مختلفتين رغم إن أغلب التجّار بيستخدموهم مع بعض.

المفهوم	يعني إيه	بتظبّط فيه إيه
الكوبون	الخصم نفسه: قد إيه الخصم، وبيستمر قد إيه، وممكن يتسدّد كام مرة إجمالًا.	نوع الخصم وقيمته، والمدة، وحدود الاستخدام، والحد الأدنى لقيمة الطلب، وسقف أقصى للخصم، والمنتجات اللي بينطبق عليها.
كود الترويج	نص بيشوفه العميل وبيشاور على كوبون. كذا كود يقدروا يشاوروا على نفس الكوبون بقيود مختلفة.	نص الكود، وقيد المعاملة لأول مرة، وقيد العميل، وحد الاستخدام للكود الواحد، وتاريخ الانتهاء، والحد الأدنى للمبلغ.

التاجر اللي عايز "خصم 20% على كل حاجة طول الصيف" بيعمل كوبون واحد وكود ترويج أو أكتر بيشاوروا عليه. الكوبون بيحدد الـ 20%؛ والأكواد ("SUMMER20"، "FRIENDS20") هي اللي العملاء بيكتبوها فعلًا وقت الدفع.

تقدر تعمل كوبون من غير أي كود ترويج (وتطبّقه برمجيًا عن طريق الـ API)، لكن علشان أكواد بيكتبها العملاء وقت الدفع، محتاج كود ترويج واحد على الأقل.

تقدر تعمل إيه

شغّل خصومات بنسبة أو بمبلغ ثابت

اختار خصم بالنسبة المئوية أو خصم بمبلغ ثابت، مع سقوف اختيارية وقواعد للحد الأدنى للطلب.

اربط أكواد بيشوفها العميل

الكوبون الواحد يقدر يشيل كذا كود ترويج، كل واحد بتاريخ انتهائه، وقيد العميل، وحد الاستخدام الخاص بيه.

قيّد حسب المنتج أو العميل

طبّق كوبون على منتجات معيّنة في كتالوجك. قيّد كود ترويج واحد لعميل واحد أو للعملاء الجداد بس.

أرشف لما تخلص

عطّل كوبون أو كود ترويج علشان توقف استخدامه. بيانات الاستخدام التاريخية بتفضل موجودة زي ما هي.

دوّر على كوبون

اضغط الكوبونات في القائمة الجانبية بلوحة التحكم (تحت الدفع). القائمة بتعرض كل كوبون على حسابك.

العمود	بيعرض إيه
الكوبون	اسم الكوبون، أو معرّفه لو ماحطّتش له اسم.
الشروط	الخصم ملخّص بلغة بسيطة: "خصم 20% دائم"، "خصم 100 EGP مرة واحدة"، "خصم 15% لمدة 3 شهور".
الاستخدامات	عدد المرات اللي اتسدّد فيها الكوبون. بيعرض `X/Y` لما يكون فيه حد أقصى متظبط، و`X` بس لو مفيش.
تاريخ الانتهاء	تاريخ آخر يوم للاستخدام، أو `-` لو مفيش تاريخ انتهاء.
الحالة	شارة مشتقّة من `active` و`redeemBy`.

اضغط على أي صف علشان تفتح صفحة تفاصيل الكوبون.

اعمل كوبون

اضغط إنشاء كوبون فوق على اليمين. هتفتح شاشة جديدة فيها قسمين: تفاصيل الكوبون وحدود الاستخدام، وكمان بلوك أكواد الترويج تحت.

(اختياري) سمّي الكوبون

ادخّل الاسم. الاسم بيظهر على إيصالات وفواتير العملاء، وعلى صف الكوبون في لوحة التحكم. لو سيبته، الكوبون بيظهر باسم "كوبون بدون اسم".

اختار نوع الخصم

اختار خصم بالنسبة المئوية أو خصم بمبلغ ثابت.

خصم بالنسبة المئوية بيطلب نسبة بين 1 و100. وتقدر اختياريًا تعلّم على تحديد الحد الأقصى لقيمة الخصم علشان تحط سقف على المبلغ اللي النسبة تقدر تخصمه (مثلًا خصم 20%، بس مايزيدش عن 100 EGP).
خصم بمبلغ ثابت بيطلب مبلغ وعملة. العملاء بيدفعوا السعر الكامل ناقص المبلغ ده.

(اختياري) طبّق على منتجات معيّنة

علّم على تطبيق على منتجات محددة علشان تقصر الكوبون على جزء من كتالوجك. هيظهرلك صندوق بحث واختيار تقدر تختار منه من منتجاتك الموجودة. سيب الصندوق من غير علامة علشان تطبّق الكوبون على كل المنتجات.

حدد المدة

اختار الخصم بيستمر قد إيه بعد ما يتسدّد:

المدة	بتعمل إيه
دائم	الخصم بيستمر طول ما الكوبون نشط.
مرة واحدة	الخصم بينطبق على دفعة واحدة، وبعدين يوقف.
عدة شهور	للاشتراكات، الخصم بينطبق لمدة N شهر من وقت الاستخدام، وبعدين يوقف.

تلميح لوحة التحكم تحت بيقول: "للاشتراكات، ده بيحدد الكوبون ده هيستمر قد إيه بعد ما يتسدّد." الاشتراكات لسه ماطُرحتش، فدلوقتي المدة بتهم أكتر حاجة للمشتريات اللي بتتدفع مرة واحدة.

(اختياري) ظبّط حدود الاستخدام

تحت حدود الاستخدام، فيه أربع حقول كل واحد فيهم بـ checkbox بتتحكم في إمتى وكام مرة يتستخدم الكوبون:

الحقل	بيعمل إيه
تحديد الفترة الزمنية لاستخدام الكوبون	تاريخ صالح حتى، وبعده مايتسمحش بأي استخدام جديد.
تحديد الحد الأقصى لعدد مرات استخدام الكوبون	سقف إجمالي على كل العملاء. الكوبون بيوقف لما يوصل السقف.
تحديد الحد الأقصى لعدد مرات استخدام كل عميل للكوبون	سقف لكل عميل. كل عميل يقدر يسدّد لغاية N مرة، والإجمالي لسه يقدر يزيد.
تحديد الحد الأدنى لقيمة الطلب	حد أدنى لإجمالي الطلب. الطلبات اللي تحته مايقدروش يستخدموا الكوبون.

(اختياري) ضيف أكواد ترويج من نفس المكان

بلوك أكواد الترويج تحت بيخليك تضيف كود أو أكتر بيشوفهم العميل وانت بتعمل الكوبون. اضغط إضافة كود آخر علشان تضيف أكتر.

لكل كود:

الكود (اختياري). النص اللي العملاء بيكتبوه وقت الدفع. الأكواد مش حساسة لحالة الحروف ولازم تكون فريدة على مستوى كل أكواد الترويج في حسابك. سيبه فاضي علشان يتولّد واحد تلقائيًا.
صالح للطلب الأول فقط. بيقصر الكود على العملاء اللي ماخلّصوش أي عمليات دفع قبل كده.
تقييد لعميل محدد. دوّر على عميل وهو بس اللي يقدر يستخدم الكود ده.
تحديد عدد مرات استخدام هذا الكود. سقف استخدام للكود الواحد، منفصل عن السقف الإجمالي للكوبون.
إضافة تاريخ انتهاء. تاريخ بعده مايتسمحش باستخدام الكود.
تحديد الحد الأدنى لقيمة الطلب. حد أدنى للكود الواحد، منفصل عن الحد الأدنى الإجمالي للكوبون.

وتقدر كمان تتخطى ده وتضيف الأكواد بعدين من صفحة تفاصيل الكوبون.

اضغط إنشاء كوبون

فوق على اليمين، اضغط إنشاء كوبون. الكوبون بيتعمل، وكل كود ترويج ضايفه بيتعمل عليه، وهتروح على صفحة تفاصيل الكوبون. ويظهر تنبيه "تم إنشاء الكوبون بنجاح" للتأكيد.

لو فيه كود ترويج فشل في الإنشاء (مثلًا، نص الكود كان مستخدم قبل كده)، لوحة التحكم بتظهر تنبيه تحذير بأسماء الأكواد اللي فشلت؛ والكوبون نفسه بيتعمل عادي.

اقرا كوبون

صفحة التفاصيل مقسومة لهيدر، وشريط ملخّص من ثلاث خانات، وشبكة تفاصيل، والمنتجات المطبّق عليها (لما يكونوا متظبطين)، وجدول أكواد الترويج، وقائمة معاملات تحت.

الهيدر

اسم الكوبون (أو "كوبون بدون اسم") بيكون فوق مع شارة الحالة. وزرارين للإجراءات:

إعادة تسمية الكوبون بيفتح لوحة لتحديث الاسم.
تغيير الحالة بيخليك تقلب active بين نشط وغير نشط. الكوبونات غير النشطة مايتسدّدوش.

شريط الملخّص

تلات خانات على عرض أول الجزء الأساسي:

النوع. خصم بالنسبة المئوية أو خصم بمبلغ ثابت.
الشروط. نفس الملخّص باللغة البسيطة زي القائمة: "خصم 20% دائم".
الاستخدام. عدد مرات الاستخدام، مع السقف الإجمالي لما يكون متظبط.

التفاصيل

شبكة من عمودين بتسرد كل حقل على الكوبون:

الحقل	بيعرض إيه
المعرف	معرّف `coupon_*`، مع نسخ بضغطة واحدة.
صالح	نعم لو الكوبون يقدر يتسدّد دلوقتي. لا لو غير نشط، أو منتهي، أو خلصت مرات استخدامه.
الاسم	الاسم الظاهر.
نسبة الخصم / قيمة الخصم	الخصم بالظبط.
تاريخ الإنشاء	إمتى اتعمل الكوبون.
المدة	دائم، أو مرة واحدة، أو N شهور.
صالح حتى	تاريخ الانتهاء، لما يكون متظبط.
الحد الأقصى للاستخدام	غير محدود أو N مرات.
الحد لكل عميل	N مرات لما يكون متظبط.
الحد الأدنى للطلب	الحد الأدنى لقيمة الطلب لما يكون متظبط.
الحد الأقصى للخصم	سقف الخصومات بالنسبة لما يكون متظبط.
يطبق على	جميع المنتجات أو N منتجات.

المنتجات المطبّق عليها

لما تكون قصرت الكوبون على منتجات معيّنة، قسم المنتجات المطبقة بيسرد كل منتج بصورته واسمه. اضغط على أي واحد علشان تفتحه في الكتالوج.

أكواد الترويج

جدول بكل كود بيشوفه العميل ومربوط بالكوبون ده. كل صف بيعرض الكود، ومعرف API، وعدد مرات الاستخدام، وتاريخ الانتهاء، وتاريخ الإنشاء.

زرار + بيفتح لوحة لإضافة كود جديد. وقائمة الإجراءات على كل صف بتخليك أرشفة كود الترويج أو إلغاء أرشفة كود الترويج (ماتقدرش تحذف كود، بس تعطّله).

المعاملات

كل دفعة ناجحة استخدمت الكوبون ده. اضغط على أي صف علشان تفتح تفاصيل الدفعة.

ضيف كود ترويج بعدين

افتح الكوبون، انزل لـ أكواد الترويج، اضغط زرار +. هتظهر نفس حقول نموذج الإنشاء من نفس المكان: الكود، ومعاملة أول مرة، وقيد العميل، وأقصى عدد استخدام، وتاريخ الانتهاء، والحد الأدنى للمبلغ.

العملاء بيستخدموا أكواد الترويج وقت الدفع لما تكون فعّلت السماح برموز الترويج على جلسة الدفع أو رابط الدفع. العميل بيشوف خيار "أضف كود الخصم" في صفحة الدفع؛ ولو الكود صالح ليه، الخصم بينطبق قبل الدفع.

إيه اللي تقدر تغيّره بعدين

بمجرد ما الكوبون يتعمل، شروط الخصم بتتقفل. ماتقدرش تعدّل أي حاجة من دول:

نوع الخصم (نسبة في مقابل مبلغ ثابت)
نسبة الخصم أو قيمة الخصم
العملة
المدة (دائم، أو مرة واحدة، أو N شهر)

الحقول الوحيدة اللي تقدر تغيّرها على كوبون شغّال هي:

الاسم (عن طريق إعادة تسمية الكوبون).
نشط (عن طريق تغيير الحالة، للتعطيل أو إعادة التفعيل).

علشان تغيّر قيمة الخصم أو مدته، عطّل الكوبون القديم واعمل واحد جديد. الاستخدامات التاريخية بتفضل مربوطة بالكوبون القديم للتقارير.

ولأكواد الترويج، نفس القاعدة بتسري: بمجرد ما يتعمل الكود، علامة نشط بس هي اللي تقدر تتغيّر. الكود، وقيد العميل، وحد الاستخدام، وتاريخ الانتهاء، والحد الأدنى للمبلغ كلهم بيتقفلوا. اعمل كود جديد لو محتاج شروط مختلفة.