রিটার্ন আপডেট হয়েছে
স্টোরে কোনো রিটার্ন, তার লাইন আইটেম বা রিভার্স ফুলফিলমেন্ট অর্ডারের এক বা একাধিক ফিল্ড পরিবর্তিত হলে রিটার্ন আপডেট হয়েছে ট্রিগার একটি ওয়ার্কফ্লো শুরু করে। রিটার্নের কোন ফিল্ডগুলো গুরুত্বপূর্ণ, তা নির্বাচন করুন। শুধু সেগুলোর কোনো একটি পরিবর্তিত হলেই ওয়ার্কফ্লো চলে, যেমন রিটার্নের স্ট্যাটাস পরিবর্তিত হলে বা রিস্টকিং ফি যোগ হলে।
রিটার্ন কোনো নির্দিষ্ট পর্যায়ে পৌঁছালে ওয়ার্কফ্লো শুরু করতে সেই পর্যায়ের ট্রিগারও ব্যবহার করা যায়, যেমন রিটার্নের অনুরোধ করা হয়েছে, রিটার্ন অনুমোদিত হয়েছে বা রিটার্ন বন্ধ হয়েছে ট্রিগার।
এই পৃষ্ঠায়
পর্যবেক্ষণ করা যায় এমন ফিল্ড
রিটার্ন আপডেট হয়েছে ট্রিগারের জন্য পর্যবেক্ষণ করতে অন্তত একটি ফিল্ড নির্বাচন করতে হবে। সর্বোচ্চ পাঁচটি ফিল্ড নির্বাচন করা যায়। নির্বাচিত ফিল্ডগুলোর যেকোনো একটি পরিবর্তিত হলে ওয়ার্কফ্লো চলে। নির্বাচন করা হয়নি এমন ফিল্ডের পরিবর্তনে ওয়ার্কফ্লো শুরু হয় না।
যেসব ফিল্ড পর্যবেক্ষণ করা যায়, সেগুলো সম্পর্কে আরও জানতে নিচের সারণি দেখুন।
| ফিল্ডের ধরন | ফিল্ড |
|---|---|
| রিটার্ন | 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ফিল্ড পর্যবেক্ষণ করলে, রিভার্স ফুলফিলমেন্ট অর্ডার থেকে কোনো লাইন আইটেম সরালেও ওয়ার্কফ্লো শুরু হয়।
যেসব ফিল্ডের পরিবর্তনে ওয়ার্কফ্লো শুরু হবে, সেগুলো নির্বাচন করুন
যেসব ফিল্ডে পরিবর্তন হলে ওয়ার্কফ্লো শুরু হবে, সেগুলি নির্বাচন করুন।
ধাপগুলি:
- ওয়ার্কফ্লো এডিটরে রিটার্ন আপডেট হয়েছে ট্রিগারে ক্লিক করুন।
- রিটার্নের ফিল্ড নির্বাচন করুন বিভাগে ফিল্ড নির্বাচন করুন-এ ক্লিক করুন।
- পর্যবেক্ষণের জন্য ফিল্ড যোগ করুন ডায়ালগে যে ফিল্ডটি পর্যবেক্ষণ করতে চান, সেটি সার্চ করে বা ব্রাউজ করে খুঁজুন। তারপর সেটি নির্বাচন করুন।
- ঐচ্ছিক: সর্বোচ্চ পাঁচটি ফিল্ড পর্যবেক্ষণ করতে 2 ও 3 নম্বর ধাপ আবার অনুসরণ করুন।
ফিল্ড
রিটার্ন আপডেট হয়েছে ট্রিগারে নিচের ফিল্ডগুলো থাকে। এগুলো শর্ত ও অ্যাকশনে এবং ওয়ার্কফ্লোতে ডেটা পেতে ব্যবহার করা যায়। রিটার্ন ও স্টোর ফিল্ড সবসময় পাওয়া যায়। অন্য ফিল্ডগুলো শুধু সংশ্লিষ্ট কোনো ফিল্ড পর্যবেক্ষণ করলেই পাওয়া যায়। যেমন, reverseFulfillmentOrders.status-এর মতো রিভার্স ফুলফিলমেন্ট অর্ডারের কোনো ফিল্ড পর্যবেক্ষণ করলে রিভার্স ফুলফিলমেন্ট অর্ডার ফিল্ড পাওয়া যায়।
| ফিল্ড | বিবরণ |
|---|---|
| রিটার্ন | যে রিটার্নটি আপডেট করা হয়েছে। |
| স্টোর | যে স্টোরে রিটার্নটি আপডেট করা হয়েছে। |
| রিটার্ন লাইন আইটেম | রিটার্নের পরিবর্তিত লাইন আইটেম। রিটার্ন থেকে কোনো লাইন আইটেম সরানো হলে এটি ফাঁকা থাকে। returnLineItems.quantity বা রিস্টকিং ফি-সংক্রান্ত কোনো ফিল্ড পর্যবেক্ষণ করলে এটি পাওয়া যায়। |
| বিনিময়ের লাইন আইটেম | বিনিময়ের জন্য যোগ করা লাইন আইটেম। বিনিময়ের কোনো লাইন আইটেম সরানো হলে এটি ফাঁকা থাকে। exchangeLineItems ফিল্ড পর্যবেক্ষণ করলে এটি পাওয়া যায়। |
| রিভার্স ফুলফিলমেন্ট অর্ডার | যে রিভার্স ফুলফিলমেন্ট অর্ডারটি পরিবর্তিত হয়েছে। রিভার্স ফুলফিলমেন্ট অর্ডারের কোনো ফিল্ড পর্যবেক্ষণ করলে এটি পাওয়া যায়। |
ভিন্ন ধরনের ফিল্ড পর্যবেক্ষণ করলে, ওয়ার্কফ্লো চলার সময় রিটার্ন লাইন আইটেম, বিনিময় লাইন আইটেম এবং রিভার্স ফুলফিলমেন্ট অর্ডার ফিল্ড খালি থাকতে পারে। যেমন, status ও returnLineItems.quantity দুটিই পর্যবেক্ষণ করলে, শুধু স্ট্যাটাস পরিবর্তিত হলে রিটার্ন লাইন আইটেম ফিল্ড খালি থাকে। শুধু সংশ্লিষ্ট ধরনের ফিল্ড পর্যবেক্ষণ করলেও রিটার্ন লাইন আইটেম ও বিনিময় লাইন আইটেম ফিল্ড খালি থাকতে পারে। কোনো অ্যাকশনে এই ফিল্ডগুলোর একটি ব্যবহার করার আগে, ফিল্ডটিতে মান আছে কি না তা যাচাই করার শর্ত যোগ করুন।
রিটার্ন আপডেট হয়েছে ট্রিগার শুধু রিটার্ন ও তার লাইন আইটেমের বর্তমান মান দেয়। যেসব ফিল্ড পরিবর্তিত হয়েছে, সেগুলোর আগের মান ওয়ার্কফ্লোতে পাওয়া যায় না। যেমন, status ফিল্ড পর্যবেক্ষণ করলে, কোনো শর্ত বা অ্যাকশনে রিটার্নের বর্তমান স্ট্যাটাস ব্যবহার করা যায়, তবে পরিবর্তনের আগের স্ট্যাটাস ব্যবহার করা যায় না।
অ্যাকশন
এই ট্রিগার একটি রিটার্ন অবজেক্ট দেয়, তাই রিটার্ন প্রয়োজন হয় এমন যেকোনো অ্যাকশন ব্যবহার করা যায়। রিটার্ন অবজেক্টে একটি অর্ডারও থাকে, তাই ট্রিগারটি অর্ডার-সংক্রান্ত যেকোনো অ্যাকশনে ব্যবহার করা যায়। এর মধ্যে রয়েছে:
- অর্ডারে লাইন আইটেম যোগ করুন
- অর্ডারের ট্যাগ যোগ করুন
- অর্ডার আর্কাইভ করুন
- অর্ডার বাতিল করুন
- পেমেন্ট ক্যাপচার করুন
- ফুলফিলমেন্ট অর্ডার স্থগিত রাখুন
- অর্ডার পরিশোধিত হিসেবে চিহ্নিত করুন
অর্ডার থেকে গ্রাহকের মতো অন্যান্য ডেটাও পাওয়া যায়, তাই এই ট্রিগার গ্রাহক-সংক্রান্ত অ্যাকশনেও ব্যবহার করা যায়। এর মধ্যে রয়েছে:
- গ্রাহকের ট্যাগ যোগ করুন
- গ্রাহকের মেটাফিল্ড সরান
- গ্রাহকের ট্যাগ সরান
- গ্রাহকের মেটাফিল্ড আপডেট করুন
- গ্রাহকের নোট আপডেট করুন
অর্ডারে লাইন আইটেমের মতো ডেটার তালিকাও থাকে। প্রতিটির জন্য অ্যাকশন ব্যবহার করে এই তালিকাগুলির প্রতিটি আইটেমের জন্য পর্যায়ক্রমে অ্যাকশন চালাতে পারেন। যেমন, লাইন আইটেমগুলি পর্যায়ক্রমে নিয়ে প্রতিটি পণ্যে একটি ট্যাগ যোগ করতে পারেন।
“রিটার্ন আপডেট হয়েছে” ট্রিগার পরীক্ষা করা
এই ট্রিগার দিয়ে শুরু হওয়া কোনো ওয়ার্কফ্লো পরীক্ষা করতে, ওয়ার্কফ্লোটি চালু করুন। তারপর Shopify অ্যাডমিনে কোনো রিটার্নের এমন একটি ফিল্ড পরিবর্তন করুন, যা ওয়ার্কফ্লোটি পর্যবেক্ষণ করে। যেমন, একটি রিটার্ন তৈরি করুন, তারপর রিটার্নটি প্রক্রিয়া করুন বা রিটার্নটি বন্ধ করুন।
API-এর বিবরণ
রিটার্ন আপডেট হয়েছে ট্রিগার দিয়ে Return GraphQL API অবজেক্ট ব্যবহার করে অ্যাকশন চালানো যায়। এই ট্রিগার Shopify Events রেফারেন্সে থাকা Return টপিকের update অ্যাকশনের সঙ্গে মিলে যায়। এটি শুধু পর্যবেক্ষণের জন্য নির্বাচিত ফিল্ডগুলোতে ফিল্টার করা থাকে।