डिलीवरी API कनेक्शन: कैसे काम करता है
किसी डिलीवरी प्लेटफ़ॉर्म के पार्टनर API से जोड़ता है: उसके ऑर्डर webhook से सीधे किचन डिस्प्ले पर प्लेटफ़ॉर्म के नंबर के साथ आते हैं, और ऑर्डर स्टेटस, मेन्यू, ख़त्म हो चुके आइटम और स्टोर खुला / बंद प्लेटफ़ॉर्म को वापस जाते हैं। कमीशन और पेआउट 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 / ई-मेल इनटेक इस्तेमाल करें।
प्लेटफ़ॉर्म से मिले क्रेडेंशियल सेव करें और प्लेटफ़ॉर्म पर webhook पता रजिस्टर करें। हर संदेश के सिग्नेचर की जाँच होती है; बिना सिग्नेचर या छेड़छाड़ वाले संदेश अस्वीकार होते हैं।
«Menu» टैब पर आइटम उनकी प्लेटफ़ॉर्म आइटम id के साथ डालें; «Push menu» उन्हें प्लेटफ़ॉर्म की कीमत के साथ भेजता है, और किचन से ख़त्म होने के स्विच अपने आप चले जाते हैं।
ऑर्डर एक सामान्य प्लेटफ़ॉर्म ऑर्डर बन जाता है: स्टॉक और रेसिपी, प्लेटफ़ॉर्म के नाम और नंबर वाला किचन टिकट, ऑर्डर पर कमीशन, पेआउट का इंतज़ार। वही प्लेटफ़ॉर्म ऑर्डर कभी दो बार नहीं लिया जाता।
स्वीकार, अस्वीकार, तैयार और उठा लिया गया «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 के…
- प्लेटफ़ॉर्म से मिले क्रेडेंशियल सेव करें और प्लेटफ़ॉर्म पर webhook पता रजिस्टर करें।
- Menu टैब पर आइटम उनकी प्लेटफ़ॉर्म आइटम id के साथ डालें; Push menu उन्हें प्लेटफ़ॉर्म की कीमत के साथ भेजता…
- ऑर्डर एक सामान्य प्लेटफ़ॉर्म ऑर्डर बन जाता है: स्टॉक और रेसिपी, प्लेटफ़ॉर्म के नाम और नंबर वाला किचन टिकट,…
टिप्स और आम गलतियाँ
- असली क्रेडेंशियल इस्तेमाल करने से पहले «Simulator» टैब से टेस्ट ऑर्डर भेजें — वे सिग्नेचर समेत पूरे रास्ते से गुज़रते हैं।
- अगर प्लेटफ़ॉर्म वे ऑर्डर रद्द कर देता है जिन्हें आपने समय पर स्वीकार नहीं किया, तो «Accept orders automatically» चालू करें।
- Uber Eats में तैयार / उठा लिया गया के लिए कोई कॉल नहीं है: वे सिर्फ़ यहीं दर्ज होते हैं।