إضافة بند طلب
يضيف إجراء إضافة بند طلب متغير منتج إلى الطلب الذي يُشغّل سير العمل. يمكن استخدام هذا الإجراء لإضافة متغير منتج مجاني أو مدفوع تنوي تحصيل رسوم مقابله.
يتم تشغيل إجراء إضافة بند طلب بعد اكتمال عملية الدفع، لذلك لن يكون العملاء على علم بالبند إلا إذا قاموا بعرض طلبهم.
الحقول
يحتوي إجراء إضافة بند طلب على الحقول التالية.
| الحقل | الوصف |
|---|---|
| متغير المنتج | مطلوب. انقر على الزر تصفح في هذا الحقل لتحديد متغير منتج من متجرك.يدعم هذا الحقل أيضًا معرّف GID لمتغير منتج مُدخل يدويًا لتحديد المنتج المراد إضافته إلى الطلب. تنسيق معرّف GID هو gid://shopify/ProductVariant/، متبوعًا بـ رقم معرّف المتغير.على سبيل المثال، عند زيارة صفحة متغير في مسؤول Shopify، يكون عنوان URL في شريط عناوين المتصفح الخاص بك هو https://admin.shopify.com/store/shopname/products/1234567/variants/36485954240671. معرّف المتغير هو 36485954240671، ومعرّف GID لمتغير المنتج هو gid://shopify/ProductVariant/36485954240671. |
| الكمية | مطلوب. كمية المنتج التي يضيفها سير العمل إلى الطلب. يجب أن تكون الكمية أكبر من الصفر. يدعم هذا الحقل لغة Liquid. يجب أن يتم تقييم أي كود Liquid إلى رقم وإلا سيؤدي ذلك إلى خطأ في وقت التشغيل (runtime error). |
| السماح بالمتغيرات المكررة | عند التحديد، يضيف سير العمل كمية المتغير إلى الطلب، حتى إذا كان المتغير جزءًا من الطلب بالفعل. |
| إضافة مجانًا | تطبيق خصم بنسبة 100% على البند. |
| إرسال تحديثات الطلب إلى العميل عبر البريد الإلكتروني | عند التحديد، يُخطر سير العمل العميل بجميع التغييرات التي تطرأ على الطلب، بما في ذلك المدفوعات الإضافية. |
| ملاحظة المخطط الزمني للطلب | عند إدخال نص، يضيفه سير العمل كملاحظة في المخطط الزمني للطلب. |
المشغلات
يحتوي إجراء إضافة بند طلب على حقل مخفي مُضاف إليه بواسطة المشغّل. يحدد هذا الحقل، معرّف الطلب (Order ID)، الطلب الذي ستتم إضافة البنود إليه. يتم تعيين معرّف الطلب بشكل افتراضي ولا يمكن تغييره.
يمكن استخدام إجراء إضافة بند طلب في مسارات سير العمل التي تحتوي على إجراء الحصول على بيانات الطلب (Get order data)، أو أي مشغلات تحتوي على طلب، مثل:
- تم إلغاء الطلب
- تم إنشاء الطلب
- تم تنفيذ الطلب
- تم دفع الطلب
- تم تحليل مخاطر الطلب
- تم إنشاء معاملة الطلب
- تم إنشاء التنفيذ
- تم إنشاء حدث التنفيذ
- تم إنشاء استرداد الأموال
- تم إنشاء معاملة الدفع
القيود
سيضيف هذا الإجراء بندًا دون وضع المخزون في الاعتبار. لإضافة بند فقط إذا كان المنتج متوفرًا في المخزون، قم بتضمين شرط قبل الإجراء للتحقق من مخزون المتغيّر المراد إضافته.
تفاصيل API
لمعرفة المزيد، راجع عملية mutation orderEditAddVariant.