انتقل إلى المحتوى الرئيسي

حالات الطلبات

حالات الطلبات ضرورية لتتبع تقدم الطلب من إنشائه حتى الانتهاء. إنها تساعد في تنظيم العمل مع الطلبات للمديرين، وكذلك رؤية الحالة الحالية للطلب للعميل.

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

أوضاع العمل مع الحالات​

في الجزء العلوي من قسم "حالات الطلبات" يوجد كتلة "إعداد وضع حالة الطلب"، حيث يمكنك اختيار أحد وضعين للعمل:

  • أساسي (Basic) — الوضع الافتراضي. يستخدم مجموعة واحدة من الحالات المرتبطة بحساب الدفع. تتغير حالة الطلب بشكل خطي بناءً على أحداث الدفع. هذا الوضع كافٍ لمعظم السيناريوهات.
  • متقدم (Advanced) — إعداد مرن على ثلاثة محاور مستقلة: حالة الطلب (الحالة الرئيسية للطلب)، التنفيذ (التجميع، الشحن، التسليم) و الدفع. يتم تعيين مجموعة خاصة من الحالات لكل محور، بالإضافة إلى خرائط الانتقال التلقائي بناءً على المحفزات والمحسنات المخصصة.

لتغيير الوضع، اختر الخيار المطلوب في كتلة "إعداد وضع حالة الطلب" ووافق على الإجراء في النافذة المنبثقة.

من المهم أن نفهم

عند التبديل إلى الوضع المتقدم، تأكد من تعيين حالة افتراضية لمحور حالة الطلب — حيث يبدأ دورة حياة الطلب. طالما لم يتم تعيين حالة افتراضية لمحور حالة الطلب، تعتبر البيانات غير صحيحة ويتم حظر حفظ المستودع.

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

إنشاء حالة​

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

في كتلة إنشاء حالة جديدة، املأ:

  • اسم الحالة - سلسلة غير فريدة. يعكس الاسم أيضًا جوهر الحالة. على سبيل المثال، يمكن تسمية الحالة "يتم التسليم" أو "مكتمل". هذه المعلومات هي ما سيراه المدير والمستخدم في قسم حالة الطلب.
  • العلامة - سلسلة فريدة تُستخدم داخل كود تطبيقك. تذكر ذلك عند إعداد العلامة حتى لا تسبب تعارضات في عمل التطبيق.

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

تعديل الحالة​

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

اختر من القائمة الحالة التي تريد تعديلها واضغط على أيقونة التحرير تعديل. يمكنك تغيير اسم الحالة (Name)، علامتها (Marker)، بالإضافة إلى إعدادات الحالة الافتراضية، الإلغاء النهائي و النجاح النهائي.

من المهم أن نفهم

إذا كانت الحالة مستخدمة بالفعل في تطبيقك، قم بتغيير العلامة فقط إذا كنت متأكدًا تمامًا من أن ذلك لن يؤثر على عمل التطبيق.

القيمة الافتراضية​

يمكنك اختيار واحدة من الحالات كقيمة افتراضية. ستُعيّن الحالة التي تحمل هذه العلامة في كل مرة لا يتم فيها تعيين حالة أخرى.

لجعل الحالة حالة افتراضية، انتقل إلى إعدادات الحالة بالضغط على أيقونة التحرير تعديل. قم بتحديد خانة الاختيار في إعداد الحالة الافتراضية. يتم تعيين الحالة الافتراضية تلقائيًا للطلب عند إنشائه.

يمكن أن يكون هناك حالة واحدة فقط مع هذا الإعداد في مستودع الطلب. في القائمة العامة، ستُميز هذه الحالة بعلامة خاصة.

الإلغاء النهائي​

قم بتحديد خانة الإلغاء النهائي إذا كانت الحالة تعني الإلغاء النهائي للطلب. عند انتقال الطلب إلى هذه الحالة، يتم إلغاء الطلب وتُعاد المكافآت المطبقة عليه. عادةً ما يتم تضمين هذا الإعداد للحالات التي تتوافق مع حالات الدفع expired و canceled.

النجاح النهائي​

قم بتحديد خانة النجاح النهائي إذا كانت الحالة تعني الانتهاء الناجح للطلب. تُحتسب الطلبات في هذه الحالة في LTV العميل — المجموع الكلي لجميع طلباته المدفوعة.

حذف الحالة​

لحذف حالة الطلب، افتح قسم الطلبات في القائمة اليسرى. اختر من القائمة مستودع الطلبات الذي تريد حذف حالة الطلب منه واضغط على أيقونة التحرير تعديل. انتقل إلى قسم "حالات الطلبات".

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

من المهم أن نفهم

لا يمكن حذف الحالة المعينة لأي طلب أو المستخدمة في خريطة الحالات — لا تظهر أيقونة الحذف لهذه الحالة.

الوضع المتقدم​

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

لتفعيل الوضع المتقدم، في كتلة "إعداد وضع حالة الطلب"، اختر الخيار متقدم ووافق على التبديل.

ثلاثة محاور للحالات​

في الوضع المتقدم، يحتوي كل طلب على ثلاثة محاور مستقلة للحالات:

  • حالة الطلب — الحالة التجارية الرئيسية للطلب.
  • التنفيذ — تنفيذ الطلب (التجميع، الشحن، التسليم).
  • الدفع — حالة الدفع.

تنتمي كل حالة إلى محور واحد فقط. يتم إدارة المحاور حالة الطلب و التنفيذ من قبل البائع (يدويًا أو من خلال التكامل)، بينما يتم إدارة محور الدفع تلقائيًا بواسطة النظام بناءً على أحداث الدفع.

من المهم أن نفهم

لا يمكن حذف الحالة المستخدمة في خريطة الانتقالات أو المعينة لأي طلب.

إنشاء حالة في الوضع المتقدم​

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

خرائط الحالات​

عند تفعيل الوضع المتقدم، تظهر علامة "حالات الطلب" → "تخطيط الحالة" (خرائط الحالات). تقوم الخريطة تلقائيًا بترجمة حالة محور حالة الطلب أو التنفيذ بناءً على المحفز. على سبيل المثال، عند المحفز payment.paid، يتم تحويل حالة محور حالة الطلب إلى "مدفوع".

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

بعد إعداد الخريطة، اضغط على زر "حفظ".

معلومات

يمكن تغيير حالات المحاور حالة الطلب و التنفيذ يدويًا أو من خلال التكامل. يتم إدارة محور الدفع فقط بواسطة النظام بناءً على أحداث الدفع.

المحفزات المخصصة​

في علامة خرائط الحالات، يمكنك إنشاء محفزات مخصصة من نوع custom.{name}. يتم استدعاء هذه المحفزات فقط من خلال تكامل API ومتاحة للمحاور حالة الطلب و التنفيذ. وهذا يسمح بوصف انتقالات الحالات لأحداث الأعمال غير القياسية في تطبيقك.