WEBA

ווקומרס 11.3 שוברת חיבורי AI ישנים ומחמירה בדיקות ב-API

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

505 מילים25 עובדות אומתו

השקות בטא נוטות להרדים מתכנתים עם הבטחות על מרווחים יפים יותר בבלוקים. אבל הפעם, הודעת טרום ההשקה של WooCommerce 11.3 שפורסמה אתמול בבלוג המפתחים כוללת מוקשים אמיתיים. אם בניתם בחודשים האחרונים אינטגרציות של סוכני AI על בסיס פרוטוקול MCP, או שהחנות שלכם מסתמכת על סקריפטים אוטומטיים להחזרי כספים, העדכון הזה דורש בדיקה מעמיקה לפני העלייה לאוויר בשבוע של 9 בנובמבר 2026.

לא הייתי ממהר לעדכן אתרי לקוחות ביום ההשקה בלי בדיקה מקיפה בסביבת פיתוח.

סוכני ה-AI יפסיקו לענות

השינוי המשמעותי ביותר בממשקי ה-AI הוא מחיקה מוחלטת של נקודת הקצה wp-json/woocommerce/mcp. יחד איתה נמחק מסלול החיבור שהסתמך על מפתחות ה-REST הישנים של המערכת. בצוות הפיתוח הפסיקו לכלול את חבילות ה-MCP Adapter וה-Abilities API בתוך קבצי הליבה של התוסף. במקומם, מי שמפעיל חיבורי סוכנים יידרש להתקין את תוסף MCP Adapter הייעודי של וורדפרס ולהשתמש בסיסמאות יישום כדי לתקשר עם החנות.

WooCommerce 11.3 removes its deprecated /wp-json/woocommerce/mcp endpoint and its REST API key connection path, and stops bundling the MCP Adapter and Abilities API packages.בריאן קורדס, בלוג המפתחים של WooCommerce

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

חיבורים ישנים פשוט יפסיקו לעבוד.

החזרים דרך ה-API נחסמים

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

לפי הדוקומנטציה, אימות ההחזרים החדש ב-API חוסם בקשות לא מאוזנות ומחזיר שגיאות 400 או 422 במקום לייצר רשומות שגויות במסד הנתונים. מעכשיו, אם סכום שורות הפריט יעלה על סך ההחזר הכולל או יחרוג מהיתרה שנותרה להחזר באותה שורה, השרת יזרוק שגיאת ולידציה ולא ייצור את ההחזר. תוספי הנהלת חשבונות, מערכות CRM וסליקה אוטומטית שנוהגים לשלוח סכומים לא מתואמים יצטרכו עדכון מהיר, במיוחד בעבודה מול ממשקי סליקה מקומיים בישראל שדורשים התאמה חשבונאית מדויקת.

סינון מוצרים במבצע מתיישר

התנהגות שאילתות המוצרים מקבלת סוף סוף היגיון עקבי. עד גרסה 11.2, שילוב של הפרמטר on_sale עם רשימות include או exclude בתוך REST API הניב תוצאות מוזרות. לעיתים המערכת התעלמה לחלוטין מהסינון, ובמקרים אחרים החזירה מוצרים במחיר מלא רק בגלל שהם נכללו ברשימת המזהים. השינוי מיישר קו בין ממשק ה-REST הרגיל לבין ה-Store API שמשמש חנויות מודרניות.

השוואת התנהגות שליפת מוצרים ב-REST API בשילוב on_sale ופרמטרי סינון
שאילתה ב-APIהתנהגות עד גרסה 11.2התנהגות מגרסה 11.3 ואילך
on_sale=true עם includeהחזירה את כל המוצרים שנכללו (כולל ללא מבצע) ומוצרים נוספים במבצעמחזירה רק מוצרים שגם נכללים ברשימה וגם נמצאים במבצע
on_sale=false עם includeהחזירה את כל רשימת include תוך התעלמות מפרמטר on_saleמחזירה רק מוצרים שנכללים ברשימה ואינם במבצע
on_sale=true עם excludeהתעלמה לחלוטין מרשימת המוצרים להחרגהמחזירה מוצרים במבצע, למעט המוצרים שהוחרגו
on_sale=false עם excludeהחזירה מוצרים ללא מבצע, אך חלק ממוצרי המבצע עדיין הופיעומחזירה מוצרים שאינם במבצע, למעט המוצרים שהוחרגו

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

בדיקה לפני שבוע ההשקה

הגרסה מתוכננת להשתחרר במהלך השבוע של 9 בנובמבר 2026. הצעד ההגיוני ביותר כרגע הוא התקנת התוסף WooCommerce Beta Tester בגרסה 4.0.0 בסביבת בדיקות מקומית או בשרת פיתוח. אל תבדקו את הדברים האלה על חנות חיה, בטח לא כשמדובר באימות החזרים ושאילתות מסד נתונים שפותחו בקוד פתוח בתוך מאגר הריפו של GitHub.

מעבר לכך, גרסה 11.3 מתחילה להציג התראות מנהל למי שמריץ סביבות ישנות, לקראת הדרישה המחייבת ל-PHP 8.1 שתגיע בגרסה 11.6. זה גם זמן מצוין לבדוק את מסנני אמצעי התשלום החדשים במסך דוחות ההזמנות, שעוזרים לסדר התאמות מול ארנקים דיגיטליים וחברות אשראי. תבדקו את האינטגרציות מראש. השרת שלכם לא יחכה להשקה כדי להחזיר 400.

מה לעשות עכשיוהתקינו את תוסף MCP Adapter בסביבת פיתוח ובדקו את קריאות החזרי הכספים ב-API לפני ההשקה בנובמבר.

מקורות

הידיעה נכתבה מהמקורות שלמעלה בתאריך הפרסום, וכל טענה בה נבדקה מולם. מצאתם טעות? כתבו.

מה שואלים על זה

מה קורה אם סוכן MCP מנסה להתחבר אחרי השדרוג בלי התוסף החדש?

הבקשה של הסוכן תיכשל מיידית מפני שנקודת הקצה הישנה הוסרה לחלוטין מקבצי הליבה של התוסף, ויש להתקין את התוסף הייעודי.

האם חנויות שמשתמשות בתבניות קלאסיות יושפעו משינויי הבלוקים וה-Shop page?

לא, שינוי ההתנהגות ועקיפת תבנית עמוד החנות לערך archive-product חלים אך ורק כאשר מופעלת באתר תבנית בלוקים פעילה.

מתי הדרישה ל-PHP 8.1 הופכת למחייבת?

ההתראות למנהלי האתרים מתחילות בגרסה 11.3, אך חסימת הגרסה בפועל תיאכף רק עם שחרור WooCommerce 11.6.