رموز القسائم

برنامج القسائم وصفة تُعدّها مرة واحدة - مثلاً "ترحيب 10%: خصم 10%، حد أدنى للإنفاق 50، صالحة 14 يوماً من لحظة الإرسال، استخدام واحد". كلما احتاجت حملة أو رحلة إلى رمز لشخص ما، تُصدر Joryio رمزاً من البرنامج: تُنشئ رمزاً فريداً للاستخدام مرة واحدة في متجر WooCommerce أو Shopify أو Magento أو PrestaShop المتصل وتضعه في الرسالة. وعندما يطلب الشخص به، تتعرّف مزامنة الطلبات على الرمز وتعلّمه كمُستَرَد وتنسب الإيراد إلى الرسالة التي أصدرته.

الرموز مجانية - إصدارها لا يُحتسب في الفاتورة.

إنشاء برنامج

افتح E-Commerce → Coupons واختر New program. اختر صف أي برنامج لفتح تقريره.

الحقل	وظيفته
الاسم	تسمية لفريقك، مثل "ترحيب 10%".
Slug	المعرّف الذي تستخدمه في الرسائل: `{{ coupons.<slug>.code }}`. أحرف لاتينية صغيرة وأرقام وشرطات سفلية؛ يُملأ من الاسم.
المتجر	متجر WooCommerce أو Shopify أو Magento أو PrestaShop المتصل الذي تُنشأ فيه الرموز. أو بلا متجر - تُنشئ Joryio الرموز وتتتبعها، وتطبّقها أنت في صفحة الدفع أو نقطة البيع أو التطبيق الخاص بك. وتُعرف الاستردادات حينها من الطلبات المرسلة عبر Orders API.

يبدأ البرنامج الجديد مسودة. فعّله بزر تفعيل في صفحة البرنامج (أو من قائمة الصف في القائمة)؛ وإيقاف مؤقت يوقفه مجدداً. البرنامج النشط وحده يُصدر رموزاً؛ أما البرامج الموقوفة مؤقتاً والمؤرشفة فلا تُصدر شيئاً، وتتبع الرسالة حينها البديل المحدد في البرنامج.

إعدادات الخصم

الإعداد	الخيارات
نوع الخصم	نسبة مئوية، مبلغ ثابت من السلة، مبلغ ثابت من كل منتج (غير متاح في PrestaShop)، أو شحن مجاني.
المبلغ	النسبة أو المبلغ بعملة المتجر (لا يُستخدم مع الشحن المجاني).
الحد الأدنى للإنفاق	مجموع فرعي اختياري يجب أن يبلغه الطلب.
الحد الأدنى للكمية	اختياري، في Shopify فقط.
ينطبق على	السلة كلها، أو منتجات مختارة (WooCommerce وShopify وPrestaShop)، أو فئات (WooCommerce وMagento وPrestaShop)، أو مجموعات (Shopify). اختيار المنتجات غير متاح في Magento في هذا الإصدار.
استثناء المنتجات المخفّضة	WooCommerce فقط.
عدد الاستخدامات لكل رمز	الافتراضي 1 (استخدام واحد).
مرة واحدة لكل عميل	مفعّل افتراضياً: لا يستطيع العميل استخدام رموز هذا البرنامج مرتين.
انتهاء الصلاحية	بلا، تاريخ ثابت، أو N ساعات / أيام بعد إصدار الرمز - مع خيار التقريب إلى نهاية ذلك اليوم بالمنطقة الزمنية لمساحة العمل.
قابل للدمج	معطّل افتراضياً: لا يمكن استخدام الرمز مع خصومات أخرى.
صيغة الرمز	الطول 6-20، مجموعة الأحرف (أحرف وأرقام بلا أحرف متشابهة مثل 0 وO و1 وI وL - الافتراضي؛ أحرف فقط؛ أرقام فقط)، بادئة (`WELCOME-`)، لاحقة، وفاصل كل N أحرف.
إعادة استخدام رمز الشخص المفتوح	مفعّل افتراضياً: من لا يزال لديه رمز مفتوح (غير مُستَرَد وغير منتهي) من هذا البرنامج يحصل على الرمز نفسه بدلاً من رمز جديد.
قفل الرمز على الشخص	WooCommerce وMagento وPrestaShop - راجع قفل الرمز على الشخص.

لا يُعرض حد أقصى للنسبة ("15%، بحد أقصى 50"): لا يدعمه أي من المتاجر بشكل مدمج.

قفل الرمز على الشخص

افتراضياً كل رمز فريد وللاستخدام مرة واحدة، لذا فالرمز المُعاد توجيهه يكلّف خصماً واحداً على الأكثر. في WooCommerce وMagento وPrestaShop يمكنك أيضاً قفل كل رمز على الشخص الذي أُرسل إليه: يرفضه المتجر لأي شخص آخر.

يستخدم WooCommerce قيد البريد الإلكتروني الخاص بالقسيمة نفسها.
يحتاج Magento إلى إضافة Joryio Connect بالإصدار 1.2.0 أو أحدث، التي تتحقق من الرمز مقابل الشخص عند الدفع. متجر Magento بدونها يحصل على رموز للاستخدام مرة واحدة غير مقفلة، وتُطبَّق صلاحية كل رمز (N ساعات / أيام بعد الإصدار) بحذف Joryio للرمز خلال ساعة من انتهائه - كما في Shopify.
يقفل PrestaShop (وحدة Joryio بالإصدار 1.1.0 أو أحدث) الرمز على حساب العميل الخاص بالشخص في المتجر (عميل قاعدة السلة): عليه تسجيل الدخول لاستخدامه. الشخص الذي ليس لديه حساب مسجّل في المتجر، أو لديه حسابان بالبريد الإلكتروني نفسه، لا يحصل على رمز - يفشل الإصدار ويُطبَّق البديل الخاص بالبرنامج.
Shopify: لا يظهر المفتاح. يحدد Shopify من يمكنه استخدام الخصم على مستوى الخصم كله لا على مستوى الرمز، لذا فكل رمز في Shopify فريد وللاستخدام مرة واحدة، مع استخدام واحد لكل عميل.

رمز شخصي لزائر

الزائر الذي يفتح رابط التطبيق لرمز مقفل يحصل عليه كما يلي:

WooCommerce (إضافة Joryio بالإصدار 1.6.29 أو أحدث): ينتظر الرمز في جلسة المتسوق ويُطبَّق بمجرد معرفة بريده الإلكتروني وكونه البريد الذي أُرسل إليه الرمز - فوراً للعميل المسجّل دخوله، وللزائر عندما يُدخل بريده الإلكتروني عند الدفع (الدفع بالكتل والدفع الكلاسيكي)، وعلى الأكثر عند تقديم الطلب. وحتى ذلك الحين تعرض السلة وصفحة الدفع "Your code ... is personal: it will be applied at checkout when you enter the email address it was sent to." والبريد الآخر يحصل على "The code ... belongs to another customer, so it was not applied" - دون ذكر لمن - ولا خصم؛ وتصحيح البريد يطبّق الرمز. يتحقق WooCommerce من البريد بنفسه عند تطبيق الرمز وعلى الطلب، لذا لا يحصل بريد خاطئ على الخصم أبداً. في الإضافات الأقدم: كان WooCommerce يرفض الرمز ما دام البريد غير معروف ("Please enter a valid email at checkout to use coupon code ...") ولا يحاول مجدداً.
Magento (الإضافة بالإصدار 1.2.0 أو أحدث): يُطبَّق الرمز على سلة الزائر ويظهر خصمه؛ وتتحقق الإضافة منه مقابل البريد عند تقديم الطلب وترفض بريداً آخر ("This coupon code was sent to another customer").
PrestaShop: الرمز يخص حساب عميل، لذا يُطلب من الزائر تسجيل الدخول أولاً ثم يعود إلى السلة مع الرمز.
Shopify: الرموز غير مقفلة، لذا يستخدم الزائر الرمز مثل أي شخص آخر.

عندما يتعذّر إصدار رمز

إذا لم يستطع المتجر إنشاء رمز (لا يستجيب، أو تنقصه صلاحية، أو البرنامج موقوف مؤقتاً)، فإن بديل البرنامج يحدد ما تفعله الرسالة:

البديل	ما يحدث
تخطي الرسالة لهذا الشخص (الافتراضي)	لا تُرسَل الرسالة إلى ذلك الشخص وتُسجَّل كمُتخطّاة بالسبب `coupon_unavailable`.
إرسال رمز بديل مشترك	تُرسَل الرسالة بالرمز المشترك الذي تُدخله (مثل `SORRY10`).
الإرسال بدون القسيمة	تُرسَل الرسالة ويكون `{{ coupons.<slug>.code }}` فارغاً - ضع جزء القسيمة داخل `{% if coupons.<slug>.code != '' %}` لإخفائه.

أما الرسالة المرسلة عبر API المعاملات فتُرفض بدلاً من ذلك: مع التخطي يجيب الطلب بـ 422 مع code: coupon_unavailable والسبب، ولا يُرسَل شيء. لا يمكن بعدُ حجب الرسائل داخل التطبيق ورسائل حملات WhatsApp، لذا فإن التخطي فيها يعمل مثل الإرسال بدون القسيمة: تُرسَل الرسالة برمز فارغ. ضع جزء القسيمة هناك داخل {% if coupons.<slug>.code != '' %}.

مصادر الرموز

لكل برنامج مصدر رموز - من أين تأتي رموزه. تختاره عند إنشاء البرنامج، ولا يمكن تغييره بعد أن يصبح في البرنامج رموز.

المصدر	ما يحدث	الأنسب لـ
شخصي (الافتراضي)	ينشئ Joryio رمزاً فريداً واحداً لكل شخص في متجرك لحظة احتياج الرسالة إليه (أو يولّده بنفسه عندما لا يكون للبرنامج متجر).	المسارات والحملات المُفعَّلة والحملات الصغيرة - الترحيب، أعياد الميلاد، استعادة العملاء.
بنك رموز	ينشئ Joryio رموزاً كثيرة في متجرك مسبقاً ويوزعها، رمزاً واحداً لكل شخص.	الحملات الكبيرة (عشرات الآلاف من الأشخاص)، حيث يكون إنشاء الرموز واحداً تلو الآخر وقت الإرسال بطيئاً جداً.
قائمة مرفوعة	ترفع رموزاً أُنشئت في مكان آخر - نقطة البيع، شريك، متجر أو تطبيق خاص بك، أداة أخرى - ويوزعها Joryio، رمزاً واحداً لكل شخص. لا ينشئها Joryio أبداً في متجر.	رموز لا يستطيع Joryio إنشاءها، ومتاجر لا يتصل بها Joryio.
رمز مشترك	رمز واحد للجميع (`SUMMER10`)، يُنشأ في متجرك أو يُسجَّل فقط. يبقى كل إرسال مسجلاً لكل شخص.	العروض الترويجية للجمهور كله.

أياً كان المصدر، تستخدم الرسالة المتغير نفسه {{ coupons.<slug>.code }}، ولا يحصل الشخص أبداً على رمز البنك أو القائمة نفسه مرتين، ويُظهر الإرسال نفسه دائماً الرمز نفسه.

رفع رموز لمتجر أو تطبيق خاص بك

يعمل برنامج القائمة المرفوعة دون أي متجر متصل - مثل رموز يقبلها نظام نقطة البيع أو تطبيقك - ويعمل أيضاً مع متجر متصل عندما تكون الرموز موجودة فيه أصلاً (فلا ينشئها Joryio مرة أخرى).

أنشئ برنامجاً مصدره قائمة مرفوعة. المتجر اختياري؛ إعدادات الخصم تصف فقط القيمة التي تعرضها الرسالة ({{ coupons.<slug>.value }}).
في البرنامج، اختر رفع الرموز واختر ملف CSV أو الصق الرموز.
راجع المعاينة - يتحقق Joryio من الملف أولاً ويعرض عدد الرموز التي ستُضاف وكل صف مرفوض مع السبب. لا يُحفظ شيء حتى تؤكد.
أكّد. يمكنك رفع مزيد من الرموز إلى البرنامج نفسه في أي وقت؛ وتبقى الرموز السابقة.

الملف:

العمود	إلزامي	الصيغة
`code`	نعم	من 3 إلى 64 حرفاً: أحرف وأرقام و`- _ . # / +`
`expires_at`	لا	`YYYY-MM-DD` (نهاية ذلك اليوم بتوقيت UTC) أو تاريخ ووقت بصيغة ISO. لا يُوزَّع الرمز بعده.
`value`	لا	ما يعرضه `{{ coupons.<slug>.value }}` لهذا الرمز، مثل `10%` أو `قهوة مجانية` - حتى 100 حرف.

صف العناوين اختياري (من دونه تُقرأ الأعمدة بهذا الترتيب)، وتعمل الفواصل والفواصل المنقوطة وعلامات الجدولة كلها. يتسع الملف لـ 100,000 صف و10 MB كحد أقصى؛ قسّم القوائم الأكبر على عدة عمليات رفع. يُرفض الصف عندما يكون الرمز مفقوداً أو غير صالح، أو التاريخ ليس تاريخاً أو قد مضى، أو القيمة طويلة جداً، أو الرمز ظهر سابقاً في الملف، أو الرمز موجود أصلاً في هذا البرنامج أو في برنامج آخر في مساحة العمل (تُطابَق الرموز مع الطلبات بالرمز نفسه، لذا ينتمي كل رمز إلى برنامج واحد فقط). تُقارن الرموز دون تمييز بين الأحرف الكبيرة والصغيرة.

يحصل كل شخص على رمز واحد غير مستخدم، ولا يُعطى الرمز أبداً لشخصين - حتى عندما تخرج رسائل كثيرة في اللحظة نفسها. عندما يصل إلى Joryio طلب يحمل رمزاً مرفوعاً - عبر مزامنة متجر أو عبر Orders API مع الرمز ضمن قسائم الطلب - يُعلَّم الرمز كمُستردّ وتُنسب الإيرادات إلى الرسالة، تماماً كما في الرموز التي ينشئها Joryio.

بنوك الرموز

يحتاج برنامج بنك الرموز إلى متجر متصل. ينشئ Joryio الرموز في المتجر قبل أن يتسلمها أي أحد:

المتجر	كيف تُنشأ الرموز
Shopify	تُضاف إلى الخصم الوحيد للبرنامج، 250 في كل استدعاء.
WooCommerce	قسيمة واحدة لكل رمز، 100 في كل استدعاء.
Magento	تُولَّد ضمن قاعدة سعر السلة الخاصة بالبرنامج. يختار Magento نصوص الرموز بنفسه وفق صيغة رمز البرنامج (الطول، مجموعة الأحرف، البادئة، اللاحقة، الفاصل).
PrestaShop	قاعدة سلة (cart rule) واحدة لكل رمز، استدعاء واحد لكل منها.

توليد الرموز في البرنامج ينشئ رموزاً الآن؛ يعمل في الخلفية، وتعرض صفحة البرنامج التقدم وآخر نتيجة.
الرموز الجاهزة تُبقي البنك بهذا الحجم: كل 15 دقيقة يُكمله Joryio عندما ينخفض عنه.
قبل إرسال حملة، يُكمل Joryio كل بنك يستخدمه المحتوى ليغطي الجمهور، حتى لا ينتظر الإرسال المتجر أبداً. ما يبقى ناقصاً عند بدء الإرسال يتبع البديل الخاص بالبرنامج.
القفل على الشخص (WooCommerce وMagento وPrestaShop) يربط رمز البنك بالشخص لحظة توزيعه.
تغيير خصم بنك فيه رموز يُخرج رموزه غير المستخدمة من الخدمة (تُحذف من المتجر) وتُنشأ الرموز الجديدة وفق القواعد الجديدة.

الرموز المشتركة

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

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

تنبيهات انخفاض المخزون

تعرض بنوك الرموز والقوائم المرفوعة الرموز المتبقية في قائمة البرامج وفي صفحة البرنامج. اضبط التنبيه في البرنامج:

بقي أقل من N رمز (الافتراضي 500)، و/أو
بقي أقل من N% من كل الرموز المُحمَّلة.

عندما ينخفض برنامج نشط عن أي منهما، يظهر التنبيه في جرس الإشعارات وفي صفحة البرنامج؛ ويُغلق من تلقاء نفسه عند إضافة رموز. البرنامج الفارغ يُطلق تنبيهاً حرجاً.

تفحص مراجعة الإطلاق (Launch Review) المخزون أيضاً:

الحملة التي يكون جمهورها أكبر من الرموز المتبقية في قائمة أو بنك تُحظر - ارفع أو ولّد مزيداً من الرموز أولاً.
لا يُحظر المسار إلا عندما تكون القائمة أو البنك فارغاً (فليس للمسار جمهور ثابت).
الإرسال الذي سيترك المخزون دون حد التنبيه يحصل على تحذير.

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

استخدام رمز في رسالة

اكتب متغير البرنامج في أي رسالة - البريد الإلكتروني أو SMS أو الإشعارات أو إشعارات المتصفح أو داخل التطبيق أو WhatsApp أو Viber:

المتغير	القيمة
`{{ coupons.welcome10.code }}`	رمز الشخص، مثل `WELCOME-7KQ4M2XH9P`.
`{{ coupons.welcome10.expires_at }}`	موعد انتهائه كتاريخ ووقت مقروءين: بلغة جهة الاتصال (سمة `locale` لديها، وإلا `language`، وإلا لغة مساحة العمل، وإلا الإنجليزية) وبالمنطقة الزمنية لمساحة العمل. مثلاً `3 نوفمبر 2026 في 6:30 م` لجهة اتصال بالعربية، أو `November 3, 2026 at 6:30 PM` بالإنجليزية. فارغ إذا لم ينتهِ الرمز.
`{{ coupons.welcome10.expires_at_iso }}`	اللحظة نفسها كطابع زمني ISO (`2026-11-03T16:30:55.147Z`)، فارغ إذا لم ينتهِ الرمز. استخدمه لاختيار تنسيقك الخاص بمرشح تاريخ، وهو أيضاً ينسّق بالمنطقة الزمنية لمساحة العمل: `{{ coupons.welcome10.expires_at_iso \| date: "%d/%m/%Y" }}`. مرشح التاريخ المكتوب مسبقاً على `expires_at` يستمر في العمل.
`{{ coupons.welcome10.value }}`	الخصم بالكلمات: `10%`، `5 EUR`، `Free shipping`.
`{{ coupons.welcome10.apply_url }}`	رابط يفتح المتجر والرمز مطبَّق مسبقاً (فارغ إذا لم يكن لدى المتجر رابط كهذا).
`{{ coupons.welcome10.name }}`	اسم البرنامج.

في محرر البريد الإلكتروني، اسحب كتلة Coupon إلى الرسالة واختر البرنامج: تعرض الرمز وتاريخ الانتهاء وزراً إلى رابط التطبيق، وتُخفي نفسها عندما لا يُصدَر رمز.

لا تُصدَر إلا الرموز التي يراها الشخص فعلاً. الرمز داخل فرع {% if %} لا يصل إلى الشخص لا يُنشأ أبداً. الإرسال نفسه يعرض دائماً الرمز نفسه: إعادة المحاولة وإعادة الإرسال والتبديل بين نسخ A/B وبديل SMS كلها تحمل رمزاً واحداً.

المعاينات وإرسالات الاختبار

تعرض المعاينة دائماً رمزاً نموذجياً مثل WELCOME-PREVIEW - مع رابط التطبيق الخاص بالمتجر له في apply_url - ولا تُنشئ رمزاً أبداً. وإرسال الاختبار يعرض النموذج أيضاً، إلا إذا حدّدت Issue a real coupon code (single use, expires in 24 hours) - يظهر المربع فقط عندما يستخدم المحتوى القسائم: عندها تُنشئ Joryio رمزاً حقيقياً - للاستخدام مرة واحدة، صالحاً 24 ساعة، ومعلَّماً كاختبار - لتجربته عند الدفع. يعمل ذلك أيضاً مع برنامج في المسودة. إذا تعذّر إنشاء الرمز - رفضه المتجر، أو كان البرنامج مؤرشفاً أو نفدت رموزه، أو كان البرنامج يقفل الرموز على الشخص وليس لدى المستلم عنوان بريد إلكتروني - لا يُرسَل الاختبار وتعرض النافذة السبب. لا تُحتسب رموز الاختبار في تقرير البرنامج ولا في تبويب القسائم لجهة الاتصال.

في رحلة

أضف خطوة Issue coupon (في مجموعة البيانات في لوحة العُقد) واختر البرنامج. تُصدر الرمز مرة واحدة وتحتفظ به مع الشخص: كل رسالة لاحقة في الرحلة تستخدم {{ coupons.<slug>.code }} تعرض الرمز نفسه - بما في ذلك البريد الإلكتروني وتذكير SMS بعد ثلاثة أيام. للخطوة مخرجان:

Issued - لدى الشخص رمز.
Could not issue - لم يستطع المتجر إنشاء رمز؛ وجّه هؤلاء إلى رسالة بلا قسيمة أو أنهِ الرحلة.

الرسالة التي تستخدم المتغير دون خطوة Issue coupon قبلها تُصدر الرمز بنفسها، والرسائل اللاحقة في الرحلة نفسها تعرض ذلك الرمز. راجع عُقد الكانفس.

الاستردادات والإيرادات

عندما يصل طلب من WooCommerce أو Shopify أو Magento أو PrestaShop (أو عبر Orders API) برمز أصدره برنامج، تعلّم Joryio الرمز مُستَرَداً وتسجّل الطلب وإيراده وتُطلق الحدث Coupon Redeemed. يُحتسب أول طلب بالرمز. وإذا استخدمه شخص غير الذي أُصدر له، يُظهره التقرير على أنه "استرده شخص آخر".

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

انتهاء الصلاحية. عندما تنتهي صلاحية رمز، تعلّمه Joryio منتهياً وتُطلق Coupon Expired وتحذف الرمز من المتجر تلقائياً، حتى لا تمتلئ قائمة خصومات متجرك برموز ميتة. ويبقى السجل في Joryio.

تقرير البرنامج

يعرض كل برنامج الرموز المُصدَرة والمُستَرَدة ونسبة الاسترداد والإيراد من الطلبات التي استخدمت رمزاً وإجمالي الخصم الممنوح والرموز المنتهية والفاشلة والرموز التي استردها شخص آخر، مع تفصيل حسب الحملة والرحلة. لا تُحتسب رموز الاختبار.

يعرض ملف جهة الاتصال رموزها في علامة التبويب Coupons (تحتاج إلى Users (read)): البرنامج والرمز والحالة (مفتوح، مُستَرَد، منتهٍ) والرسالة التي أصدرته والتواريخ.

الأحداث

الحدث	متى	الخصائص
`Coupon Issued`	أُصدر رمز للشخص.	`program`، `program_id`، `campaign_id`، `canvas_id`، `node_id`، `source`، `expires_at`
`Coupon Redeemed`	استخدم طلبٌ الرمز.	`program`، `program_id`، `campaign_id`، `canvas_id`، `order_id`، `revenue`، `redeemed_by_someone_else`
`Coupon Expired`	انتهت صلاحية الرمز دون استخدام.	`program`، `program_id`، `campaign_id`، `canvas_id`، `expires_at`

الرمز نفسه لا يوجد أبداً على أي حدث: الرمز يساوي مالاً لمن يحمله.

إعداد المتجر

المتجر	ما تفعله مرة واحدة
Shopify	افتح Integrations → Shopify واختر Approve new permissions. تحتاج القسائم إلى صلاحية الخصومات في Shopify (`write_discounts`)؛ المتاجر المتصلة قبل إضافتها توافق عليها مرة واحدة.
WooCommerce	لا شيء لإصدار الرموز - اتصال الإضافة يسمح بذلك بالفعل. رابط التطبيق (`apply_url`) يحتاج إلى إضافة Joryio بالإصدار 1.4.0 أو أحدث.
Magento	رقِّ إضافة Joryio Connect إلى الإصدار 1.2.0 أو أحدث. تمنح الترقية التكامل صلاحية قواعد أسعار السلة (`Magento_SalesRule::quote`) اللازمة لإنشاء الرموز، وتضيف القفل على الشخص.
PrestaShop	ثبّت وحدة Joryio أو رقّها إلى الإصدار 1.1.0 أو أحدث. تتيح الترقية لمفتاح Webservice الخاص بالوحدة إدارة قواعد السلة (ولا شيء غيرها)، وتطبّق اختيار المنتجات أو الفئات، وتضيف رابط التطبيق. راجع برامج القسائم في PrestaShop.

في Shopify يكلّف كل رمز استدعاءً واحداً للمتجر، وخطة Shopify القياسية تسمح بنحو 10 في الثانية، لذا قد تستغرق حملة لجمهور كبير جداً بعض الوقت لتجهيز رموزها. للحملة الكبيرة، استخدم بنك رموز: تُنشأ رموزه في المتجر قبل الإرسال.

في لوحة إدارة Shopify، تقع كل رموز البرنامج تحت خصم واحد بعنوان Joryio - <اسم البرنامج> (<slug> v<n>). تغيير قواعد برنامج فعّال يُنشئ خصماً جديداً (الإصدار التالي) للرموز الجديدة؛ وتبقى الرموز المُصدرة سابقاً على الخصم القديم. يحتفظ Shopify بتاريخ انتهاء واحد لكل خصم، لذا تُطبَّق صلاحية كل رمز (N ساعات / أيام بعد الإصدار) بحذف Joryio للرمز خلال ساعة من انتهائه.

الصلاحيات والخصوصية

Campaigns (write) تُنشئ البرامج. تغيير برنامج فعّال - أي برنامج أصدر رموزاً بالفعل - يحتاج إلى Settings (write)؛ والرموز المُصدرة سابقاً تحتفظ بالقواعد التي أُنشئت بها.
عرض رموز جهة اتصال يحتاج إلى Users (read).
مساحات العرض التجريبي (sandbox) لا تُنشئ أبداً قسائم حقيقية في متجر حقيقي.
محو شخص (GDPR) يحذف رموزه في Joryio ويزيل رموزه المفتوحة من المتجر.

إنشاء برنامج​

إعدادات الخصم​

قفل الرمز على الشخص​

رمز شخصي لزائر​

عندما يتعذّر إصدار رمز​

مصادر الرموز​

رفع رموز لمتجر أو تطبيق خاص بك​

بنوك الرموز​

الرموز المشتركة​

تنبيهات انخفاض المخزون​

استخدام رمز في رسالة​

المعاينات وإرسالات الاختبار​

في رحلة​

الاستردادات والإيرادات​

تقرير البرنامج​

الأحداث​

إعداد المتجر​

الصلاحيات والخصوصية​

ذو صلة​