Интеграция 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.

Маппинг: свойство инфоблока Битрикс (например, PROP_COLOR = "Красный") → ID атрибута Ozon (например, attribute_id: 10096) → ID значения в справочнике Ozon (например, value_id: 61587). Эту таблицу маппинга ведём как отдельную сущность в Битрикс — она меняется при добавлении новых категорий.

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

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

1. Обновление остатков в Ozon из Битрикс — каждые 15–30 минут
2. Получение новых заказов из Ozon — опрос POST /v3/posting/fbs/list с фильтром status: awaiting_packaging
3. Создание заказа в Битрикс, резервирование товара
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, генерируем документ в Битрикс или интегрированной учётной системе.

Возвраты. Ozon автоматически создаёт возвраты (refund или cancelled postings). Интеграция должна отслеживать эти события, создавать возвратный документ в Битрикс и возвращать товар на остатки. Метод для получения возвратов: POST /v3/returns/company/fbs.

Типичные проблемы

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

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

Ориентиры по срокам

Стоимость рассчитывается индивидуально после аудита каталога и схемы работы (FBS/FBO).