واپسی اپ ڈیٹ ہوئی

واپسی اپ ڈیٹ ہوئی ٹرگر اس وقت ورک فلو شروع کرتا ہے جب آپ کے اسٹور میں کسی واپسی، اس کے لائن آئٹم یا اس کے ریورس تکمیلی آرڈر کی ایک یا زیادہ فیلڈ تبدیل ہوتی ہیں۔ آپ منتخب کرتے ہیں کہ واپسی کی کون سی فیلڈ اہم ہیں، اور ورک فلو صرف اسی وقت چلتا ہے جب ان میں سے کسی فیلڈ میں تبدیلی ہو، جیسے واپسی کا سٹیٹس تبدیل ہونے یا دوبارہ اسٹاک کرنے کی فیس شامل ہونے پر۔

واپسی کے کسی مخصوص مرحلے پر پہنچنے پر ورک فلو شروع کرنے کے لیے، آپ اس مرحلے کا ٹرگر بھی استعمال کر سکتے ہیں، جیسے واپسی کی درخواست کی گئی، واپسی منظور ہوئی یا واپسی بند ہوئی ٹرگر۔

نگرانی کے لیے دستیاب فیلڈ

واپسی اپ ڈیٹ ہوئی ٹرگر کے لیے آپ کو نگرانی کی غرض سے کم از کم ایک فیلڈ منتخب کرنا ضروری ہے۔ آپ زیادہ سے زیادہ پانچ فیلڈ منتخب کر سکتے ہیں۔ منتخب کردہ فیلڈ میں سے کسی ایک میں بھی تبدیلی ہونے پر ورک فلو چلتا ہے۔ جن فیلڈ کو آپ نے منتخب نہیں کیا، ان میں تبدیلی سے ورک فلو شروع نہیں ہوتا۔

جن فیلڈ کی آپ نگرانی کر سکتے ہیں ان کے بارے میں مزید جاننے کے لیے درج ذیل جدول دیکھیں۔

وہ فیلڈ جن کی آپ واپسی اپ ڈیٹ ہوئی ٹرگر کے ذریعے نگرانی کر سکتے ہیں۔
فیلڈ کی قسمفیلڈ
واپسیclosedAt, decline, requestApprovedAt, status
واپسی کے لائن آئٹمreturnLineItems.quantity, returnLineItems.refundableQuantity, returnLineItems.refundedQuantity, returnLineItems.restockingFee, returnLineItems.restockingFee.amountSet, returnLineItems.restockingFee.amountSet.presentmentMoney, returnLineItems.restockingFee.amountSet.shopMoney, returnLineItems.restockingFee.percentage, returnLineItems.unprocessedQuantity
تبادلے کے لائن آئٹمexchangeLineItems
واپسی کی شپنگ فیسreturnShippingFees, returnShippingFees.amountSet, returnShippingFees.amountSet.presentmentMoney, returnShippingFees.amountSet.shopMoney
ریورس تکمیلی آرڈرreverseFulfillmentOrders, reverseFulfillmentOrders.lineItems, reverseFulfillmentOrders.status

جس فیلڈ کے نام کے آخر میں amountSet ہو، اس میں ایک رقم دو کرنسی میں موجود ہوتی ہے۔ جب آپ اس فیلڈ کی نگرانی کرتے ہیں، تو ان میں سے کسی بھی رقم میں تبدیلی سے ورک فلو شروع ہوتا ہے۔ صرف ایک رقم کی نگرانی کرنے کے لیے، اپنے اسٹور کی کرنسی میں رقم کے لیے اس فیلڈ کی shopMoney فیلڈ منتخب کریں، یا کسٹمر کی کرنسی میں رقم کے لیے اس کی presentmentMoney فیلڈ منتخب کریں۔

کچھ فیلڈ واپسی میں آئٹم شامل کرنے یا اس سے آئٹم ہٹانے پر بھی ورک فلو شروع کرتی ہیں:

  • اگر آپ واپسی کے لائن آئٹم گروپ میں کسی فیلڈ کی نگرانی کرتے ہیں، تو واپسی میں لائن آئٹم شامل کرنے یا اس سے لائن آئٹم ہٹانے پر ورک فلو شروع ہو جاتا ہے۔
  • اگر آپ دوبارہ اسٹاک کرنے کی فیس کے کسی فیلڈ، مثلاً returnLineItems.restockingFee.percentage، کی نگرانی کرتے ہیں تو کسی لائن آئٹم میں دوبارہ اسٹاک کرنے کی فیس شامل کرنے یا اس سے ہٹانے پر ورک فلو شروع ہو جاتا ہے۔
  • اگر آپ exchangeLineItems فیلڈ کی نگرانی کرتے ہیں، تو واپسی میں تبادلے کا آئٹم شامل کرنے یا اس سے تبادلے کا آئٹم ہٹانے سے ورک فلو شروع ہوتا ہے۔
  • اگر آپ واپسی کی شپنگ فیس گروپ میں کسی فیلڈ کی نگرانی کرتے ہیں، تو واپسی کی شپنگ فیس شامل کرنے یا ہٹانے سے ورک فلو شروع ہوتا ہے۔
  • اگر آپ ریورس تکمیلی آرڈر گروپ میں کسی فیلڈ کی نگرانی کرتے ہیں، تو واپسی میں ریورس تکمیلی آرڈر شامل کرنے سے ورک فلو شروع ہوتا ہے۔ اگر آپ reverseFulfillmentOrders فیلڈ یا reverseFulfillmentOrders.lineItems فیلڈ کی نگرانی کرتے ہیں، تو ریورس تکمیلی آرڈر سے لائن آئٹم ہٹانے سے بھی ورک فلو شروع ہوتا ہے۔

ورک فلو شروع کرنے والی فیلڈ منتخب کریں

وہ فیلڈ منتخب کریں جن میں تبدیلی آنے پر ورک فلو شروع ہو۔

مراحل:

  1. ورک فلو ایڈیٹر میں، واپسی اپ ڈیٹ کی گئی ٹرگر پر کلک کریں۔
  2. واپسی کی فیلڈ منتخب کریں سیکشن میں، فیلڈ منتخب کریں پر کلک کریں۔
  3. نگرانی کے لیے فیلڈ شامل کریں ڈائیلاگ میں، جس فیلڈ کی آپ نگرانی کرنا چاہتے ہیں اسے تلاش کریں یا براؤز کر کے اس تک جائیں، پھر اسے منتخب کریں۔
  4. اختیاری: زیادہ سے زیادہ پانچ فیلڈ کی نگرانی کے لیے مراحل 2 اور 3 دہرائیں۔

فیلڈ

واپسی اپ ڈیٹ ہوئی ٹرگر میں درج ذیل فیلڈ شامل ہیں، جنہیں شرائط اور ایکشن میں، اور ورک فلو میں ڈیٹا حاصل کرنے کے لیے استعمال کیا جا سکتا ہے۔ واپسی اور اسٹور کی فیلڈ ہمیشہ دستیاب ہوتی ہیں۔ دوسری فیلڈ صرف اسی وقت دستیاب ہوتی ہیں جب آپ کسی متعلقہ فیلڈ کی نگرانی کرتے ہیں۔ مثال کے طور پر، ریورس تکمیلی آرڈر فیلڈ اس وقت دستیاب ہوتی ہے جب آپ ریورس تکمیلی آرڈر کی کسی فیلڈ، جیسے reverseFulfillmentOrders.status کی نگرانی کرتے ہیں۔

واپسی اپ ڈیٹ کی گئی ٹرگر میں شامل فیلڈ.
فیلڈوضاحت
واپسیوہ واپسی جو اپ ڈیٹ ہوئی۔
اسٹوروہ اسٹور جہاں واپسی اپ ڈیٹ ہوئی۔
واپسی کا لائن آئٹمواپسی کا وہ لائن آئٹم جس میں تبدیلی ہوئی۔ واپسی سے لائن آئٹم ہٹائے جانے پر یہ خالی ہوتا ہے۔ یہ returnLineItems.quantity یا دوبارہ اسٹاک کرنے کی فیس کی کسی فیلڈ کی نگرانی کرنے پر دستیاب ہوتا ہے۔
تبادلے کا لائن آئٹمتبادلے کا وہ لائن آئٹم جو شامل کیا گیا تھا۔ تبادلے کا لائن آئٹم ہٹائے جانے پر یہ خالی ہوتا ہے۔ یہ exchangeLineItems فیلڈ کی نگرانی کرنے پر دستیاب ہوتا ہے۔
ریورس تکمیلی آرڈروہ ریورس تکمیلی آرڈر جس میں تبدیلی ہوئی۔ یہ اس وقت دستیاب ہوتا ہے جب آپ ریورس تکمیلی آرڈر کی کسی فیلڈ کی نگرانی کرتے ہیں۔

اگر آپ مختلف اقسام کی فیلڈ کی نگرانی کرتے ہیں، تو ورک فلو چلنے پر واپسی کا لائن آئٹم، تبادلے کا لائن آئٹم اور ریورس تکمیلی آرڈر کی فیلڈ خالی ہو سکتی ہیں۔ مثال کے طور پر، اگر آپ status اور returnLineItems.quantity دونوں کی نگرانی کرتے ہیں، تو صرف سٹیٹس تبدیل ہونے پر واپسی کا لائن آئٹم فیلڈ خالی ہوتی ہے۔ واپسی کا لائن آئٹم اور تبادلے کا لائن آئٹم کی فیلڈ اس وقت بھی خالی ہو سکتی ہیں جب آپ صرف ان کی قسم کی فیلڈ کی نگرانی کر رہے ہوں۔ ان میں سے کسی فیلڈ کو ایکشن میں استعمال کرنے سے پہلے، ایک شرط شامل کریں جو چیک کرے کہ فیلڈ میں کوئی ویلیو موجود ہے۔

واپسی اپ ڈیٹ ہوئی ٹرگر صرف واپسی اور اس کے لائن آئٹم کی موجودہ ویلیو فراہم کرتا ہے۔ تبدیل ہونے والی فیلڈ کی سابقہ ویلیو ورک فلو میں دستیاب نہیں ہوتیں۔ مثال کے طور پر، اگر آپ status فیلڈ کی نگرانی کرتے ہیں، تو آپ کسی شرط یا ایکشن میں واپسی کا موجودہ سٹیٹس استعمال کر سکتے ہیں، لیکن تبدیلی سے پہلے والا سٹیٹس استعمال نہیں کر سکتے۔

ایکشن

یہ ٹرگر واپسی کا آبجیکٹ فراہم کرتا ہے، اس لیے آپ ایسا کوئی بھی ایکشن استعمال کر سکتے ہیں جس کے لیے واپسی درکار ہو۔ اس کے علاوہ، واپسی کے آبجیکٹ میں آرڈر بھی شامل ہوتا ہے، اس لیے یہ ٹرگر آرڈر سے متعلق کسی بھی ایکشن کے ساتھ استعمال کیا جا سکتا ہے، جن میں شامل ہیں:

آرڈر کے ذریعے آپ دوسرے ڈیٹا، جیسے کسٹمر کے ڈیٹا تک رسائی حاصل کر سکتے ہیں، اس لیے یہ ٹرگر کسٹمر سے متعلق ایکشن کے ساتھ بھی استعمال کیا جا سکتا ہے۔ ان میں شامل ہیں:

آرڈر میں لائن آئٹم جیسے ڈیٹا کی فہرستیں بھی شامل ہوتی ہیں۔ ہر ایک کے لیے کارروائی استعمال کر کے آپ ان فہرستوں کے ہر آئٹم پر باری باری کارروائیاں انجام دے سکتے ہیں۔ مثال کے طور پر، آپ لائن آئٹم پر باری باری کارروائی کر کے ہر پروڈکٹ پر ٹیگ لگا سکتے ہیں۔

واپسی اپ ڈیٹ ہوئی ٹرگر کی جانچ

اس ٹرگر سے شروع ہونے والے ورک فلو کی جانچ کے لیے، ورک فلو کو آن کریں۔ پھر Shopify ایڈمن میں کسی واپسی کی ان فیلڈ میں سے ایک کو تبدیل کریں جن کی ورک فلو نگرانی کرتا ہے۔ مثال کے طور پر، واپسی تخلیق کریں، پھر واپسی پر کارروائی کریں یا واپسی بند کریں۔

API کی تفصیلات

واپسی اپ ڈیٹ ہوئی ٹرگر کے ذریعے واپسی کے GraphQL API آبجیکٹ پر ایکشن انجام دیے جا سکتے ہیں۔ یہ ٹرگر Shopify Events کے حوالے میں واپسی کے ٹاپک کے update ایکشن سے مطابقت رکھتا ہے، جسے صرف ان فیلڈ تک فلٹر کیا جاتا ہے جن کی نگرانی آپ منتخب کرتے ہیں۔