אינטגרציית 1C-Bitrix ל-Ozon (Marketplace)

Ozon אינו עובד דרך פיד מוצרים. בניגוד ל-Yandex.Market, שבו הערוץ המרכזי הוא קובץ YML, Ozon דורש העלאת מוצרים דרך Seller API. הדבר כולל בקשת POST עם גוף JSON, מערכת מאפיינים קפדנית מבוססת קטגוריות, וקישור חובה לכרטיסי מוצר של Ozon. ללא אינטגרציית API, ניהול קטלוג מ-1C-Bitrix הוא בלתי אפשרי — מילוי ידני דרך האזור האישי אינו ריאלי עבור יותר מ-50 מוצרים. הניסיון שלנו: 10+ שנים של אינטגרציות Marketplace ל-Bitrix, כולל 50+ פרויקטים עבור Ozon, מחנויות קטנות ועד קטלוגים של 50,000+ פריטים. אנו מבטיחים החלפה נכונה ומלאה. עלות אינטגרציה טיפוסית נעה בין $500 ל-$2000 בהתאם למורכבות.

כיצד להגדיר מיפוי מאפיינים של Ozon ב-Bitrix?

המורכבות המרכזית של Ozon היא מערכת המאפיינים המבוססת על קטגוריות. לכל קטגוריה (category_id) יש סט משלה של מאפיינים חובה ואופציונליים. ניתן לאחזר אותם דרך /v1/description-category/attribute. המיפוי נבנה לפי הטבלה:

ערכי ייחוס

מאפיינים רבים אינם טקסט חופשי אלא בחירה מתוך הייחוס של Ozon. המותג "Samsung" הוא option_value_id ספציפי שיש לאתר דרך /v1/description-category/attribute/values. בעת מיפוי מאפייני Bitrix למאפייני Ozon, יש ליצור טבלת התאמה: ערך מאפיין אינפובלוק → option_value_id של Ozon.

קישור לכרטיסי מוצר

Ozon מאחד מוצרים זהים ממוכרים שונים לכרטיס אחד. הקישור נעשה באמצעות ברקוד (EAN), מק"ט יצרן, או דרך מידרציה ידנית. אם המוצר כבר קיים במאגר של Ozon, ההצעה שלך תקושר לכרטיס הקיים. אם לא, נוצר כרטיס חדש ועובר מידרציה (1–3 ימים).

מיפוי נתונים: אינפובלוק → Ozon API

תוכנית מיפוי טיפוסית למודול האינטגרציה:

Инфоблок «Каталог» (iblock_id = N)
├── NAME → attribute_id 4180 (Название)
├── PROPERTY_BRAND → attribute_id 85 (Бренд, справочник)
├── PROPERTY_ARTICLE → offer_id (артикул продавца)
├── PROPERTY_BARCODE → barcode
├── DETAIL_TEXT → description (до 6000 символов)
└── DETAIL_PICTURE → images[] (до 15 фото, минимум 200×200)
Инфоблок ТП (iblock_id = M)
├── PROPERTY_COLOR → attribute_id 10096 (Цвет, справочник)
├── PROPERTY_SIZE → attribute_id (размер, зависит от категории)
└── Цена каталога → price / old_price

המיפוי נשמר בהגדרות מודול האינטגרציה (אם משתמשים במודול מוכן מ-Marketplace) או בקובץ התצורה של פתרון מותאם אישית. המהנדסים שלנו מפתחים התאמה אישית למבנה שלך. לפי Ozon Seller API, בעת העלאת מוצרים, יש להעביר את כל המאפיינים החובה.

סנכרון מחירים ומלאי

מחירים. Ozon עובד עם שני מחירים: price (מחיר מכירה) ו-old_price (מחיר מומחק). ההפרש חייב להיות לפחות 5% — אחרת Ozon לא יציג את ההנחה. עדכון דרך /v1/product/import/prices, מגבלה של 1000 מוצרים לבקשה. ב-Bitrix, מחירים נשמרים בטבלת b_catalog_price. עבור אינטגרציית Ozon, מוקצה סוג מחיר נפרד (למשל, "מחיר Ozon"), או נעשה שימוש במחיר הקמעונאי הראשי. סוכן הסנכרון רץ דרך cron כל 15–30 דקות, בוחר מוצרים עם מחיר ששונה (TIMESTAMP_X) ושולח בקשת אצווה.

מלאי. שיטה /v2/products/stocks. קריטי עבור FBS — אם המלאי ב-Ozon > 0 אך אין מוצר במחסן, תקבל קנס על ביטול הזמנה. סנכרון מלאי צריך להיות תכוף ככל האפשר: כל 5–15 דקות עבור מוצרים מהירי תנועה. עבור ריבוי מחסנים, Ozon תומך בהעברת מלאי לפי מחסן (warehouse_id). כל מחסן Ozon ממופה למחסן ב-Bitrix (אם נעשה שימוש בניהול מלאי דרך מודול הקטלוג).

עיבוד הזמנות

הזמנות FBS נשלפות דרך /v1/posting/fbs/list עם פילטר status = awaiting_packaging. המטפל:

1. מאחזר רשימת הזמנות חדשות.
2. יוצר הזמנה ב-Bitrix דרך Инфоблок «Каталог» (iblock_id = N) ├── NAME → attribute_id 4180 (Название) ├── PROPERTY_BRAND → attribute_id 85 (Бренд, справочник) ├── PROPERTY_ARTICLE → offer_id (артикул продавца) ├── PROPERTY_BARCODE → barcode ├── DETAIL_TEXT → description (до 6000 символов) └── DETAIL_PICTURE → images[] (до 15 фото, минимум 200×200) Инфоблок ТП (iblock_id = M) ├── PROPERTY_COLOR → attribute_id 10096 (Цвет, справочник) ├── PROPERTY_SIZE → attribute_id (размер, зависит от категории) └── Цена каталога → price / old_price עם מיפוי שדות: פריטים, כמות, כתובת (אם זמינה), סה"כ.
3. בעת איסוף ההזמנה ומסירה למשלוח — קורא ל-/v1/posting/fbs/ship עם posting_number ומספר מעקב.

סטטוסי הזמנות Ozon → Bitrix:

מדוע חשוב לסנכרן מלאי כל 5 דקות?

אי-התאמה במלאי היא הגורם העיקרי לקנסות של Ozon. אם נוצרת הזמנה ב-Ozon אך סוכן הסנכרון עדיין לא אסף אותה — המלאי ב-Bitrix לא ירד. בקשת המלאי הבאה תשלח נתונים מיושנים. פתרון: בעת קבלת הזמנה מ-Ozon, תחילה הזמן מלאי ב-Bitrix, ולאחר מכן סנכרן. האינטגרציה שלנו עובדת פי 2 מהר יותר ממודולי Marketplace סטנדרטיים בזכות סוכנים אסינכרוניים ועיבוד אצווה.

בעיות טיפוסיות

מוצר נכשל במידרציה. סיבה מס' 1 — מיפוי מאפיינים שגוי. בדוק דרך /v1/product/info/list את השדה status_description. טעות נפוצה: מותג נשלח כטקסט במקום option_value_id.

הגבלת קצב. Ozon API מגביל בקשות: ~60 בקשות לדקה עבור רוב השיטות. עבור קטלוגים של 10,000+ מוצרים, יש לפצל עדכוני מחירים לאצוות עם השהיות.

מה כלול

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

לוחות זמנים

העלות מחושבת באופן אישי. צור קשר להערכה חינמית של הפרויקט שלך. קבל ייעוץ על לוחות זמנים ועלויות אינטגרציה.

כל ההפניות לשיטות API הן מתיעוד Ozon Seller API הרשמי.