الحصول على بيانات الطلب

في مسارات العمل التي تتطلب بيانات الطلب، يمكنك استخدام إجراء الحصول على بيانات الطلب لاسترداد معلومات الطلب من متجرك.

التكوين

الحقول

يحتوي إجراء الحصول على بيانات الطلب على الحقول التالية، والتي تُستخدم لإنشاء الاستعلام:

سلسلة الاستعلام

هذا مثال على استعلام للحصول على الطلبات التي تم تحديثها في اليوم الأخير:

updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'

المتغير updated_at هو عامل تصفية متاح في استعلام الطلبات ويمكن استخدامه عدة مرات أو دمجه مع متغيرات أخرى. يتوفر متغير Liquid scheduledAt في مسارات العمل التي استخدمت مُشغّل الوقت المُجدوَل. علامة Liquid date_minus هي علامة Flow خاصة تتيح لك طرح الوقت من التاريخ.

عند الاستعلام عن البيانات، من المفيد معرفة ما يلي:

• قائمة عوامل تصفية الطلبات المتاحة
• يجب أن تتبع الاستعلامات صيغة محددة
• لا يتم دائمًا توثيق قيم حقول الاستعلام. في بعض الحالات، يمكن العثور على القيم من خلال الاطلاع على مستندات API. كبديل، يمكنك غالبًا العثور على قيم الحقول في عناوين URL في المسؤول عند استخدام عوامل التصفية. على سبيل المثال، للعثور على بعض قيم استعلام الطلبات، قم بتصفية صفحة الطلبات في المسؤول، ثم تحقق من عنوان URL.
• يمكنك تشغيل استعلام أو اختباره في متجرك باستخدام تطبيق Shopify GraphiQL.
• كن منتبهًا لما يحدث إذا فشل استعلامك. في الغالب سترجع واجهة برمجة التطبيقات (API) جميع النتائج (بدلًا من عدم إرجاع أي منها).

البيانات المُرجعة

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

• إذا كنت بحاجة إلى معالجة كل عنصر في القائمة على حدة، كإضافة إشارة لكل عنصر، فيمكنك استخدام الإجراء لكل.
• إذا كنت بحاجة إلى تجميع البيانات، مثل حساب عدد النتائج المُرجعة، فيمكنك استخدام الإجراء العدد أو المجموع.
• إذا كنت بحاجة إلى إخراج القائمة، مثل إرسال بريد إلكتروني بجميع العناصر، فيمكنك استخدام البيانات المُرجعة مباشرةً في الإجراءات اللاحقة.

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

{% for single_order in GetOrderData %}
* {{ single_order.name }}
{% endfor %}

المُشغّلات

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

تفاصيل API

• مورد الطلب
• عوامل تصفية استعلام الطلبات

القوالب

إلغاء الطلبات للعملاء الذين يكثرون الإرجاع

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

إلغاء الطلبات إذا أجرى العميل أكثر من 5 طلبات اليوم

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

تعليق طلبات التنفيذ للعملاء الذين لديهم عمليات رد مبالغ مدفوعة

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

تعليق عمليات التنفيذ إذا أجرى العميل طلبات متعددة خلال 24 ساعة

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

تعليق الطلبات إذا أجرى العميل أكثر من طلب واحد في آخر 24 ساعة

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

إرسال إشعار عندما يكون حجم الطلبات أقل من 10 في الساعة الماضية

يُرسل إشعارًا دوريًا للطلبات. في كل ساعة، يحصل على ما يصل إلى 10 طلبات تم إنشاؤها، ويحسبها. إذا كانت أقل من 10، يُرسل إشعارًا عبر البريد الإلكتروني. يَستخدم خطوات الوقت المُجدوَل، والحصول على بيانات الطلب، والعدد. عرض القالب

إرسال ملخص عبر البريد الإلكتروني بجميع طلبات المتجر الإلكتروني في اليوم الأخير

كل يوم، يحصل على طلبات اليوم الأخير، ويُرسل ملخصًا عبر البريد الإلكتروني يتضمن الطلبات التي تم إجراؤها في المتجر الإلكتروني. عرض القالب

إرسال ملخص عبر البريد الإلكتروني بجميع الطلبات غير المنفذة التي مر عليها أكثر من يومين

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

إضافة إشارات وإرسال ملخص يومي لعمليات التنفيذ المتأخرة

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

إضافة إشارات للعملاء الذين لديهم رد مبالغ مدفوعة

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

إضافة إشارات للطلبات غير المنفذة التي مر عليها أكثر من يومين

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

استخدم الإشارات لتقسيم العملاء بناءً على طلباتهم خلال الأشهر الستة الماضية

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