ה-API של Shopify בגרסה 2026-10: מה עלול להישבר באינטגרציות שלכם

ב-1 באוקטובר 2026 Shopify פרסמה את גרסה 2026-10 של ה-APIs שלה. רובה פיצ'רים חדשים שאפשר להתעלם מהם עד שצריך אותם. מספר קטן של שינויים יכול לשבור בשקט אינטגרציה שעבדה בלי בעיה על 2026-07, ואלה השינויים ששווה להקדיש להם שעה לפני שמעלים גרסה.

זו הרשימה שאנחנו בודקים מול האינטגרציות שלנו, כולל מחבר Shopify ל-Odoo. היא לא כוללת כל שורה בהערות הגרסה, רק את השינויים שמשנים התנהגות.

שינויים ששוברים דברים בשקט

שירותי משלוח חדשים לא מציגים תעריפים בקופה מעצמם

יצירת carrier service באמצעות carrierServiceCreate (או POST carrier_services.json ב-REST) רק רושמת את השירות. היא כבר לא מוסיפה את התעריפים שלו לפרופיל המשלוח הכללי (General). אם האפליקציה או סקריפט ההטמעה שלכם יוצרים carrier service ומצפים שהלקוחות יראו את התעריפים שלכם, הם לא יראו אותם, עד שתוסיפו את השירות לפרופיל משלוח בעצמכם.

שינוי כתובת משלוח מחשב מחדש את המסים

עדכון כתובת המשלוח בהזמנה שטרם מומשה באמצעות orderUpdate, או בנקודת הקצה של עדכון הזמנה ב-REST, מחשב עכשיו מחדש את המסים שלה. זו ההתנהגות הנכונה, אבל אם אתם משנים כתובות ממערכת ERP או מכלי תמיכה, סכום ההזמנה יכול להשתנות מתחת לידיים שלכם. קראו שוב את taxLines, את totalTaxSet ואת הסכומים לאחר העדכון, והסדירו כל הפרש בסכום ששולם או הוחזר.

אזהרות הנחה בהזמנות טיוטה איבדו את priceRule

DraftOrderDiscountNotAppliedWarning.priceRule וסוגי PriceRule הישנים הוסרו. אם אתם בונים הזמנות טיוטה באמצעות draftOrderCalculate, draftOrderCreate או draftOrderUpdate וקוראים מדוע הנחה לא הוחלה, בחרו במקום זה את discountTitle ואת discountCode.

סינון לפי metafield לא תקין נכשל עכשיו בקול רם

שאילתת מוצרים שסוננה לפי metafield שאי אפשר לסנן לפיו נהגה להתעלם מאותו חלק במסנן ולהחזיר הכול. עכשיו היא מחזירה שגיאה. זה טוב יותר, אבל סנכרון שמחזיר "את כל המוצרים" כבר חודשים יתחיל להיכשל ביום שבו תעברו לגרסה החדשה. בדקו שהגדרות ה-metafield שאתם מסננים לפיהן תומכות בסינון ובאופרטורים שבהם אתם משתמשים.

לווריאנט יכול להיות יותר מברקוד אחד

ProductVariant.barcodes הוא connection חדש עם עד 20 ברקודים מסוגים שונים. השדה הישן ProductVariant.barcode הוצא משימוש ומחזיר רק את הראשון. אם המחסן או קופת המכירה (POS) שלכם מתאימים מוצרים לפי ברקוד, קראו את הרשימה המלאה.

שגיאת מלאי אחת הוסרה

ITEM_NOT_STOCKED_AT_LOCATION הוסר ממוטציות המלאי ומ-InventorySetQuantitiesUserErrorCode. קוד שמתפצל לפיו הוא עכשיו קוד מת. הסירו אותו כדי שאף אחד לא יסתמך עליו בהמשך.

שינויים קטנים יותר ששווה לחפש בקוד שלכם

• סגמנטים של לקוחות. MATCHES ו-NOT MATCHES מחליפים את = true ואת = false, ותאריכים בעלי שם כמו 12_months_ago הוצאו משימוש לטובת היסטים כמו -12m.
• הסכמה ל-SMS. שדות ההסכמה השטוחים ל-SMS הוצאו משימוש. קראו את CustomerPhoneNumber.smsMarketingConsent.
• הנחות ב-rollouts. השדות startsAt ו-endsAt של הנחה לא אומרים לכם אם היא פעילה כשהיא חלק מ-rollout. קריאת Discount.rollouts דורשת את ההרשאה read_rollouts.
• סטטוס מימוש. FULFILLMENT_NOT_REQUIRED הוא ערך חדש. switch שממפה כל סטטוס יגיע למקרה ברירת המחדל שלו.
• Customer Account API. Customer.lastIncompleteCheckout וסוגי Checkout הוסרו, ללא תחליף.
• תוספי POS UI. מוטציות עגלה כמו applyCartDiscount נדחות עכשיו כש-POS לא מאשר את השינוי, והשדה session.currentSession.staffMemberId הוסר.

שני מועדים שלא קשורים ל-2026-10

אם אתם מתחזקים אפליקציה ציבורית, צריך להחליף אסימוני גישה offline שאינם פגים באסימונים שפגים עד 1 בינואר 2027. אפליקציות מותאמות אישית ואפליקציות שסוחר יוצר ב-Dev Dashboard אינן נכללות. וסקריפטים (script tags) בחנות המקוונת יפסיקו לרוץ ב-1 במרץ 2027. כתבנו בנפרד מה זה אומר לחנויות.

איך אנחנו משדרגים

אנחנו מקבעים את גרסת ה-API במקום אחד, מריצים את האינטגרציה מול חנות פיתוח על הגרסה החדשה, וקוראים את יומן השינויים של 2026-10 מסונן לפי "Action required". גרסה 2026-10 נתמכת לפחות עד 1 באוקטובר 2027, אז יש זמן, אבל לא כל כך הרבה שכדאי לחכות עד שיגיעו מיילי האזהרה.

אם החנות שלכם מדברת עם Odoo או עם מערכת אחרת והייתם מעדיפים שמישהו אחר יטפל בזה, זה מה שאנחנו עושים.

להמשך קריאה: Shopify Script Tags מפסיקים לעבוד ב-1 במרץ 2027. מה בעלי חנויות צריכים לעשות, או חיבור Shopify ל-Odoo 19 Community, צעד אחר צעד.