الحصول على بيانات عملية الدفع المتروكة

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

التهيئة

الحقول

يحتوي إجراء الحصول على بيانات عملية الدفع المتروكة على الحقول التالية:

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

فيما يلي استعلام كمثال للحصول على عمليات الدفع المتروكة التي تم إنشاؤها في اليوم الأخير:

created_at:>'{{ scheduledAt | date_minus: "1 day" }}'

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

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

• قائمة فلاتر عمليات الدفع المتروكة المتاحة

• يجب أن تتبع الاستعلامات بنية معينة

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

• يمكنك تشغيل استعلام أو اختباره في متجرك باستخدام تطبيق Shopify GraphiQL.

• انتبه لما يحدث إذا فشل استعلامك. فغالبًا ما ستُرجع واجهة برمجة التطبيقات جميع النتائج (بدلاً من عدم إرجاع أي نتيجة).

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

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

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

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

{% for single_checkout in getAbandonedCheckoutData %}
  * {{ single_checkout.email }} - {{ single_checkout.totalPrice }}
{% endfor %}

المُشغّلات

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

مرجع واجهة برمجة التطبيقات (API)

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