Інтеграція 1С-Бітрікс з Ozon (маркетплейс)
Ozon не працює через товарні фіди. На відміну від Яндекс.Маркет, де основний канал — YML-файл, Ozon вимагає завантаження товарів через Seller API. Це POST-запити з JSON-тілом, жорстка система атрибутів за категоріями та обов'язкова прив'язка до карток Ozon. Без API-інтеграції керувати каталогом з 1С-Бітрікс неможливо — ручне заповнення через особистий кабінет при більш ніж 50 товарах нежиттєздатне. Наш досвід — 10+ років інтеграцій Бітрікс з маркетплейсами, включаючи 50+ проєктів для Ozon, від невеликих магазинів до каталогів на 50 000+ SKU. Ми гарантуємо коректну роботу обміну під ключ.
Як налаштувати маппінг атрибутів Ozon в Бітрікс?
Ключова складність Ozon — категорійна система атрибутів. Кожна категорія (category_id) має свій набір обов'язкових та опціональних атрибутів. Отримати їх можна через /v1/description-category/attribute. Маппінг будується за таблицею:
| Атрибут Ozon | attribute_id | Обов'язковий | Поле в Бітрікс |
|---|---|---|---|
| Бренд | 85 | Так | Властивість «Бренд» |
| Назва | 4180 | Так | NAME |
| Модель | 9048 | Так | Властивість «Модель» |
| Колір | 10096 | Так | Властивість з ТП |
| Об'єм пам'яті | — | Так | Властивість з ТП |
| Вага з упаковкою, г | 4382 | Так | Властивість або обчислюване |
| Габарити упаковки | 4383–4385 | Так | Властивості |
Технічні деталі маппінгу (довідкові атрибути)
Значення-довідники
Багато атрибутів — не вільний текст, а вибір з довідника Ozon. Бренд «Samsung» — це конкретний option_value_id, який потрібно знайти через /v1/description-category/attribute/values. При маппінгу властивостей Бітрікс на атрибути 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 товарів за запит. В Бітрікс ціни зберігаються в таблиці b_catalog_price. Для інтеграції з Ozon виділяється окремий тип ціни (наприклад, «Ціна Ozon») або використовується основна роздрібна. Агент синхронізації запускається по cron кожні 15–30 хвилин, вибирає товари зі зміненою ціною (TIMESTAMP_X) та відправляє пакетний запит.
Залишки. Метод /v2/products/stocks. Критично для FBS — якщо залишок в Ozon > 0, а на складі товару немає, ви отримаєте штраф за скасування замовлення. Синхронізація залишків повинна бути максимально частою: кожні 5–15 хвилин для високооборотних товарів. Для мультискладовості Ozon підтримує передачу залишків по складах (warehouse_id). Кожен склад Ozon маппиться на склад в Бітрікс (якщо використовується складський облік модуля catalog).
Обробка замовлень
Замовлення FBS забираються через /v1/posting/fbs/list з фільтром status = awaiting_packaging. Обробник:
- Отримує список нових замовлень.
- Створює замовлення в Бітрікс через
Bitrix\Sale\Order::create()з маппінгом полів: товари, кількість, адреса (якщо доступна), сума. - При збірці замовлення та передачі в доставку — викликає /v1/posting/fbs/ship із зазначенням posting_number та трек-номера.
Статуси замовлення Ozon → Бітрікс:
| Ozon | Дія в Бітрікс |
|---|---|
| awaiting_packaging | Створення замовлення, статус «Новий» |
| awaiting_deliver | Статус «Зібрано» |
| delivering | Статус «Відправлено» |
| delivered | Статус «Виконано» |
| cancelled | Скасування замовлення |
Чому важливо синхронізувати залишки кожні 5 хвилин?
Розбіжність залишків — головна причина штрафів Ozon. Якщо замовлення створено на Ozon, але агент синхронізації ще не забрав його — залишок в Бітрікс не зменшився. Наступний запит залишків відправить застарілі дані. Рішення: при отриманні замовлення з Ozon спочатку резервувати залишок в Бітрікс, потім синхронізувати. Наша інтеграція працює в 2 рази швидше стандартних модулів Marketplace за рахунок асинхронних агентів та пакетної обробки.
Типові проблеми
Товар не пройшов модерацію. Причина #1 — невірний маппінг атрибутів. Перевірте через /v1/product/info/list поле status_description. Часта помилка — бренд передано текстом, а не option_value_id.
Rate limiting. Ozon API обмежує кількість запитів: ~60 запитів на хвилину для більшості методів. При каталозі в 10 000+ товарів оновлення цін потрібно розбивати на пакети із затримкою.
Що входить в роботу
- Документація з маппінгу атрибутів та структури даних.
- Налаштування cron-агентів з потрібною періодичністю.
- Тестування першого завантаження товарів та обробки замовлень.
- Навчання співробітників роботі з інтеграцією.
- Гарантія 6 місяців на безперебійну роботу обміну.
Строки
| Масштаб | Строк |
|---|---|
| До 500 товарів, проста структура | 5–7 днів |
| 500–5000 SKU, мультисклад | 1.5 тижня |
| 5000+, повна автоматизація (замовлення + залишки + статуси) | 2 тижні |
Вартість розраховується індивідуально. Зв'яжіться з нами для безкоштовної оцінки вашого проєкту. Отримайте консультацію щодо строків та вартості інтеграції.
Всі посилання на методи API — з офіційної документації Ozon Seller API.