Выгрузка товаров на Ozon

Ozon, в отличие от Яндекс.Маркета, не забирает YML-фид — карточки, цены и остатки передаются в него через Seller API. Поэтому выгрузка из 1С-Битрикс сводится не к генерации файла, а к настройке обмена: подготовке каталога, ключам доступа, маппингу категорий и регулярной синхронизации по расписанию.

Как Ozon получает товары: API вместо фида

Первое, что важно понять при интеграции: Ozon работает по модели Seller API, а не по схеме «сгенерировали YML — маркетплейс скачал». Все операции идут запросами на адрес https://api-seller.ozon.ru с заголовками Client-Id и Api-Key. Это меняет архитектуру выгрузки из Битрикс: вместо статического файла на диске нужен код, который формирует JSON и отправляет его на нужные эндпоинты.

Обмен разбит на независимые процессы, и в проекте их удобно разделять:

• Создание и обновление карточек — POST /v3/product/import;
• Обновление остатков — POST /v2/products/stocks;
• Обновление цен — POST /v1/product/import/prices;
• Проверка статуса загрузки — POST /v1/product/import/info.

Что подготовить в каталоге Битрикс

Прежде чем настраивать обмен, каталог нужно привести к виду, который Ozon примет без отклонений. Данные берутся из модулей iblock (инфоблоки) и catalog (торговый каталог), поэтому проверяйте именно их поля и свойства.

• Артикул — уникальный и заполненный у каждой позиции. Пустой или дублирующийся offer_id — самая частая причина, по которой партия товаров не создаётся.
• Штрихкод — Ozon требует barcode для большинства категорий. В Битрикс он хранится в таблице штрихкодов склада (CCatalogStoreBarcode), а не в свойстве инфоблока.
• Торговые предложения (SKU) — если у товара есть размеры и цвета, они выгружаются отдельными карточками. Разделы «Управление торговым каталогом → Товары» и вкладка предложений должны быть корректно связаны.
• Изображения — Ozon скачивает их по прямым URL, поэтому картинки должны быть публично доступны и отдаваться без редиректов и авторизации.

Ключи доступа и слой интеграции

Доступ к API выдаётся в личном кабинете продавца: Настройки → Seller API → Ключи API. Там формируется пара Client-Id и Api-Key; ключ показывается один раз, поэтому его нужно сразу сохранить в защищённом месте, а не в открытом коде.

На стороне Битрикс интеграцию реализуют одним из трёх способов:

Создание карточек: категории и атрибуты

Самая трудоёмкая часть — маппинг категорий. Ozon работает по дереву description_category_id и type_id: сначала запросом /v1/description-category/tree вы получаете дерево категорий, затем /v1/description-category/attribute — список атрибутов конкретной категории. Разделы инфоблока Битрикс нужно сопоставить с этими идентификаторами.

Атрибуты Ozon делятся на обязательные и опциональные, часть из них — словарные (значение выбирается из справочника, а не пишется произвольно). Для таких атрибутов передаётся dictionary_value_id, который тоже запрашивается через API. Практический порядок работы:

1. Получить дерево категорий и один раз зафиксировать соответствие «раздел Битрикс → type_id».
2. Для каждого типа выгрузить перечень обязательных атрибутов.
3. Сопоставить свойства инфоблока (бренд, цвет, материал) с атрибутами Ozon.
4. Собрать тело запроса /v3/product/import и отправить пакетом до 100 товаров.

Синхронизация цен и остатков

Карточка создаётся один раз, а цены и остатки меняются постоянно, поэтому эти процессы выносят в отдельные регулярные задания. Их нельзя гнать через тяжёлый /v3/product/import — для них есть лёгкие эндпоинты.

• Цены — /v1/product/import/prices: передаются offer_id, price и old_price (перечёркнутая цена). В Битрикс источник — тип цены из модуля каталога, чаще всего «Розничная».
• Остатки — /v2/products/stocks: offer_id, количество и warehouse_id склада Ozon. Данные берутся из складского учёта Битрикс (CCatalogStoreProduct) или из выгрузки 1С.

Оба запроса принимают пакеты, поэтому обновление сотен позиций укладывается в единичные вызовы. Частоту подбирают под товарооборот: остатки ходовых позиций синхронизируют раз в 10–15 минут, цены — по факту изменения или несколько раз в день.

Автоматизация, логи и типичные ошибки

Ручной запуск выгрузки годится только для теста. В продакшене обмен ставят на расписание через агенты Битрикс или, надёжнее, через системный cron с вызовом отдельного PHP-скрипта. Cron предпочтительнее: агенты выполняются на хитах посетителей и на низком трафике могут запускаться нерегулярно.

Обмен по API обязательно логируют — без журнала разбирать отклонённые карточки практически невозможно. В лог стоит писать task_id, коды ответов и тела ошибок. Что встречается чаще всего:

• 429 Too Many Requests — превышены лимиты API; помогает пакетирование и пауза между запросами.
• Ошибка валидации атрибута — не заполнен обязательный или словарный атрибут категории.
• Пустой или неуникальный offer_id — товар не создаётся или перезаписывает чужой.
• Недоступные изображения — URL закрыт авторизацией, отдаёт 404 или редирект.

Итог

Выгрузка на Ozon из 1С-Битрикс — это не генерация файла, а полноценная интеграция по Seller API: подготовка каталога (артикулы, штрихкоды, габариты, изображения), маппинг категорий и атрибутов, создание карточек через /v3/product/import и раздельная синхронизация цен и остатков по расписанию. Аккуратный маппинг и логирование ошибок экономят десятки часов на разборе отклонённых позиций.

Мы в B2Bsite настраиваем такие интеграции под конкретный каталог: связываем свойства инфоблоков с атрибутами Ozon, подключаем обмен к сессиям 1С и берём обмен на сопровождение, чтобы цены и остатки на площадке всегда совпадали с сайтом.