ডেলিভারি API কানেকশন: কীভাবে কাজ করে
একটি ডেলিভারি প্ল্যাটফর্মের পার্টনার API যুক্ত করে: তাদের অর্ডার ওয়েবহুকে প্ল্যাটফর্মের নম্বরসহ সরাসরি কিচেন ডিসপ্লেতে আসে, আর অর্ডারের অবস্থা, মেনু, শেষ হয়ে যাওয়া আইটেম ও স্টোর খোলা / বন্ধ প্ল্যাটফর্মে ফিরে যায়। কমিশন ও পেআউট Delivery platforms পেজেই থাকে।
পাঠ 3 / 12 · কীভাবে কাজ করে
কীভাবে কাজ করে
«Add a connection»-এ একটি কানেকশন যোগ করুন: Deliveroo, Talabat / foodpanda (Delivery Hero POS) ও Uber Eats-এর পার্টনার API আছে; Careem, Noon Food ও Zomato কোনো API প্রকাশ করেনি, তাই সেগুলো শুধু সিমুলেটেড চলে — তাদের জন্য মিডলওয়্যারের মাধ্যমে «Generic webhook contract» বা CSV / ই-মেইল ইনটেক ব্যবহার করুন।
প্ল্যাটফর্ম যে ক্রেডেনশিয়াল দিয়েছে তা সংরক্ষণ করুন এবং প্ল্যাটফর্মে ওয়েবহুক ঠিকানাটি নিবন্ধন করুন। প্রতিটি বার্তার সিগনেচার পরীক্ষা হয়; সাইন ছাড়া বা বদলানো বার্তা প্রত্যাখ্যাত হয়।
«Menu» ট্যাবে আইটেমগুলো প্ল্যাটফর্মের আইটেম আইডিসহ রাখুন; «Push menu» প্ল্যাটফর্মের দামে সেগুলো পাঠায়, আর কিচেনের শেষ-হয়ে-যাওয়া সুইচ নিজে থেকেই চলে যায়।
একটি অর্ডার সাধারণ প্ল্যাটফর্ম অর্ডার হয়: স্টক ও রেসিপি, প্ল্যাটফর্মের নাম ও নম্বরসহ কিচেন টিকিট, অর্ডারে কমিশন, পেআউটের অপেক্ষায়। একই প্ল্যাটফর্ম অর্ডার কখনো দুবার নেওয়া হয় না।
Accept, reject, ready ও picked up আছে «Orders» ট্যাবে (অথবা «Accept orders automatically» দিয়ে নিজে থেকে); কিচেন শেষ টিকিট শেষ করলে «Ready»-ও পাঠানো হয়।
যে অর্ডারে এখানকার মেনুতে নেই এমন আইটেম আছে তা আটকে রাখা হয় এবং একটি টাস্ক খোলে — কখনো অনুমান করে কিচেনে পাঠানো হয় না। প্ল্যাটফর্ম বাতিল করলে কিচেন টিকিট থামে এবং একটি টাস্ক খোলে।
কোথায় পাবেন
- Point of sale → Tables → Delivery API connections
/admin/pos/platforms/connections - Generic webhook contract
/admin/pos/platforms/connections?tab=generic
যে সেটিংস এটি বদলায়
- Platforms & prices
/admin/pos/platforms?tab=platforms
চেকলিস্ট
এগোনোর আগে দেখে নিন, আপনি পারেন:
- Point of sale → Tables → Delivery API connections খুলতে
- Add a connection-এ একটি কানেকশন যোগ করুন: Deliveroo, Talabat / foodpanda (Delivery Hero POS) ও Uber Eats-এর…
- প্ল্যাটফর্ম যে ক্রেডেনশিয়াল দিয়েছে তা সংরক্ষণ করুন এবং প্ল্যাটফর্মে ওয়েবহুক ঠিকানাটি নিবন্ধন করুন।
- Menu ট্যাবে আইটেমগুলো প্ল্যাটফর্মের আইটেম আইডিসহ রাখুন; Push menu প্ল্যাটফর্মের দামে সেগুলো পাঠায়, আর…
- একটি অর্ডার সাধারণ প্ল্যাটফর্ম অর্ডার হয়: স্টক ও রেসিপি, প্ল্যাটফর্মের নাম ও নম্বরসহ কিচেন টিকিট, অর্ডারে…
টিপস ও সাধারণ ভুল
- আসল ক্রেডেনশিয়ালের আগে «Simulator» ট্যাব থেকে টেস্ট অর্ডার পাঠান — সেগুলো সিগনেচারসহ পুরো পথ পার হয়।
- সময়মতো গ্রহণ না করা অর্ডার যদি প্ল্যাটফর্ম বাতিল করে, তবে «Accept orders automatically» চালু করুন।
- Uber Eats-এ ready / picked-up কল নেই: সেগুলো শুধু এখানে রেকর্ড হয়।