Інтеграція 1С-Бітрікс з Ozon Білорусь

Інтеграція 1С-Бітрікс з Ozon Білорусь

Ozon активно працює з білоруськими продавцями: окремий розділ для білоруських ФОП і юридичних осіб на seller.ozon.ru, можливість роботи за схемами FBS (зі свого складу) та FBO (зі складу Ozon). Для магазину на 1С-Бітрікс інтеграція з Ozon технічно аналогічна російській, але операційно відрізняється логістичними точками та документообігом.

Ozon Seller API: структура

Ozon надає REST API за адресою https://api-seller.ozon.ru/. Автентифікація через заголовки Client-Id: {id} та Api-Key: {key}. Обидва значення беруться з особистого кабінету продавця.

Основні методи для інтеграції:

• POST /v2/product/import — завантаження товарів (асинхронне, через чергу)
• POST /v1/product/import/prices — оновлення цін
• POST /v2/products/stocks — оновлення залишків (FBS)
• POST /v3/posting/fbs/list — список замовлень FBS
• POST /v4/posting/fbs/ship — підтвердження відвантаження

Завантаження товарів на Ozon асинхронне: надсилаємо запит з масивом товарів, отримуємо task_id, потім опитуємо GET /v1/product/import/info?task_id={id} до завершення. Типовий час обробки — 5–15 хвилин.

Атрибути товарів: зіставлення з категоріями Ozon

Ozon має власне дерево категорій та обов'язкові атрибути для кожної категорії. Отримуємо список атрибутів через POST /v3/category/attribute. Для категорії «Смартфони» це 30+ атрибутів, частина обов'язкових (бренд, колір, обсяг пам'яті, операційна система), частина рекомендованих.

Значення атрибутів Ozon беруться з довідників: не можна написати «red» для кольору — потрібен ID значення з довідника Ozon. Отримуємо ID через POST /v2/category/attribute/values.

Маппінг: властивість інфоблоку 1С-Бітрікс (наприклад, PROP_COLOR = "Червоний") → ID атрибута Ozon (наприклад, attribute_id: 10096) → ID значення в довіднику Ozon (наприклад, value_id: 61587). Цю таблицю маппінгу ведемо як окрему сутність у 1С-Бітрікс — вона змінюється при додаванні нових категорій.

FBS: управління залишками та замовленнями

При роботі за схемою FBS (fulfillment by seller) ключовий цикл:

1. Оновлення залишків в Ozon з 1С-Бітрікс — кожні 15–30 хвилин
2. Отримання нових замовлень з Ozon — опитування POST /v3/posting/fbs/list з фільтром status: awaiting_packaging
3. Створення замовлення в 1С-Бітрікс, резервування товару
4. Складання, формування етикетки (метод POST /v2/posting/fbs/package-label)
5. Передача в Ozon акта про відвантаження

Етикетки Ozon — PDF з 2D-баркодом. Отримуємо через /v2/posting/fbs/package-label, друкуємо на принтері етикеток (Zebra, TSC) або звичайному принтері A4.

Особливості для білоруських продавців

Білоруські продавці відвантажують на склади Ozon у Білорусі (Мінськ) або безпосередньо в пункти видачі. Логістика простіша і швидша, ніж відвантаження в Москву, як для WB.

Документообіг: при відвантаженні Ozon вимагає акт передачі в електронному вигляді. Для білоруських юридичних осіб це накладна ТН-2. Дані для формування беремо із замовлення Ozon, генеруємо документ у 1С-Бітрікс або інтегрованій обліковій системі.

Повернення. Ozon автоматично створює повернення (refund або cancelled postings). Інтеграція повинна відстежувати ці події, створювати зворотний документ у 1С-Бітрікс та повертати товар на залишки. Метод для отримання повернень: POST /v3/returns/company/fbs.

Типові проблеми

Товар заблокований Ozon. Часта причина — невідповідність атрибутів вимогам категорії. Статус перевіряємо через POST /v2/product/info (поле status.state_failed). Читаємо status.validation_errors та коригуємо атрибути.

Розбіжність залишків. Якщо інтеграція оновлює залишки рідше, ніж надходять замовлення — можливий oversell. Для товарів з високим оборотом: зменшуємо виставлений на Ozon залишок на 10–20% як буфер або збільшуємо частоту синхронізації.

Орієнтири за термінами

Вартість розраховується індивідуально після аудиту каталогу та схеми роботи (FBS/FBO).