Ozon. Руководство по настройке

Выгрузка на Ozon в Listify идёт только через Seller API: создаёте/обновляете карточки по offer_id. Файл-шаблон ZIP в интерфейсе не используется — статус и ошибки смотрите в блоке Интеграция.

Краткий старт

1. Подготовьте прайсы поставщиков и наценку — общие шаги.
2. Выберите площадку Ozon.
3. Укажите Client ID и API token, нажмите «Проверить подключение».
4. Добавьте категории Ozon и правила отбора из прайса.
5. Заполните поля карточки (НДС, габариты, правило артикула, описание).
6. Соберите ассортимент: прайс-лист и/или генерацию по ключевым словам.
7. Сохраните настройки и нажмите Запустить интеграцию.

Доступ к API

В блоке «Настройки доступа к Ozon» укажите:

• Client ID — число из кабинета продавца Ozon;
• API token — ключ Seller API (хранится зашифрованным; пустое поле при сохранении оставляет прежний ключ).

Нажмите «Проверить подключение». Ключи можно сохранить до проверки — без них интеграция не отправит товары.

Скрин: Client ID, API token и кнопка «Проверить подключение» Положите файл ozon-api.png в static/wiki/

Категории и правила

Нажмите «Добавить категорию» и выберите тип товара из дерева Ozon. Для каждой категории задайте правило, какие строки прайса в неё попадают, например:

• наименование содержит «комплект сцепления»;
• бренд равен … / артикул содержит …

Без подходящего правила позиция попадёт в «Без категории» и не уйдёт в API. Категории и правила сохраняются в настройках — заново выбирать их каждый день не нужно.

Скрин: список выбранных категорий Ozon Положите файл ozon-categories.png в static/wiki/

Скрин: модалка добавления правила к категории (поле, условие, значение) Положите файл ozon-rule.png в static/wiki/

Поля и карточка

В «Поля Ozon» видны обязательные поля и атрибуты категории. Дополнительные характеристики можно добавить из справочника.

В «Карточка на Ozon» задайте:

• Правило offer_id — бренд_артикул или только артикул (так Ozon узнаёт товар при повторных выгрузках);
• НДС, габариты и вес упаковки;
• шаблон описания без HTML: [Код], [Наименование товара], [Бренд];
• при необходимости — ТН ВЭД, склад в ЛК Ozon;
• в блоке «Общие» — логотип для товаров без фото (один файл на аккаунт).

Скрин: таблицы обязательных полей и атрибутов категории Ozon Положите файл ozon-fields.png в static/wiki/

Скрин: блок «Карточка на Ozon» — offer_id, НДС, габариты, описание Положите файл ozon-card.png в static/wiki/

Фильтры и одинаковые товары

Перед отправкой в API применяются фильтры канала: диапазон продажных цен, минимальный остаток, бренды и правило для одинаковых товаров.

Скрин: фильтры канала Ozon и блок одинаковых товаров Положите файл ozon-filters.png в static/wiki/

Сохранённые настройки

Сохраните набор (категории, правила, поля) под именем и переключайтесь между профилями. Активный профиль записывается в рабочие настройки — именно его использует следующий запуск интеграции.

Скрин: «Сохранить настройки» и таблица профилей Ozon Положите файл ozon-profiles.png в static/wiki/

Откуда берутся товары

Интеграция не берёт весь каталог поставщика. В выгрузку попадают только две вещи, и их можно сочетать:

• активная генерация по ключевым словам этой площадки;
• сохранённые прайс-листы с колонками артикул и бренд.

Цена и остаток подставляются из прайса поставщика в момент запуска. Одинаковые артикул и бренд из разных источников остаются одной позицией. Если нет ни активного снимка, ни файла, кнопка запуска сообщит, что ассортимент не задан.

Добавить прайс-лист

Кнопка Добавить прайс-лист стоит рядом с «Запустить интеграцию». В окне укажите название и файл xlsx, xls или csv. В файле нужны колонки Артикул и Бренд — цену и остаток туда класть не нужно.

Файлы копятся в таблице под блоком: название, число строк, дата и кнопка «Удалить». На одной площадке можно хранить до 30 таких прайсов. Если сохранить файл с уже существующим названием, он заменит прежний. Эти файлы не зависят от профилей настроек: категории и поля могут меняться, список артикулов останется.

Генерация по ключевым словам

Откройте раздел Генерация прайса по фильтрам, задайте правила и нажмите «Сформировать прайс по фильтрам». В окне выберите Ozon. Для Авито и Дрома файл скачается, а для Ozon снимок сохранится на площадке — скачивать его не нужно.

В блоке «Генерация по ключевым словам» на странице Ozon появится статус:

• Не сформирована — снимок ещё не делали;
• Активна — следующий запуск интеграции возьмёт эти позиции;
• Не активна — снимок есть, но в выгрузку не входит.

Под статусом видны слова правил, число позиций и дата. Новая генерация для Ozon заменяет предыдущий снимок и снова делает его активным. Кнопка Снять активность убирает снимок из следующих запусков, загруженные прайс-листы при этом остаются.

Правила те же, что в общей генерации: слово в названии, бренд, диапазон цены продажи, стоп-слова. Пустое слово при указанном бренде отбирает весь бренд. Нужны уже загруженные прайсы поставщиков.

Интеграция

Вверху страницы Ozon — блок Интеграция:

• «Запустить интеграцию» — подготовка по правилам + отправка в Seller API по активной генерации и сохранённым прайсам;
• счётчики: подготовлено, без категории, без цены, отправлено, успешно, ошибки;
• таблицы ошибок по offer_id и позиций без категории;
• лог хода выполнения.

Скрин: блок Интеграция Ozon — кнопка запуска, счётчики, таблица ошибок Положите файл ozon-integration.png в static/wiki/