Odoo + Shopify सिंक: उत्पाद, ऑर्डर और इन्वेंटरी

शॉपिफाई के पास समस्त अमेरिकी ईकॉमर्स राजस्व का 10% से अधिक का अधिकार है। Odoo 19 Enterprise को अपनी परिचालन रीढ़ के रूप में और Shopify को अपने ग्राहक-सामना वाले स्टोरफ्रंट के रूप में उपयोग करने वाले व्यवसायों के लिए, दोनों प्रणालियों को सिंक्रनाइज़ रखना गैर-परक्राम्य है - डिस्कनेक्ट किए गए सिस्टम का अर्थ है इन्वेंट्री त्रुटियां, ऑर्डर प्रोसेसिंग में देरी और लेखांकन सिरदर्द।

यह मार्गदर्शिका संपूर्ण Odoo-Shopify एकीकरण को कवर करती है: आर्किटेक्चर निर्णय, उत्पाद कैटलॉग सिंक्रनाइज़ेशन, वास्तविक समय ऑर्डर आयात, द्विदिश इन्वेंट्री प्रबंधन, Shopify भुगतान समाधान और मल्टी-स्टोर प्रबंधन।

मुख्य बातें

• Shopify के REST और GraphQL API दोनों समर्थित हैं; Shopify Plus के लिए GraphQL को प्राथमिकता दी गई
• उत्पाद सिंक द्विदिशात्मक है: Odoo में बनाएं → Shopify पर प्रकाशित करें, या Shopify से आयात करें
• इन्वेंटरी सिंक इवेंट-संचालित है: ओडू में प्रत्येक स्टॉक मूवमेंट पर ट्रिगर
• Shopify से Odoo तक ऑर्डर वेबहुक लगभग तत्काल ऑर्डर आयात प्रदान करता है (<30 सेकंड)
• शॉपिफाई पेमेंट्स समाधान भुगतान, शुल्क और रिफंड को स्वचालित रूप से संभालता है
• मल्टी-लोकेशन इन्वेंट्री Shopify के मल्टी-लोकेशन फीचर के साथ सिंक हो जाती है
• शॉपिफाई प्लस बी2बी (थोक) कैटलॉग ओडू की मूल्य सूची से लिंक करते हैं
• स्वचालित स्टॉक समायोजन के साथ Shopify से Odoo RMA तक रिटर्न प्रवाह

---

एकीकरण वास्तुकला

एपीआई दृष्टिकोण:

एकीकरण अधिकांश संचालन के लिए Shopify के REST एडमिन एपीआई और इवेंट-संचालित अपडेट के लिए वेबहुक का उपयोग करता है:

• रेस्ट एपीआई: उत्पाद सीआरयूडी, ऑर्डर रीड, इन्वेंट्री प्रबंधन
• ग्राफक्यूएल एपीआई: थोक संचालन (बड़े कैटलॉग निर्यात), बी2बी मूल्य निर्धारण (शॉपिफाई प्लस)
• वेबहुक: वास्तविक समय ऑर्डर निर्माण, ऑर्डर अपडेट, रिफंड निर्माण, इन्वेंट्री स्तर अपडेट

कनेक्शन टोपोलॉजी:

Odoo 19 (ERP Backend)
    ↕ Product, Inventory, Price
Shopify Admin API / Webhooks
    ↕ Real-time events
Shopify Storefront (Customer-facing)

प्रमाणीकरण:

Shopify निजी ऐप API कुंजी या कस्टम ऐप OAuth का उपयोग करता है:

• निजी ऐप: सरल, एकल-स्टोर एकीकरण के लिए अनुशंसित
• कस्टम ऐप (OAuth): शॉपिफाई ऐप स्टोर वितरण या मल्टी-स्टोर प्रबंधन के लिए आवश्यक

ECOSIRE कनेक्टर के लिए, Shopify के पार्टनर डैशबोर्ड में एक कस्टम ऐप कॉन्फ़िगर करें।

---

शॉपिफाई ऐप कॉन्फ़िगरेशन

चरण 1: Shopify में एक कस्टम ऐप बनाएं

1. अपने Shopify एडमिन → सेटिंग्स → ऐप्स और सेल्स चैनल पर जाएं
2. ऐप्स विकसित करें → एक ऐप बनाएं पर क्लिक करें
3. ऐप का नाम सेट करें (उदाहरण के लिए, "ओडू इंटीग्रेशन")
4. एपीआई स्कोप कॉन्फ़िगर करें:

   read_products, write_products
   read_orders, write_orders
   read_inventory, write_inventory
   read_shipping, write_shipping
   read_customers, write_customers
   read_fulfillments, write_fulfillments
   read_locations
   read_price_rules, write_price_rules
   

5. वेबहुक यूआरएल सेट करें: https://your-odoo.com/shopify/webhook
6. ऐप इंस्टॉल करें → कॉपी करें एडमिन एपीआई एक्सेस टोकन

चरण 2: ओडू में कॉन्फ़िगर करें

सेल्स → शॉपिफाई या इन्वेंटरी → शॉपिफाई स्टोर्स पर नेविगेट करें:

चरण 3: वेबहुक पंजीकृत करें

कॉन्फ़िगरेशन सहेजने के बाद, वेबहुक पंजीकृत करें पर क्लिक करें। कनेक्टर इसकी सदस्यता लेता है:

• orders/create
• orders/updated
• orders/paid
• orders/fulfilled
• orders/partially_fulfilled
• orders/cancelled
• refunds/create
• inventory_levels/update
• products/update

---

उत्पाद कैटलॉग सिंक्रनाइज़ेशन

सिंक दिशा विकल्प:

अनुशंसित: नई तैनाती के लिए Odoo → Shopify। Odoo का उत्पाद मास्टर समृद्ध डेटा (खरीदारी जानकारी, लागत, BOM) प्रदान करता है जिसकी Shopify को आवश्यकता नहीं है।

उत्पाद फ़ील्ड मानचित्रण:

वेरिएंट सिंक्रोनाइज़ेशन:

शॉपिफाई प्रति उत्पाद अधिकतम 100 वेरिएंट के साथ 3 उत्पाद विकल्पों (रंग, आकार, सामग्री) का समर्थन करता है। कनेक्टर Odoo की उत्पाद विशेषताओं को मैप करता है:

1. Odoo product.template → Shopify उत्पाद
2. Odoo product.product (वेरिएंट) → शॉपिफाई वेरिएंट
3. Odoo विशेषता मान → Shopify विकल्प मान

बल्क कैटलॉग सिंक:

बड़े कैटलॉग (1000+ उत्पाद) के साथ प्रारंभिक सेटअप के लिए:

1. Shopify → कैटलॉग → बल्क सिंक पर नेविगेट करें
2. सिंक करने के लिए उत्पाद श्रेणियां चुनें
3. बल्क सिंक कार्य चलाएँ (पृष्ठभूमि प्रक्रिया)
4. सिंक लॉग में प्रगति की निगरानी करें
5. किसी भी मैपिंग त्रुटि की समीक्षा करें और उसका समाधान करें

---

ऑर्डर प्रबंधन

वेबहुक के माध्यम से वास्तविक समय ऑर्डर आयात:

जब कोई ग्राहक Shopify पर ऑर्डर देता है, तो orders/create वेबहुक सेकंड के भीतर सक्रिय हो जाता है। कनेक्टर:

1. Shopify से वेबहुक पेलोड प्राप्त करता है
2. वेबहुक हस्ताक्षर सत्यापित करता है (HMAC-SHA256)
3. Odoo में तुरंत बिक्री ऑर्डर बनाता है
4. Shopify पर 200 OK लौटाता है (पुनः प्रयास करने से रोकता है)

Shopify चेकआउट से Odoo बिक्री ऑर्डर तक का अंत-से-अंत समय: आमतौर पर 3-15 सेकंड।

डेटा मैपिंग ऑर्डर करें:

कस्टम ऑर्डर फ़ील्ड:

कस्टम चेकआउट विशेषताओं वाले शॉपिफाई प्लस व्यापारियों के लिए:

• मैप शॉपिफाई ऑर्डर नोट विशेषताएँ ओडू कस्टम फ़ील्ड के लिए
• उदाहरण: बिक्री आदेश पर "पीओ नंबर" विशेषता → x_purchase_order_number
• उदाहरण: "उपहार संदेश" → बिक्री आदेश पर note

ऑर्डर प्रोसेसिंग वर्कफ़्लो:

आयात के बाद, कनेक्टर ओडू के मानक वर्कफ़्लो के माध्यम से ऑर्डर का प्रबंधन करता है:

1. बिक्री आदेश की पुष्टि की गई
2. Odoo WMS में डिलीवरी ऑर्डर बनाया गया
3. गोदाम चयन, पैक, जहाज
4. ओडू में डिलीवरी मान्य (ट्रैकिंग दर्ज की गई)
5. कनेक्टर ट्रैकिंग नंबर के साथ Shopify को पूर्ति भेजता है
6. Shopify ऑर्डर को "पूरा हुआ" के रूप में चिह्नित करता है और ग्राहक को ईमेल करता है

आंशिक पूर्तियाँ:

शॉपिफाई कई पूर्तियों वाले ऑर्डर का समर्थन करता है (जो अभी उपलब्ध है उसे शिप करें, बाकी बाद में)। कनेक्टर संभालता है:

• ओडू में आंशिक डिलीवरी → शॉपिफाई को आंशिक पूर्ति भेजी गई
• Shopify ग्राहक को आंशिक पूर्ति स्थिति दिखाता है
• शेष आइटम स्टॉक उपलब्ध होने पर एक अलग डिलीवरी बनाते हैं

---

इन्वेंटरी सिंक्रोनाइज़ेशन

द्विदिशात्मक इन्वेंट्री सिंक:

सटीकता बनाए रखने के लिए इन्वेंटरी दोनों दिशाओं में बहती है:

Odoo → Shopify (प्राथमिक दिशा):

• Odoo में प्रत्येक स्टॉक चाल Shopify के लिए एक इन्वेंट्री स्तर अपडेट ट्रिगर करती है
• उपलब्ध मात्रा = हाथ पर - आरक्षित - सुरक्षा स्टॉक
• शॉपिफाई के इन्वेंटरी लेवल एपीआई के माध्यम से अपडेट

Shopify → Odoo (फ़ॉलबैक):

• यदि Shopify इन्वेंट्री को मैन्युअल रूप से समायोजित किया जाता है (एडमिन या ऐप), तो वेबहुक सक्रिय हो जाता है
• कनेक्टर ऑडिट नोट के साथ एक ओडू इन्वेंट्री समायोजन बनाता है

दुकानदारी बहु-स्थान:

शॉपिफाई का मल्टी-लोकेशन फीचर प्रत्येक भौतिक स्थान पर इन्वेंट्री को ट्रैक करता है। शॉपिफाई स्थानों के लिए ओडू गोदामों का मानचित्र बनाएं:

कनेक्टर वेयरहाउस-लोकेशन मैपिंग के आधार पर प्रति-स्थान मात्रा को Shopify पर भेजता है।

इन्वेंटरी सटीकता सुरक्षा उपाय:

• सुरक्षा स्टॉक बफ़र Shopify को सभी उपलब्ध इन्वेंट्री दिखाने से रोकता है
• आउट-ऑफ-स्टॉक प्रबंधन: जब मात्रा 0 तक पहुंच जाती है, तो Shopify इन्वेंट्री = 0 (नकारात्मक नहीं)
• स्टॉक से बाहर होने पर बिक्री जारी रखें: प्रति उत्पाद कॉन्फ़िगर करने योग्य (कुछ विक्रेता बैकऑर्डर की अनुमति देते हैं)

---

शॉपिफाई भुगतान समाधान

Shopify भुगतान शुल्क संरचना:

भुगतान समाधान:

शॉपिफाई पेमेंट्स हर 2-3 व्यावसायिक दिनों में आपके बैंक खाते में भेज देता है। कनेक्टर पेआउट डेटा आयात करता है:

1. शॉपिफाई पेमेंट्स पेआउट रिपोर्ट डाउनलोड करें (या एपीआई के माध्यम से)
2. Shopify → वित्त → आयात भुगतान के माध्यम से आयात करें
3. कनेक्टर जर्नल प्रविष्टियाँ बनाता है:

• राजस्व (प्रति ऑर्डर शुद्ध बिक्री राशि)
• शॉपिफाई शुल्क व्यय (भुगतान प्रसंस्करण)
• समायोजन की वापसी
• शुद्ध भुगतान प्राप्य

4. जब बैंक हस्तांतरण आता है: शॉपिफाई पेमेंट्स जर्नल से मिलान करें

Shopify रिफंड को संभालना:

जब Shopify में रिफंड संसाधित किया जाता है:

1. refunds/create वेबहुक में आग लग जाती है
2. कनेक्टर मूल चालान के विरुद्ध ओडू में एक क्रेडिट नोट बनाता है
3. यदि स्टॉक वापस कर दिया गया (पुनः स्टॉक किया गया): रिटर्न ट्रांसफर बनाता है
4. पोस्ट क्रेडिट नोट → ग्राहक के खाते से शेष राशि का भुगतान

---

शॉपिफाई प्लस बी2बी इंटीग्रेशन

शॉपिफाई प्लस में बी2बी सुविधाएं (थोक कैटलॉग, भुगतान शर्तें, शुद्ध भुगतान) शामिल हैं। कनेक्टर इन्हें Odoo के B2B मूल्य निर्धारण के साथ एकीकृत करता है:

कंपनी और कैटलॉग मैपिंग:

सिंक बी2बी मूल्य निर्धारण:

1. कनेक्टर में एक Shopify B2B कैटलॉग बनाएं
2. ओडू मूल्य सूची से लिंक करें
3. Shopify B2B कंपनियों को असाइन करें
4. Odoo मूल्य सूची में मूल्य परिवर्तन → स्वचालित रूप से Shopify B2B कैटलॉग में धकेल दिया जाता है

---

मल्टी-स्टोर प्रबंधन

अनेक Shopify स्टोर संचालित करने वाले ब्रांडों के लिए (क्षेत्र, ब्रांड, थोक बनाम खुदरा):

एकाधिक स्टोर कॉन्फ़िगरेशन:

प्रत्येक Shopify स्टोर के लिए अलग कनेक्टर कॉन्फ़िगरेशन बनाएं:

• प्रति स्टोर अलग-अलग एपीआई क्रेडेंशियल
• स्टोर-विशिष्ट उत्पाद दृश्यता (कुछ उत्पाद सभी दुकानों में, कुछ विशिष्ट में)
• स्टोर-विशिष्ट मूल्य निर्धारण (क्षेत्रीय मूल्य निर्धारण, थोक बनाम खुदरा)
• स्टोर-विशिष्ट इन्वेंट्री आवंटन

दुकानों में इन्वेंटरी आवंटन:

Available for Store A = On-Hand - Reserve for Store B - Reserve for Store C - Safety Stock

जब कई स्टोर एक ही इन्वेंट्री से पैसा निकालते हैं तो ओवरसेलिंग को रोकने के लिए आवंटन नियमों को कॉन्फ़िगर करें।

---

अक्सर पूछे जाने वाले प्रश्न

कनेक्टर कस्टम डेटा के लिए Shopify के उत्पाद मेटाफ़ील्ड को कैसे संभालता है?

शॉपिफाई मेटाफ़ील्ड उत्पादों, ऑर्डर और ग्राहकों पर कस्टम डेटा संग्रहीत करता है। कनेक्टर विशिष्ट Odoo फ़ील्ड को Shopify मेटाफ़ील्ड में मैप करता है। उदाहरण के लिए, Odoo के x_care_instructions फ़ील्ड को product.care_instructions मेटाफ़ील्ड में मैप करें। प्रति संसाधन प्रकार के लिए कनेक्टर की उन्नत सेटिंग्स में मेटाफ़ील्ड मैपिंग कॉन्फ़िगर करें।

क्या कनेक्टर Shopify के सब्सक्रिप्शन उत्पादों (Shopify सब्सक्रिप्शन या रीचार्ज) को संभाल सकता है?

स्टैंडर्ड शॉपिफाई सब्सक्रिप्शन ऑर्डर ओडू में नियमित ऑर्डर के रूप में आयात करते हैं। रीचार्ज सदस्यता के लिए, आवर्ती ऑर्डर व्यक्तिगत orders/create वेबहुक के रूप में सक्रिय होते हैं और सामान्य रूप से आयात होते हैं। कनेक्टर Shopify में सदस्यता जीवनचक्र का प्रबंधन नहीं करता है - यह प्रत्येक ऑर्डर को संसाधित करता है, चाहे वह सदस्यता-जनित हो या एक बार का हो।

यदि Shopify वेबहुक चालू होने पर Odoo सर्वर डाउन हो जाता है तो क्या होता है?

शॉपिफाई ने 48 घंटों में 19 बार तक असफल वेबहुक पुनः प्रयास किया। ओडू के ठीक होने पर कनेक्टर वेबहुक को प्रोसेस करता है और ऑर्डर आयात करता है। मिशन-महत्वपूर्ण विश्वसनीयता के लिए, ओडू को अनावश्यक बुनियादी ढांचे (लोड बैलेंसर + एकाधिक कर्मचारी) और डाउनटाइम के लिए निगरानी अलर्ट के साथ कॉन्फ़िगर करें। 48 घंटे की पुनः प्रयास विंडो नियोजित रखरखाव के लिए एक बफर प्रदान करती है।

क्या कनेक्टर शॉपिफाई मार्केट्स (बहु-मुद्रा अंतर्राष्ट्रीय बिक्री) का समर्थन करता है?

हाँ। शॉपिफाई मार्केट्स एक ही स्टोर से कई मुद्राओं में बिक्री की अनुमति देता है। कनेक्टर खरीदार की चेकआउट मुद्रा में ऑर्डर आयात करता है और ओडू में उस मुद्रा में बिक्री ऑर्डर बनाता है। मुद्रा रूपांतरण ऑर्डर आयात के समय विनिमय दर का उपयोग करता है। सटीक स्थानीय मूल्य निर्धारण के लिए ओडू में प्रत्येक शॉपिफाई मार्केट के लिए अलग-अलग मूल्य सूची कॉन्फ़िगर करें।

मैं Odoo में Shopify उपहार कार्ड कैसे प्रबंधित करूं?

शॉपिफाई गिफ्ट कार्ड ऑर्डर पर भुगतान विधि के रूप में दिखाई देते हैं। कनेक्टर प्रत्येक ऑर्डर के उपहार कार्ड भाग के लिए एक अलग भुगतान लाइन बनाता है। ओडू में "शॉपिफाई गिफ्ट कार्ड्स" देयता खाता कॉन्फ़िगर करें। जब कोई उपहार कार्ड बेचा जाता है (उपहार कार्ड उत्पाद के माध्यम से), तो राजस्व स्थगित कर दिया जाता है। जब किसी ऑर्डर पर भुनाया जाता है, तो दायित्व साफ़ हो जाता है और राजस्व मान्यता प्राप्त हो जाती है।

---

अगले चरण

एक अच्छी तरह से निष्पादित Odoo-Shopify एकीकरण अदृश्य हो जाता है - यह बस काम करता है, दोनों प्रणालियों को मैन्युअल हस्तक्षेप के बिना सिंक्रनाइज़ रखता है। ECOSIRE टीम ने प्रतिदिन 50 ऑर्डर संसाधित करने वाले D2C ब्रांडों से लेकर प्रतिदिन 10,000 ऑर्डर संभालने वाले उद्यम खुदरा विक्रेताओं तक हर चीज़ के लिए Shopify-Odoo एकीकरण बनाया है।

अपने Shopify-Odoo एकीकरण के बारे में ECOSIRE से संपर्क करें →

ECOSIRE की Shopify सेवाओं का अन्वेषण करें →

अपने स्टोर के विवरण और वर्तमान समस्याएँ साझा करें और हमारी टीम एक Shopify-Odoo एकीकरण का दायरा बनाएगी जो आपके ERP और आपके स्टोरफ्रंट के बीच के अंतर को समाप्त कर देगा।