এই টিউটোরিয়ালটিতে ধাপে ধাপে দেখানো হয়েছে:
- কোন কোন ফি এবং কার্যসম্পাদনের সময় সংক্রান্ত ব্যবহারের ক্ষেত্র সমর্থিত, তার একটি সংক্ষিপ্ত বিবরণ।
- সার্ভিস ফিডের জন্য অর্ডার পূরণের সময় এবং ফি কীভাবে নির্দিষ্ট করতে হবে, সে সম্পর্কিত সুনির্দিষ্ট নির্দেশাবলী।
- নির্ভুলতার প্রত্যাশা
অর্ডার পূরণের সময় এবং ফি-এর ব্যবহার প্রদর্শনকারী একটি সম্পূর্ণ ফিড নমুনার জন্য, অর্ডারিং রিডাইরেক্ট EPA নমুনাটি দেখুন।
ফি
ফি নির্দিষ্ট করার জন্য আমরা বিভিন্ন উপায় প্রদান করি, যেমন:
- নির্দিষ্ট ফি : "ডেলিভারি ফি $5" অথবা "সার্ভিস ফি $5"
- শতাংশ ফি : 'ডেলিভারি ফি ৫%' অথবা 'সার্ভিস ফি ৫%'
- ফি-এর পরিসর : "ডেলিভারি ফি $২-$১০"
- উন্মুক্ত পরিসর "পরিষেবা ফি $২০ পর্যন্ত"
ফি ডেলিভারি ফি অথবা সার্ভিস ফি হিসেবে নির্দিষ্ট করা যেতে পারে। একাধিক ফি নির্দিষ্ট করাও সম্ভব (যেমন "সার্ভিস ফি ৫%, ডেলিভারি ফি $৫")।
যেসব ব্যবহারের ক্ষেত্রে ব্যবহারকারীর তথ্যের ভিত্তিতে ফি পরিবর্তন করার প্রয়োজন হয়, সেগুলো সমর্থিত নয়।
ফি-এর উদাহরণ
ডেলিভারি এবং পিকআপ ফি
অ্যাপ্লিকেশনটি `ডেলিভারি` এবং `সার্ভিস` ফি টাইপ সমর্থন করে।ডেলিভারি
{ "fee": { "fee_id": "12345/delivery_fee", "fee_type": "DELIVERY", "fixed_amount": { "currency_code": "USD", "units": 10, "nanos": 0 }, "service_ids": ["service/entity002"] } }
পরিষেবা
{ "fee": { "fee_id": "12345/service_fee", "fee_type": "SERVICE", "fixed_amount": { "currency_code": "USD", "units": 10, "nanos": 0 }, "service_ids": ["service/entity002"] } }
বিভিন্ন ধরণের ফি
নির্বাচিত ফি-এর ধরণ নির্দিষ্ট করার জন্য ব্যবহারযোগ্য কিছু উদাহরণ নিচে দেওয়া হলো।স্থির
{ "fee": { "fee_id": "12345/delivery_fee", "fee_type": "DELIVERY", "fixed_amount": { "currency_code": "USD", "units": 10, "nanos": 0 }, "service_ids": ["service/entity002"] } }
কার্ট শতাংশ
{ "fee": { "fee_id": "12345/delivery_fee", "fee_type": "DELIVERY", "cart_percentage": { "base_value": { "currency_code": "USD", "units": 3, "nanos": 500000000 }, "percentage_of_cart_value": 10 }, "service_ids": [ "service/entity002" ] } }
পরিসর
{ "fee": { "fee_id": "12345/delivery_fee", "fee_type": "DELIVERY", "range_amount": { "min_amount": { "currency_code": "USD", "units": 3, "nanos": 500000000 }, "max_amount": { "currency_code": "USD", "units": 5, "nanos": 600000000 } }, "service_ids": [ "service/entity002" ] } }
পূরণের সময়
আপনি যাতে সঠিক ডেটা প্রদান করতে পারেন, তা নিশ্চিত করতে আমরা উপলব্ধতার সময় নির্দিষ্ট করার জন্য বিভিন্ন ফরম্যাটের সুযোগ দিই। নিম্নলিখিত বিষয়গুলিতে সমর্থিত বিভিন্ন ব্যবহারের ক্ষেত্র বর্ণনা করা হয়েছে, সাথে কিছু উদাহরণমূলক ভাষাও দেওয়া হয়েছে যা ব্যবহারকারী ফ্রন্টএন্ডে দেখতে পাবেন।
- নির্দিষ্ট সময় : "৩০ মিনিটের মধ্যে ডেলিভারি" অথবা "১৫ মিনিটের মধ্যে পিকআপ"
- সময়সীমা : "৩০ মিনিট - ১ ঘণ্টার মধ্যে ডেলিভারি" অথবা "১৫-২০ মিনিটের মধ্যে পিকআপ"
পিকআপ এবং ডেলিভারি উভয়ের জন্যই একটি সাধারণ ফরম্যাট (নিচে বর্ণিত) ব্যবহার করে অর্ডার পূরণের সময় নির্দিষ্ট করা যেতে পারে।
যেসব ব্যবহারের ক্ষেত্রে ব্যবহারকারীর তথ্যের ভিত্তিতে আনুমানিক আগমনের সময় (ETA) পরিবর্তন করার প্রয়োজন হয়, সেগুলো সমর্থিত নয়।
পূরণের সময়ের উদাহরণ
অ্যাকশন লিঙ্কগুলির জন্য অর্ডার পূরণের সময়, সার্ভিসেস ফিডের ETA মেসেজে, FoodOrderingService ফিল্ডের অংশ হিসেবে অন্তর্ভুক্ত থাকে।
স্থির
{ "service": { "service_id": "service-id", "service_type": "TAKEOUT", "parent_entity_id": "entity-id", "lead_time": { "min_lead_time_duration": "900s" }, "action_link_id": "action-link-id" } },
সময়সীমা
{ "service": { "service_id": "service-id", "service_type": "TAKEOUT", "parent_entity_id": "entity-id", "lead_time": { "min_lead_time_duration": "900s" "max_lead_time_duration": "1200s" }, "action_link_id": "action-link-id" } },
পূরণের সময়সীমা
ServiceHours মাধ্যমে একটি নির্দিষ্ট সময়সীমার জন্য অর্ডার পূরণের সময় নির্ধারণ করা যায়। সার্ভিস আওয়ারের সময়সীমার বাইরে থাকলে FoodOrderingService এ সেট করা ডিফল্ট lead_time ব্যবহৃত হয়।
2400s lead_time সকাল ১১:০০টা থেকে দুপুর ১:৩০টা পর্যন্ত প্রদর্শিত হবে।1200s lead_time সকাল ১১:০০টার আগে এবং দুপুর ১:৩০টার পরে প্রদর্শিত হবে। { "data": [ { "service": { "service_id": "merchant-1-service-delivery", "service_type": "DELIVERY", "parent_entity_id": "merchant-1", "lead_time": { "min_lead_time_duration": "1200s" }, "action_link_id": "merchant-1-takeout-delivery-action" } }, { "service_hours": { "hours_id": "merchant-1-advance-hours-delivery", "service_ids": ["merchant-1-service-delivery"], "asap_hours": [ { "time_windows": { "time_windows": { "open_time": { "hours": 11 }, "close_time": { "hours": 13, "minutes": 30 } } }, "lead_time": { "min_lead_time_duration": "2400s" } } ] } } ] }
ফি এবং পূরণের সময়ের নির্ভুলতা
ফি নির্ভুলতা
যখন আপনি কোনো মার্চেন্টের জন্য ফি-সংক্রান্ত তথ্য প্রদান করেন, তখন আমরা আশা করি আপনি আপনার ফি-এর একটি সঠিক চিত্র তুলে ধরবেন। একটি অর্ডারের ক্ষেত্রে প্রযোজ্য হতে পারে এমন সমস্ত ডেলিভারি এবং সার্ভিস ফি আপনার অন্তর্ভুক্ত করা উচিত।
আমরা স্বীকার করি যে সময়ের সাথে সাথে এবং ব্যবহারকারীভেদে ফি পরিবর্তিত হতে পারে। এই কারণে আমরা ফি-কে একটি পরিসীমা হিসেবে নির্দিষ্ট করার সুযোগ দিই, যার মধ্যে উন্মুক্ত পরিসীমাও অন্তর্ভুক্ত। যেসব ক্ষেত্রে ফি উল্লেখযোগ্যভাবে পরিবর্তিত হতে পারে, সেখানে নিশ্চিত করুন যে প্রদত্ত পরিসীমাটি একজন ব্যবহারকারীর লেনদেনের সময় দেখতে পাওয়া সম্ভাব্য ফি-কে অন্তর্ভুক্ত করে।
আপনার ক্ষেত্রে নির্দিষ্টভাবে কী প্রয়োজন, সে বিষয়ে আপনি যদি অনিশ্চিত থাকেন, তাহলে আপনার অ্যাকশনস সেন্টার কন্ট্যাক্টের সাথে যোগাযোগ করুন।
অর্ডার পূরণের সময়ের নির্ভুলতা
আমরা বুঝি যে, বিভিন্ন কারণের উপর ভিত্তি করে অর্ডার সম্পন্ন করার নির্দিষ্ট সময় পরিবর্তিত হয়। এই কারণগুলোর মধ্যে রয়েছে:
- অর্ডারের আকারের উপর ভিত্তি করে অর্ডার পূরণের সময় পরিবর্তন
- অর্ডার সম্পন্ন করতে এবং চেকআউট করতে লাগা সময়ের উপর ভিত্তি করে অর্ডার পূরণের সময়ে পরিবর্তন।
- ফিডের মাধ্যমে অর্ডার পূরণের সময় পরিবর্তনের আপডেট হওয়ার মধ্যবর্তী বিলম্ব
- ব্যবহারকারীর ডেলিভারি ঠিকানা।
এই কারণগুলোর যেকোনোটির ফলে এমন পরিস্থিতি তৈরি হতে পারে যেখানে ব্যবহারকারীকে প্রাথমিকভাবে দেখানো অর্ডার পূরণের সময়টি, চেকআউটের সময় দেখা সঠিক সময় নাও হতে পারে। অর্ডার পূরণের সময় বাস্তবায়নের লক্ষ্য এগুলোকে সম্পূর্ণরূপে দূর করা নয়, বরং ব্যবহারকারীদের যতবার সম্ভব স্পষ্ট তথ্য প্রদান করা।
পার্টনারদের কাছ থেকে এমন একটি বাস্তবায়ন আশা করা হচ্ছে, যার মাধ্যমে সর্বোচ্চ প্রচেষ্টার ভিত্তিতে ব্যবহারকারীদের কাছে যথাসম্ভব সঠিক ফুলফিলমেন্ট টাইম প্রদর্শিত হবে। যদি এই কারণগুলোর জন্য সময়ে উল্লেখযোগ্য তারতম্য থাকে, তবে আমরা পরামর্শ দিচ্ছি যে আপনি এমন একটি সময়ের পরিসর প্রদান করুন যা সেই তারতম্যকে অন্তর্ভুক্ত করে। এছাড়াও, অর্ডারের বিবরণের কারণে যদি ফুলফিলমেন্ট টাইম পরিবর্তিত হয়, তবে আপনার অর্ডারিং ফ্লো-তে আসার সাথে সাথেই ব্যবহারকারীদের কাছে তা স্পষ্টভাবে দেখানো উচিত।
আপনার ক্ষেত্রে নির্দিষ্টভাবে কী প্রয়োজন, সে বিষয়ে আপনি যদি অনিশ্চিত থাকেন, তাহলে আপনার অ্যাকশনস সেন্টার কন্ট্যাক্টের সাথে যোগাযোগ করুন।
ফি এবং আনুমানিক আগমনের সময়ের হালনাগাদ
সাধারণ ফিড আপলোডের মাধ্যমে করা যেকোনো পরিবর্তন প্রক্রিয়া হতে কমপক্ষে ২ ঘন্টা সময় লাগতে পারে। আপনি যদি ঘন ঘন ETA (আনুমানিক আগমনের সময়) পরিবর্তন করার পরিকল্পনা করেন, তবে এই বিষয়টি বিশেষভাবে মনে রাখা গুরুত্বপূর্ণ।
পার্টনারদের রিয়েল-টাইম আপডেট বাস্তবায়ন করতে বিশেষভাবে উৎসাহিত করা হচ্ছে, যা একটি এপিআই কলের মাধ্যমে ৫ মিনিট বা তারও কম সময়ের মধ্যে সার্ভিস ফিড (ফি এবং আনুমানিক সময়সহ) পরিবর্তন করতে সক্ষম করে।