Shopify का 2026-10 API: आपके इंटीग्रेशन में क्या टूट सकता है

Shopify ने 1 अक्टूबर 2026 को अपने API का वर्ज़न 2026-10 जारी किया। इसमें ज़्यादातर नए फ़ीचर हैं, जिन्हें आप ज़रूरत पड़ने तक नज़रअंदाज़ कर सकते हैं। कुछ बदलाव ऐसे हैं जो 2026-07 पर ठीक चल रहे इंटीग्रेशन को चुपचाप तोड़ सकते हैं, और वर्ज़न बदलने से पहले एक घंटा इन्हीं के लिए देना सही रहेगा।

यह वही सूची है जिससे हम अपने इंटीग्रेशन जाँचते हैं, जिनमें Odoo के लिए Shopify कनेक्टर भी शामिल है। इसमें रिलीज़ नोट्स की हर लाइन नहीं है, सिर्फ़ वे बदलाव हैं जो व्यवहार को बदलते हैं।

ऐसे बदलाव जो चुपचाप चीज़ें तोड़ देते हैं

नई कैरियर सर्विस चेकआउट पर अपने आप रेट नहीं दिखाती

carrierServiceCreate (या REST में POST carrier_services.json) से कैरियर सर्विस बनाने पर अब सिर्फ़ सर्विस रजिस्टर होती है। उसके रेट General शिपिंग प्रोफ़ाइल में नहीं जुड़ते। अगर आपका ऐप या ऑनबोर्डिंग स्क्रिप्ट कैरियर सर्विस बनाती है और मानती है कि ग्राहकों को आपके रेट दिखेंगे, तो वे नहीं दिखेंगे, जब तक आप सर्विस को खुद किसी शिपिंग प्रोफ़ाइल में न जोड़ें।

शिपिंग पता बदलने पर टैक्स दोबारा कैलकुलेट होता है

orderUpdate या REST के ऑर्डर अपडेट एंडपॉइंट से किसी unfulfilled ऑर्डर का शिपिंग पता अपडेट करने पर अब उसके टैक्स दोबारा कैलकुलेट होते हैं। यह सही व्यवहार है, लेकिन अगर आप ERP या सपोर्ट टूल से पते बदलते हैं, तो ऑर्डर का कुल अमाउंट आपके हाथ से बदल सकता है। अपडेट के बाद taxLines, totalTaxSet और बाकी टोटल दोबारा पढ़ें, और जो भुगतान या रिफ़ंड में अंतर आए उसे सेटल करें।

ड्राफ़्ट ऑर्डर के डिस्काउंट वॉर्निंग से priceRule हट गया

DraftOrderDiscountNotAppliedWarning.priceRule और पुराने PriceRule टाइप हटा दिए गए हैं। अगर आप draftOrderCalculate, draftOrderCreate या draftOrderUpdate से ड्राफ़्ट ऑर्डर बनाते हैं और यह पढ़ते हैं कि डिस्काउंट क्यों लागू नहीं हुआ, तो इसके बजाय discountTitle और discountCode चुनें।

गलत मेटाफ़ील्ड फ़िल्टर अब साफ़ एरर देते हैं

जो मेटाफ़ील्ड फ़िल्टर किया ही नहीं जा सकता, उस पर प्रोडक्ट क्वेरी चलाने पर पहले फ़िल्टर का वह हिस्सा नज़रअंदाज़ हो जाता था और सारे प्रोडक्ट लौट आते थे। अब यह एरर देता है। यह बेहतर है, लेकिन जो सिंक महीनों से “सारे प्रोडक्ट” लौटा रहा था, वह वर्ज़न बदलते ही फ़ेल होने लगेगा। जाँच लें कि आप जिन मेटाफ़ील्ड डेफ़िनिशन पर फ़िल्टर करते हैं, वे फ़िल्टरिंग को और आपके इस्तेमाल किए ऑपरेटर को सपोर्ट करती हैं।

एक वेरिएंट के एक से ज़्यादा बारकोड हो सकते हैं

ProductVariant.barcodes एक नया कनेक्शन है जिसमें 20 तक टाइप वाले बारकोड हो सकते हैं। पुराना ProductVariant.barcode डेप्रिकेट हो गया है और सिर्फ़ पहला बारकोड लौटाता है। अगर आपका वेयरहाउस या पॉइंट ऑफ़ सेल बारकोड से प्रोडक्ट मैच करता है, तो पूरी सूची पढ़ें।

एक इन्वेंटरी एरर हट गया

ITEM_NOT_STOCKED_AT_LOCATION को इन्वेंटरी म्यूटेशन और InventorySetQuantitiesUserErrorCode से हटा दिया गया है। जो कोड इस पर निर्भर करता है, वह अब बेकार है; उसे हटा दें ताकि आगे कोई इस पर निर्भर न रहे।

छोटे बदलाव, जिनके लिए अपने कोड में खोजना ठीक रहेगा

• कस्टमर सेगमेंट। = true और = false की जगह अब MATCHES और NOT MATCHES आए हैं, और 12_months_ago जैसी नामित तारीखें डेप्रिकेट हो गई हैं, उनकी जगह -12m जैसे ऑफ़सेट इस्तेमाल करें।
• SMS सहमति। SMS सहमति वाले फ़्लैट फ़ील्ड डेप्रिकेट हो गए हैं। CustomerPhoneNumber.smsMarketingConsent पढ़ें।
• रोलआउट में डिस्काउंट। जब कोई डिस्काउंट किसी रोलआउट का हिस्सा हो, तो उसके startsAt और endsAt से पता नहीं चलता कि वह लाइव है या नहीं। Discount.rollouts पढ़ने के लिए read_rollouts स्कोप चाहिए।
• फ़ुलफ़िलमेंट स्टेटस। FULFILLMENT_NOT_REQUIRED एक नई वैल्यू है। जो switch हर स्टेटस को मैप करता है, वह अपने डिफ़ॉल्ट केस में चला जाएगा।
• Customer Account API। Customer.lastIncompleteCheckout और Checkout टाइप हटा दिए गए हैं, और इनकी जगह कुछ नहीं दिया गया है।
• POS UI एक्सटेंशन। applyCartDiscount जैसे कार्ट म्यूटेशन अब रिजेक्ट हो जाते हैं अगर POS बदलाव की पुष्टि नहीं करता, और session.currentSession.staffMemberId हटा दिया गया है।

दो डेडलाइन जिनका 2026-10 से कोई संबंध नहीं है

अगर आप कोई पब्लिक ऐप मेंटेन करते हैं, तो कभी एक्सपायर न होने वाले ऑफ़लाइन एक्सेस टोकन को 1 जनवरी 2027 तक एक्सपायर होने वाले टोकन से बदलना होगा। कस्टम ऐप और वे ऐप जो कोई मर्चेंट Dev Dashboard में बनाता है, इससे बाहर हैं। और ऑनलाइन स्टोर के स्क्रिप्ट टैग 1 मार्च 2027 से चलना बंद हो जाएँगे; इसका स्टोर पर क्या असर होगा, यह हमने अलग से लिखा है।

हम अपग्रेड कैसे करते हैं

हम API वर्ज़न को एक ही जगह पिन करते हैं, इंटीग्रेशन को नए वर्ज़न पर एक डेवलपमेंट स्टोर के साथ चलाते हैं, और “Action required” से फ़िल्टर किया हुआ 2026-10 चेंजलॉग पढ़ते हैं। वर्ज़न 2026-10 कम से कम 1 अक्टूबर 2027 तक सपोर्टेड है, इसलिए समय है, लेकिन इतना भी नहीं कि चेतावनी वाले ईमेल आने तक इंतज़ार किया जाए।

अगर आपका स्टोर Odoo या किसी और सिस्टम से जुड़ा है और आप चाहते हैं कि यह काम कोई और संभाले, तो यही हमारा काम है।

आगे पढ़ें: Shopify स्क्रिप्ट टैग 1 मार्च 2027 से काम करना बंद कर देंगे। स्टोर मालिकों को क्या करना चाहिए, या Shopify को Odoo 19 Community से जोड़ना, स्टेप बाय स्टेप।