בחנות סיטונאית מקוונת, כל פריט נמכר רק בקבוצות — של 6, 10 או 100 יחידות. אם לקוח מוסיף 5 במקום 6 לעגלה, העגלה או מעגלת את הכמות כלפי מעלה למינימום או זורקת שגיאה. במבט ראשון, מדובר בהגדרה פשוטה דרך פאנל הניהול. אבל בפועל, כשהקטלוג מכיל 10,000 פריטים והקבוצה תלויה באריזת הספק, עריכה ידנית הופכת לסיוט. אחד הלקוחות שלנו עם קטלוג של 12,000 פריטים בילה שבוע בהגדרת ערכים ידנית ועדיין עשה שגיאות ב-15% מהמקרים. אוטמטנו את התהליך באמצעות ייבוא CSV וסקריפט סנכרון עם 1C, וצמצמנו את הזמן לכשעתיים.
ב-Bitrix, הקבוצה המינימלית מוגדרת על ידי השדה MIN_QUANTITY בטבלת b_catalog_product. בנוסף, נעשה שימוש ב-STEP_QUANTITY — שלב הכמות (ריבוי). כשמוצר מתווסף לעגלה, מודול catalog קורא את MIN_QUANTITY ומעלה אוטומטית את הכמות אם הלקוח הזין פחות. חשוב: השדה אינו משפיע על מחירים מוזלים ואינו תלוי במלאי — רק במוצר עצמו.
היכן זה מאוחסן וכיצד MIN_QUANTITY עובד
לכל מוצר יש רשומה ב-b_catalog_product עם השדות הבאים:
-
MIN_QUANTITY— כמות הזמנה מינימלית (עשרוני, ברירת מחדל 1) -
STEP_QUANTITY— שלב הגדלת כמות (ריבוי, ברירת מחדל 1)
אם MIN_QUANTITY = 0 או 1, ההגבלה אינה חלה. בעת הוספה לעגלה, המערכת קוראת את MIN_QUANTITY ואם הכמות שהוזנה נמוכה יותר, מעלה אותה אוטומטית למינימום (תלוי בהגדרת רכיב העגלה).
הגדרה דרך הממשק הניהולי
Каталог → [выбрать товар] → Торговые предложения/Количество
שדה "כמות הזמנה מינימלית" — הזן מספר. ערך 0 או 1 פירושו ללא הגבלה. להקצאה המונית, השתמש בייבוא דרך CSV או XML (Каталог → Импорт), כאשר בעמודה MIN_QUANTITY תציין את הערך הרצוי.
כיצד להגדיר קבוצה מינימלית עבור 10,000 מוצרים?
אם יש הרבה מוצרים, עריכה ידנית של כל אחד לוקחת שבוע. הדרך האופטימלית: ייבוא דרך CSV עם הפקת קובץ ב-Excel או בצד של 1C. העמודה MIN_QUANTITY קיימת בייצוא הקטלוג. עבור פריטים סיטונאיים, ניתן להגדיר ערך של 6, עבור קמעונאות — 1. לאחר הייבוא, הקפד לבדוק עקביות עם STEP_QUANTITY (שגיאה כאן היא גורם נפוץ לתקלת עגלה). ייבוא CSV מהיר פי 50 מעריכה ידנית עבור 10,000 מוצרים.
הגדרה דרך API: הוראות שלב אחר שלב
- קבל את מזהה המוצר או ה-SKU (לדוגמה, דרך
CIBlockElement::GetList). - קרא ל-
\Bitrix\Catalog\Model\Product::update($elementId, ['MIN_QUANTITY' => 10]). - ודא שמטמון הקטלוג נוקה (השתמש במתודת
ClearByTag). - בדוק בעגלה שהערך החדש מיושם.
- להקצאה המונית, הפעל לולאה בסוכן או בסקריפט.
\Bitrix\Catalog\Model\Product::update($elementId, [ 'MIN_QUANTITY' => 10, ]); שיטה זו עדיפה על \Bitrix\Catalog\Model\Product::update($elementId, [ 'MIN_QUANTITY' => 10, ]); מכיוון שהיא עובדת ישירות עם טבלת CIBlockElement::SetPropertyValues ומפעילה מטמון. אנו משתמשים בה בסוכנים מותאמים אישית לסנכרון ERP.
מדוע b_catalog_product לא עובד בפרונטאנד headless?
הרכיב הסטנדרטי MIN_QUANTITY קורא את bitrix:sale.basket.basket ומתאים אוטומטית את הכמות. אבל אם הפרונטאנד הוא headless (React, Vue), אז יש להביא את MIN_QUANTITY דרך REST API (מתודת MIN_QUANTITY) וליישם ולידציה בצד הלקוח. אחרת, הלקוח עלול לשלוח 5, והשרת יקבל את ההזמנה ללא ולידציה — שגיאת עגלה.
כיצד לסנכרן את catalog.product.get ו-MIN_QUANTITY?
אם מוגדרים גם קבוצה מינימלית וגם שלב (STEP_QUANTITY), הכמות המינימלית חייבת להיות כפולה של השלב. דוגמה: STEP_QUANTITY, MIN_QUANTITY = 6 — נכון (6/3=2). אבל STEP_QUANTITY = 3, MIN_QUANTITY = 5 — מוביל לכך שהעגלה מעלה את הכמות ל-6 (הכפולה הבאה), אבל הלקוח רואה שינוי בלתי צפוי. אנו בודקים עקביות זו אוטומטית עם סקריפט.
מידע נוסף על בדיקת שאריות
לבדיקה מהירה של כל המוצרים, הרץ את שאילתת ה-SQL: ```sql SELECT ID, MIN_QUANTITY, STEP_QUANTITY FROM b_catalog_product WHERE MIN_QUANTITY > 0 AND STEP_QUANTITY > 0 AND MIN_QUANTITY % STEP_QUANTITY != 0; ``` זה יזהה רשומות לא עקביות. יש לתקן מוצרים כאלה או ליישר את השלב בכוח.שיטות הגדרה: השוואה
| שיטה | זמן למוצר אחד | מתאים להמונים | שגיאות |
|---|---|---|---|
| ניהול (שדה ידני) | 1–2 דקות | עד 50 מוצרים | שגיאות הקלדה אפשריות |
| ייבוא CSV | 1–2 שעות לקטלוג | מ-100 מוצרים | נדרשת הכנת נתונים |
| API (סקריפט) | 10–15 דקות לפיתוח | מ-1000 מוצרים | מינימלי אם נבדק |
שגיאות נפוצות ופתרונותיהן
| שגיאה | סיבה | פתרון |
|---|---|---|
| העגלה לא מעלה כמות | הרכיב לא קורא את STEP_QUANTITY = 3 |
עדכן תבנית עגלה או יישם ולידציה |
| הכמות משתנה באופן בלתי צפוי | MIN_QUANTITY אינו כפולה של MIN_QUANTITY |
יישר ריבוי |
| ערכים מתאפסים לאחר ייבוא | פורמט CSV שגוי (חסרה עמודה) | בדוק מיפוי שדות |
| פרונטאנד headless לא מיישם מינימום | חסרה ולידציה בצד הלקוח | הוסף בדיקה מבוססת REST API |
זמן אספקה
הגדרה בסיסית של קבוצה מינימלית למוצר אחד או לקבוצה דרך ייבוא — מ-2 עד 4 שעות. כולל: ניתוח נתונים קיימים, הכנת קובץ, ייבוא, בדיקת עגלה, תיקון שגיאות עקביות. אם נדרש סקריפט לסנכרון אוטומטי עם 1C, הזמן גדל ליום אחד.
מה כלול בהגדרה סוהר
- ביקורת ערכי
STEP_QUANTITYו-MIN_QUANTITYקיימים בכל הקטלוג - הכנה וביצוע ייבוא המוני (CSV/XML)
- כתיבת סקריפט API (אם נדרשת אוטומציה)
- בדיקת פעולת עגלה ברכיבים סטנדרטיים ומותאמים אישית
- תיעוד תמיכה קצר
- ייעוץ בנושא פרונטאנד headless (אם רלוונטי)
אנו מומחי Bitrix מוסמכים עם ניסיון יישום ביותר מ-50 פרויקטים של הגדרת קטלוג למסחר סיטונאי וקמעונאי. אנו מבטיחים פעולת עגלה יציבה לאחר השינויים. הפחתת עלויות תחזוקת קטלוג וחיסכון של עד 80% בזמן הם תוצאות צפויות.
תיעוד רשמי של 1C-Bitrix — MIN_QUANTITY יעזור לך להבין את הניואנסים.
להגדרה המונית או תרחישים מורכבים (אינטגרציה עם 1C, שלב מותאם אישית, בדיקת מלאי) — צור קשר. נבחן את הפרויקט שלך תוך יום עבודה אחד ונציע פתרון אופטימלי. פנה אלינו לביקורת קטלוג. הגש בקשה לניתוח מפורט — קבל ייעוץ.