אינטגרציית 1C-Bitrix ל-Ozon: API, מיפוי, סנכרון

אינטגרציית 1C-Bitrix ל-Ozon (מרקטפלייס)

Ozon אינו עובד דרך פיד מוצרים. בניגוד ל-Yandex.Market, שבו הערוץ המרכזי הוא קובץ YML, Ozon דורש העלאת מוצרים דרך Seller API. זה כולל בקשת POST עם גוף JSON, מערכת מאפיינים קפדנית מבוססת קטגוריות, וקישור חובה לכרטיסי מוצר של Ozon. ללא אינטגרציית API, ניהול קטלוג מ-1C-Bitrix הוא בלתי אפשרי — מילוי ידני דרך האזור האישי אינו מעשי עבור יותר מ-50 מוצרים. הניסיון שלנו: 10+ שנים של אינטגרציות מרקטפלייס עם 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

המיפוי נשמר בהגדרות מודול האינטגרציה (אם משתמשים במודול מוכן מהמרקטפלייס) או בקובץ התצורה של פתרון מותאם אישית. המהנדסים שלנו מפתחים התאמה אישית למבנה שלך. לפי 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 מהר יותר ממודולי מרקטפלייס סטנדרטיים בזכות סוכנים אסינכרוניים ועיבוד אצווה.

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

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

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

מה כלול

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

לוחות זמנים

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

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