تخطَّ إلى المحتوى
Aidiدليل أيدي لنقاط البيع

مرجع العروض والكوبونات

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

الحقول

Section titled “الحقول”

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

رأس الصفحة ووضعها

الحقلالمعنى
عرض جديدالإجراء الرئيسي في رأس الصفحة. يفتح وضع الإدارة على قسم مسودات العروض. لا يظهر إلا لحساب يملك صلاحية إدارة العروض promotions-manage.
نظرة عامة / الإدارةمفتاح وضع الصفحة. النظرة العامة تعرض التقرير: الشريط والبطاقات والجدول واللوحة الجانبية. الإدارة تعرض أقسام العروض المنشورة والكوبونات والمسودات. يُحفظ الوضع والقسم في عنوان الصفحة فتعود إليهما عند التحديث.
صلاحية مطلوبةتنبيه يظهر بدل المحتوى كله عندما لا يملك الحساب أي صلاحية قراءة: العروض تحتاج view_report أو promotions-manage، والكوبونات تحتاج view_report أو coupons-manage أو pos.sell.
تم الحفظإشعار يظهر بعد إيقاف عرض أو إيقاف كوبون مؤقتًا أو استئنافه بنجاح. يختفي عند بدء إجراء جديد.

شريط البيانات

الحقلالمعنى
البيانات حتىنهاية نافذة تقرير الإسناد كما أعادها الخادم. النافذة ثابتة على آخر ٣٠ يومًا حتى اليوم ولا تتبع فترة الشريط العلوي. إذا لم يُحمَّل التقرير يُكتب «لم يُرسل الخادم طابعًا» بدل اختراع وقت. يظهر الشريط لمن يملك صلاحية view_report فقط.
أساس الإسنادالأساس الذي حسب الخادم عليه الإسناد، معروضًا كمعرّف لاتيني كما أرسله. يُقرأ من أثر الحساب المخزَّن على الطلبات المدفوعة.

بطاقات النظرة العامة

الحقلالمعنى
نشطعدد نسخ القواعد المنشورة بحالة «نشط» في الصفحة المحمَّلة من قائمة العروض بعد تطبيق مرشحات الإدارة. الملاحظة تحتها «نسخ قواعد منشورة». يُحسب على الصفحة المعروضة لا على كل العروض.
مرات الاستخدامعدد مرات تطبيق العروض في نافذة تقرير الإسناد. الملاحظة «في الفترة» تعني نافذة الإسناد. تُعرض شرطة (—) حتى يُحمَّل التقرير أو عندما لا يملك الحساب صلاحية view_report.
المبيعات المنسوبةإجمالي مبيعات الطلبات المدفوعة التي مسّها عرض في نافذة الإسناد. لا يُنسب لعرض بيعٌ لم يظهر في أثر حسابه. شرطة (—) قبل تحميل التقرير.
قيمة الخصممجموع الخصم الذي منحته العروض على الطلبات المدفوعة في نافذة الإسناد. شرطة (—) قبل تحميل التقرير.
أكواد كوبونات فعّالةعدد الكوبونات بحالة «نشط» في الصفحة المحمَّلة من قائمة الكوبونات، وتحته حتى ثلاثة رموز منها. شرطة (—) عندما لا يوجد رمز نشط أو عندما لا يملك الحساب صلاحية قراءة الكوبونات.

جدول العروض المنشورة

الحقلالمعنى
العرضاسم العرض بلغة الواجهة، وتحته ملخصه إن وُجد أو شرطة (—). كل صف نسخة ثابتة من قاعدة منشورة.
المحفّزمعرّف القاعدة rule_id ثم رقم النسخة (مثل v2) والفرع الذي تنطبق عليه؛ «كل الفروع المسندة» عندما لا تحمل النسخة فرعًا بعينه. المعرّفات لاتينية.
الاستخدامعدد الطلبات المدفوعة المنسوبة إلى هذه القاعدة في تقرير الإسناد. شرطة (—) إذا لم يُنسب إليها طلب أو لم يُحمَّل التقرير؛ النسخة المنشورة لا تحمل عدّادًا خاصًا بها.
قيمة الخصم (عمود)الخصم الذي منحته هذه القاعدة في نافذة الإسناد. شرطة (—) بلا إسناد.
الحالةمجدول أو نشط أو مغلق، وتحتها نافذة السريان من — إلى. المجدول لم يبدأ بعد، والمغلق أُوقف ولن يُطبَّق على طلبات جديدة.
إيقاف العرضزر في آخر عمود يفتح حوار إيقاف النسخة. يظهر العمود لحامل صلاحية promotions-manage فقط، ولا يظهر الزر لنسخة مغلقة أصلًا. بدون الصلاحية يُكتب أسفل الجدول أن العرض للقراءة فقط.
السابق / التاليالتنقل بين صفحات الجدول، ٥٠ صفًا في الصفحة، مع رقم الصفحة الحالية. يتعطل «التالي» عندما لا يعيد الخادم مؤشر صفحة أخرى.

العروض المستهدَفة بمجموعة

الحقلالمعنى
العرضاسم القاعدة المنشورة التي تحمل شرط مجموعة عملاء، وتحته rule_id. لا يُعرض الجدول إلا للقواعد التي تقصر نفسها على مجموعة؛ عند غيابها تُكتب رسالة تدعو إلى إضافة الجمهور من محرر المسودة.
الجمهورمفاتيح المجموعات التي يستهدفها العرض، لاتينية. تحتها إما «مجموعة واحدة: الخصم أدناه هو ما ذهب إلى أعضائها» أو «أكثر من مجموعة: الخصم يخص اتحادها ولا يقبل التوزيع بينها».
الطلبات / الخصم / المبيعات / مرات التطبيقأرقام هذه القاعدة من تقرير الإسناد نفسه: عدد الطلبات المدفوعة المنسوبة، والخصم الممنوح، والمبيعات المنسوبة، وعدد مرات التطبيق. عندما لا يُنسب طلب في النافذة يُكتب «لا طلبات مسنَدة» وتُملأ بقية الأعمدة بشرطات.
أساس الإسناد · النافذة والفرعسطر أسفل الجدول يعيد أساس الإسناد ويذكّر بأن النافذة والفرع هما ما اختير أعلى الصفحة في مرشحات الإدارة.

الخصم حسب المجموعة

الحقلالمعنى
صف المجموعةاسم المجموعة ومفتاحها اللاتيني، ثم عدد الطلبات وعدد العملاء، وشريط نسبي وقيمة الخصم المنسوبة إليها. يُحتسب الطلب في كل مجموعة استهدفها المشتري فعلًا، فالصفوف متداخلة ولا تُجمع.
الإجمالي، محتسَبًا مرة واحدةسطر الإجمالي الذي أعاده الخادم محسوبًا على الطلبات المميزة: عدد الطلبات والعملاء والمبيعات، والخصم الكلي. هذا هو الرقم الذي يُقرأ لا مجموع الصفوف.
خصم غير منسوبيظهر عندما يوجد خصم من قاعدة مستهدِفة لم يعد مشتريها ضمن أي من مجموعاتها اليوم، مع قيمته وعدد طلباته. تُقرأ العضوية كما هي الآن لا كما كانت وقت التسعير.
حالة غير متاحةتحل البطاقة بحالة غير متاحة محل التقسيم في أربع حالات: خطة لا تشمل مفتاح analytics.basic، أو حساب بلا صلاحية view_report لأن عضوية المجموعة بيانات عملاء، أو أثناء التحميل، أو عند فشل القراءة.

اللوحة الجانبية

الحقلالمعنى
المراجعة قبل النشربطاقة تذكّر بأن مراجعًا غير المؤلف يجب أن يعتمد المسودة قبل النشر. تعرض حتى ثلاثة رموز كوبونات مع مبيعاتها المنسوبة من التقرير، وزر «مراجعة ونشر» الذي يفتح قسم المسودات لحامل صلاحية promotions-manage فقط.
المبيعات الإضافيةبطاقة «غير متاحة» تظهر عندما يقول التقرير إن الزيادة السببية لا يمكن قياسها لعدم وجود مجموعة ضبط أو توزيع تجربة، مع سبب الخادم كمعرّف لاتيني. لا يُعرض رقم مُقدَّر مكانها.
الإسناد يُقرأ لا يُقدَّرملاحظة ثابتة: الخصم الذي حصل عليه الطلب مخزَّن عليه، ولا يُنسب لعرض بيعٌ لم يمسّه.

وضع الإدارة: الأقسام والمرشحات

الحقلالمعنى
العروض المنشورة / الكوبونات / مسودات العروضأقسام وضع الإدارة مع عدد الصفوف المحمَّلة بجانب الأولين. يظهر كل قسم بحسب الصلاحية: العروض المنشورة لمن يقرأ العروض، الكوبونات لمن يقرأ الكوبونات، والمسودات لحامل promotions-manage فقط.
الفرعمرشح قائمة العروض المنشورة وتقرير الإسناد معًا: «كل الفروع المسندة» أو فرع واحد من فروع الحساب. يعيد ترشيحه الصفحة إلى بدايتها.
الحالةمرشح العروض المنشورة: كل الحالات أو مجدول أو نشط أو مغلق.
من تاريخ / إلى تاريخنافذة السريان التي تُرشَّح بها العروض المنشورة والكوبونات معًا. الحدّان اختياريان؛ يبدأ الأول من بداية اليوم وينتهي الثاني بنهايته.
الملخصشريط جانبي في قسم العروض المنشورة: عدد صفوف العروض المحمَّلة، وعدد الطلبات المنسوبة من التقرير أو شرطة (—) قبل تحميله.
ما تكتبه هذه الإجراءاتشريط يسمّي المسارات التي يقرأها القسم ويكتبها مع جملة لكل منها، حتى يمكن التحقق من الادعاء على الشاشة. لا يُنفَّذ شيء من هذا الشريط نفسه.

حوار إيقاف نسخة العرض

الحقلالمعنى
معرّف القاعدة / الإصدارحقائق النسخة التي ستُوقَف، لاتينية، لتأكيد أنك تُوقف النسخة المقصودة.
سبب الإيقافنص إلزامي بثلاثة أحرف على الأقل يُحفظ في سجل التدقيق. يبقى زر التأكيد معطلًا حتى يُكتب.
تأكيد الإيقاف / إلغاءالتأكيد يوقف النسخة فلا تُطبَّق على طلبات جديدة؛ المبيعات السابقة وسجل التدقيق لا يتغيران. الإلغاء يغلق الحوار دون كتابة.

قسم الكوبونات

الحقلالمعنى
رمز الكوبونمرشح نصي لاتيني. يُطبَّق على قائمة الكوبونات وقائمة العروض وتقرير الإسناد عندما يبلغ ثلاثة أحرف فأكثر؛ أقل من ذلك يُتجاهل.
الحالة (كوبونات)مرشح الكوبونات: كل الحالات أو نشط أو متوقف مؤقتًا أو مؤرشف.
كوبون جديديفتح حوار إنشاء كوبون. يظهر لحامل صلاحية coupons-manage فقط، ويتعطل مع الجملة «إنشاء الكوبونات غير مشمول في خطتك الحالية» عندما لا تبيع الخطة مفتاح coupons.
الرمزرمز الكوبون بأحرف لاتينية كبيرة كما خُزّن، وتحته معرّف قاعدة العرض المرتبطة أو شرطة (—) إذا لم يُربط بقاعدة.
الحالة (عمود الكوبونات)نشط أو متوقف مؤقتًا أو مؤرشف، وتحتها نافذة الصلاحية من — إلى؛ شرطة عندما لا حدّ.
الاستخدامعدد الاستخدامات مقابل الحد الأقصى (مثل ٤٢ / ٥٠٠)، أو العدد ثم «بلا حد» عندما لا سقف. تحتها «محجوز»: الاستخدامات المحجوزة لطلبات لم تُدفع بعد.
الإجراء: إيقاف مؤقت / استئنافعمود يظهر لحامل coupons-manage فقط. الإيقاف المؤقت يحافظ على الاستخدامات والحجوزات السابقة ويحمل الإصدار المتوقع؛ الاستئناف يعيد الرمز إلى نشط. لا زر لكوبون مؤرشف. بدون الصلاحية يُكتب أن العرض للقراءة فقط.

حوار إنشاء كوبون

الحقلالمعنى
الرمزمن ٣ إلى ٦٤ حرفًا لاتينيًا أو رقمًا، ويبدأ بحرف أو رقم. يُخزَّن بأحرف كبيرة حتى لو كُتب صغيرًا. الحقل الوحيد الإلزامي.
معرّف قاعدة العرضاختياري. الرمز وحده لا يخصم شيئًا؛ قاعدة العرض المرتبطة هي ما يحدد قيمة الخصم. لا يحمل الكوبون قيمة ولا حدًّا أدنى للسلة ولا نطاق فرع.
أقصى عدد استخدامات / أقصى استخدام لكل عميلعددان صحيحان اختياريان من ١ فأكثر. الفراغ يعني بلا حد.
يبدأ / ينتهينافذة الصلاحية، اختيارية. فارغتان يعني أن الرمز يعمل فور إنشائه وبلا نهاية. يجب أن يأتي الانتهاء بعد البدء وإلا تعطّل زر الإنشاء.
إنشاء الكوبون / إلغاءالإنشاء يكتب كوبونًا نشطًا بإصدار ١ وبلا استخدامات، بمفتاح تعامل ثابت فلا تنشئ إعادة المحاولة رمزًا ثانيًا. بعد النجاح يُرشَّح الجدول على الرمز الجديد. خطأ الخادم يظهر داخل الحوار، ومع رفض الخطة يُسمّى مفتاح خطتك الحالية.

قسم مسودات العروض

الحقلالمعنى
قائمة المسوداتكل صف: اسم العرض، وrule_id، ورقم المراجعة الحالية (مثل #٣)، وحالة المسودة: مسودة أو قيد المراجعة أو معتمدة أو مرفوضة أو منشورة. «لا توجد مسودات بهذه المرشحات» عند الفراغ. القسم لحامل promotions-manage فقط.
مسودة جديدةيفتح نموذجًا فارغًا بتعريف قاعدة أولي وبداية سريان في الساعة القادمة من الغد. لحساب غير المالك يُختار فرعه الأول تلقائيًا.
المراجعة الحاليةرأس المحرر: rule_id وإصدار المسودة (مثل v4) وحالتها. يُحرَّر النموذج فقط عندما تكون المسودة جديدة أو بحالة مسودة أو مرفوضة؛ خلاف ذلك تُعرض الحقول للقراءة.
اسم العرض بالعربية / بالإنجليزيةالاسمان إلزاميان معًا؛ يُرفض الحفظ إذا خلا أحدهما.
الملخص بالعربية / بالإنجليزيةوصف اختياري يظهر تحت اسم العرض في جدول العروض المنشورة.
الفرعالفرع الذي تنطبق عليه المسودة. المالك يستطيع اختيار «على مستوى المنشأة»؛ غيره يجب أن يختار فرعًا، وإذا لم يكن للحساب فروع مسندة يُمنع الإنشاء والحفظ مع تنبيه.
تبدأ في / تنتهي فيوقت البداية إلزامي، والنهاية اختيارية لكنها يجب أن تأتي بعده وإلا رُفض الحفظ.
تعريف قاعدة العرض JSONنص القاعدة كاملًا، باتجاه يسار إلى يمين. تتحقق الواجهة من صحة JSON قبل الإرسال وترفض غير الصالح. الشروط والنتائج والأولوية كلها تُكتب هنا.
الجمهوررقائق مجموعات العملاء التي يكتب اختيارها شرط customer_group داخل JSON القاعدة ويرفع schema_minor إلى ٢ عند أول اختيار. بلا اختيار يُطبَّق العرض على أي عميل تتحقق فيه بقية الشروط. المجموعة الموقوفة تُعلَّم «موقوفة» واختيارها يعني ألا يُطبَّق العرض على أحد. تحتاج الرقائق إلى مفتاح crm في الخطة وصلاحية customers-management، وإلا كُتب ما ينقص.
إنشاء المسودة / حفظ مراجعة جديدةالإنشاء يكتب مسودة جديدة؛ الحفظ يضيف مراجعة ثابتة جديدة مقابل إصدار المسودة الحالي. كل نقلة تحمل مفتاح تعامل مستقلًا. تظهر «تم حفظ المسودة بالإصدار الحالي» عند النجاح.
إرسال للمراجعةيظهر لمسودة بحالة «مسودة» وينقلها إلى «قيد المراجعة».
ملاحظة المراجعة / اعتماد / رفضتظهر لمسودة قيد المراجعة. الاعتماد يجعلها معتمدة؛ الرفض يعيدها مرفوضة ويستلزم كتابة الملاحظة أولًا. يجب أن يكون المراجع غير مؤلف المسودة وإلا رفض الخادم القرار. الملاحظة المحفوظة تُعرض تحت الأزرار.
نشر النسخةيظهر لمسودة معتمدة. ينشئ نسخة قاعدة منشورة ثابتة تظهر في جدول العروض المنشورة، وتصبح المسودة «منشورة». وإذا تداخلت نافذتها مع نسخة منشورة أخرى من القاعدة نفسها، يُرفض النشر برسالة «نسخة أخرى من هذا العرض سارية خلال جزء من هذه الفترة.»: أغلق النسخة السابقة أو اختر فترة لا تتداخل معها.
سجل المراجعاتشريط جانبي يسرد كل مراجعة للمسودة المختارة برقمها (#١، #٢…) واسمها ونافذة سريانها، مع تعليم المراجعة الحالية.

الحالات المقفلة والصلاحيات

الحقلالمعنى
غير مشمولة في خطتكعندما لا تشمل الخطة مفتاح promotions يبقى العنصر في الشريط الجانبي بقفل، ويفتح المسار شاشة تسمّي القدرة وخطتك الحالية وزرًا وحيدًا «تواصل مع أيدي للترقية». أما إذا كانت خطتك تشمل القدرة وأوقفتها أيدي على الخادم مؤقتًا، فتقول الشاشة «متوقفة على هذا الخادم» بلا ترقية. وتضيف ملاحظة أن العروض المنشورة سابقًا تظل مطبَّقة على المبيعات حتى تُغلق أو ينتهي سريانها؛ الإيقاف يمنع الإنشاء والتحرير فقط. لا يُحذف شيء من بياناتك.
قدرات مقفلة داخل الصفحةمفتاح coupons يعطل زر «كوبون جديد» فقط وتبقى قراءة الكوبونات وإيقافها. مفتاح analytics.basic يحجب تقسيم الخصم حسب المجموعة فقط. مفتاح crm يحجب رقائق الجمهور فقط ويبقى تحرير JSON يدويًا ممكنًا.
العرض للقراءة فقطبدون promotions-manage لا يظهر زر «عرض جديد» ولا عمود الإيقاف ولا قسم المسودات؛ وبدون coupons-manage لا يظهر عمود الإجراء ولا زر «كوبون جديد». يُكتب أسفل الجدول المعني أن التعديلات تحتاج إلى صلاحية إدارة. يتحقق الخادم من الصلاحية في كل طلب.
هذه القدرة غير مفعّلة على الخادم حاليًارسالة خطأ تحل محل رسالة الخادم عندما يعيد رمزًا يقول إن القدرة معطلة أو غير متاحة في هذه البيئة. لا تُعرض بيانات بديلة.

صفحات ذات صلة

Section titled “صفحات ذات صلة”