כאשר חנות מקוונת על 1C-Bitrix מתחילה למכור ב-SberMegamarket, הבעיה הראשונה היא חוסר התאימות של ייצוא ה-YML הסטנדרטי לדרישות המרקטפלייס.
אינטגרציה של 1C-Bitrix עם SberMegamarket דורשת תגי <outlets> ו-<shipment-options> שחסרים ב-YML הרגיל. ה-API להזמנות שונה מ-Ozon ו-Wildberries, כך שללא הגדרה נכונה אתם מסתכנים באובדן של עד 30% מההזמנות עקב כשלים בעדכוני מלאי. יישמנו אינטגרציה זו עבור 20+ חנויות עם קטלוג ממוצע של 5000 פריטים ואנחנו יודעים כיצד להימנע מטעויות נפוצות. ב-95% מהמקרים, הבעיות נפתרות על ידי הגדרת הפקת פיד כל 30 דקות ושימוש ב-Merchant API לאישור הזמנות.
SberMegamarket (לשעבר goods.ru) פועלת במודלים DBS ו-FBS. ערוץ העלאת המוצרים הראשי הוא פיד XML הקרוב ל-YML אך עם הרחבות. ניהול ההזמנות מתבצע דרך Merchant API. כפילות זו דורשת הגדרה של שני מנגנונים עצמאיים בצד של Bitrix, שכל אחד מהם ניתן למימוש עם כלי הפלטפורמה הסטנדרטיים.
הגדרת פיד המוצרים עבור SberMegamarket
הפיד מתקבל בפורמט תואם YML עם תגים נוספים. כתובת הפיד מוגדרת בלוח הבקרה של המוכר; המרקטפלייס שולף אותו בלוח זמנים (בדרך כלל כל 2–4 שעות). בממוצע, כ-50% מהקטלוג דורש תיקוני מחיר ומלאי לאחר ההעלאה הראשונית.
מבנה של <offer>:
| תג | חובה | תיאור | שדה Bitrix |
|---|---|---|---|
<name> |
כן | שם | NAME |
<price> |
כן | מחיר | סוג מחיר קטלוגי |
<categoryId> |
כן | קטגוריה | סעיף בלוק מידע |
<picture> |
כן | תמונה (לפחות 1) | DETAIL_PICTURE |
<vendor> |
כן | מותג | מאפיין |
<barcode> |
כן | EAN-13 | מאפיין |
<description> |
כן | תיאור | DETAIL_TEXT |
<outlets> |
כן (DBS) | מלאי לפי נקודת מכירה | מחסנים |
<shipment-options> |
כן (DBS) | זמני משלוח | הגדרות |
<outlets> הוא תג מפתח עבור מודל DBS. מכיל <outlet id="ID" instock="КОЛИЧЕСТВО"/> עבור כל נקודת מכירה. מזהה הנקודה נוצר בלוח הבקרה של SberMegamarket. ב-Bitrix, המלאי נלקח מחשבונאות המחסנים של מודול catalog או ממאפיין אלמנט נפרד.
<shipment-options> מציין כמה ימים המוכר מוכן לשלוח את הפריט. דוגמה: <option days="1" order-before="14"/> — משלוח תוך יום אחד עבור הזמנות לפני 14:00. המרקטפלייס משתמש בזה כדי לחשב זמני אספקה לקונה.
הפקת פיד ב-Bitrix
ייצוא YML סטנדרטי ב-Bitrix (פרופיל 'Yandex.Market') אינו מייצר תגי <outlets> ו-<shipment-options>. אפשרויות:
-
שינוי הייצוא הסטנדרטי. בקובץ ה-handler
/bitrix/php_interface/include/catalog_export/, שנו את תבנית יצירת ה-XML כדי להוסיף את התגים הנדרשים. המלאי נשלף דרךCCatalogStoreProduct::GetList()עבור כל מוצר. -
מודול מהמרקטפלייס. פתרונות מוכנים עבור SberMegamarket (למשל, מ-Kooplex או RetailCRM) מוסיפים פרופיל ייצוא עם תמיכה בכל התגים הספציפיים.
-
סקריפט PHP נפרד. סקריפט cron מייצר XML על ידי בחירת נתונים מבלוק המידע דרך
CIBlockElement::GetList(). יתרון: שליטה מלאה ללא תלות במודול הייצוא.
חשיבות מהירות עדכון המלאי
הגדרת Cron לפיד
כדי למזער עיכובים, אנו מגדירים הפקת פיד כל 30 דקות דרך cron. עבור פריטים עם מחזור מכירות גבוה, אנו משתמשים ב-API לעדכוני מחיר ומלאי — זה מהיר פי 10 מהמתנה לניתוח הפיד.
עיכוב בעדכון המלאי הוא גורם נפוץ לקנסות. אם פריט נמכר אך הפיד עוד לא עודכן, המרקטפלייס מקבל הזמנה עבור מוצר שאינו זמין. כל ביטול הזמנה עלול לגרור קנסות ומוריד את דירוג המוכר. לפי הסטטיסטיקה שלנו, עדכוני מלאי בזמן מפחיתים ביטולים ב-85%. שגיאות דה-סנכרון עלולות להוביל לקנסות ולפגיעה במוניטין.
Merchant API: עיבוד הזמנות
ה-API של SberMegamarket (https://partner.sbermegamarket.ru/api/) עובד דרך בקשת POST עם JSON. האימות הוא טוקן בכותרת.
מחזור הזמנות DBS:
- קבלת הזמנות חדשות.
POST /api/market/v1/orderService/order/newמחזיר הזמנות בסטטוס NEW. - אישור.
POST /api/market/v1/orderService/order/confirm— המוכר מאשר את ההזמנה ומציין את זמן המשלוח. - משלוח.
POST /api/market/v1/orderService/order/packing— ספק מספר מעקב ואשר את המשלוח. - ביטול.
POST /api/market/v1/orderService/order/reject— ביטול עם סיבה.
בצד של Bitrix, סוכן cron בודק את ה-API עבור הזמנות חדשות כל 5–10 דקות. בעת קבלת הזמנה:
- צור הזמנה ב-
Bitrix\Sale\Orderעם מיפוי מוצרים לפיofferId(SKU) או ברקוד. - הגדר מאפייני הזמנה: מספר הזמנת SberMegamarket, שיטת משלוח, פרטי לקוח (שם, טלפון, כתובת).
- כאשר סטטוס ההזמנה משתנה ב-Bitrix, ה-handler של אירוע
OnSaleOrderSavedקורא לשיטת ה-API המתאימה.
לפי תיעוד Merchant API SberMegamarket, שיטת orderService/order/new מחזירה הזמנות בסטטוס NEW שעדיין לא אושרו.
עדכוני מחיר ומלאי
דרך הפיד. מחירים ומלאי מתעדכנים כאשר המרקטפלייס מנתח את הפיד בפעם הבאה. עיכוב של עד 4 שעות. מספיק עבור רוב החנויות.
דרך API (עדכון מואץ). עבור פריטים עם מחזור מכירות גבוה — שיטת POST /api/market/v1/offerService/manualPrice/save למחירים, ועדכון מלאי דרך <outlets> בפיד עם רענון מאולץ.
קטגוריות ומודרציה
SberMegamarket משתמשת בעץ קטגוריות משלה. המיפוי מוגדר בלוח הבקרה בעת הגדרת הפיד — עבור כל <categoryId> מהפיד שלכם, ציינו את הקטגוריה המתאימה במרקטפלייס.
מודרציית המוצרים אורכת 1–3 ימים. סיבות לדחייה:
- ברקוד חסר.
- מותג לא תקין (לא בספריית המרקטפלייס).
- תמונות שאינן עומדות בדרישות (סימני מים, קולאז'ים, טקסט על התמונה).
מה כלול באינטגרציה
- ניתוח הקטלוג הנוכחי ומבנה בלוק המידע.
- הפקת פיד עם תגי
<outlets>ו-<shipment-options>. - הגדרת סוכני cron לבדיקת Merchant API.
- פיתוח handlers ליצירה ועדכון הזמנות.
- בדיקות על נתונים אמיתיים ואיתור באגים.
- הדרכת מנהלים בטיפול בהזמנות.
- אחריות ל-30 יום לאחר ההשקה.
למהנדסים שלנו יש ניסיון של למעלה מ-5 שנים באינטגרציה של מרקטפלייסים עם 1C-Bitrix, עם 20+ פרויקטים שהושלמו. אנו מבצעים אינטגרציה מלאה תוך 1–2 שבועות, תלוי בגודל הקטלוג. צרו קשר כדי להעריך את הפרויקט שלכם — נספק לוחות זמנים מדויקים והצעה. הזמינו אינטגרציה וקבלו ייעוץ מהמהנדסים שלנו.
לוחות זמנים לאינטגרציה
| תרחיש | לוח זמנים |
|---|---|
| פיד + טיפול ידני בהזמנות | 3–5 ימים |
| פיד + API להזמנות, עד 1000 פריטים | שבוע |
| אינטגרציה מלאה: פיד + הזמנות + מלאי + סטטוסים | 1.5–2 שבועות |