Cardıx

Публикация на Ozon: Client-Id, Api-Key и карточка через API

Cardix публикует карточки на Ozon напрямую через Product Import API Ozon Seller — в отличие от Авито, здесь нет промежуточного фида: сохранение с публикацией сразу отправляет карточку на модерацию Ozon.

Что нужно в кабинете Ozon Seller

  1. Войдите в Ozon Seller Portal под аккаунтом продавца.
  2. Откройте Настройки → API-ключи → Создать ключ.
  3. Скопируйте Client-Id и Api-Key — ключ показывается один раз, сохраните его сразу. Какие права выдавать ключу и как хранить его безопасно — в гайде по API-ключам Ozon.

Аутентификация Ozon строится на этих двух постоянных заголовках (Client-Id + Api-Key), а не на OAuth — ключ не истекает сам по себе, только если вы отзовёте его в кабинете Ozon.

Подключение в Cardix

На странице Настройки → Маркетплейсы кнопка «+ Добавить кабинет» открывает модал: шаг 1 — выбор площадки (Ozon), шаг 2 — форма подключения со сворачиваемой подсказкой с шагами выше, полем «Название кабинета» и двумя полями credentials — Client-Id и API-ключ.

Кнопка «↻ Синхронизировать» проверяет введённые ключи без сохранения (запрашивает первую страницу товаров); «Подключить» сохраняет их и сразу синхронизирует существующие товары.

Подключение Ozon

После подключения карточка кабинета в списке показывает статус, число синхронизированных товаров, время последней синхронизации и ссылку «↗ Кабинет Ozon» на seller.ozon.ru. Кнопка «Редактировать» открывает ту же форму для смены ключей или названия, кнопка отключения — удаляет кабинет.

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

Публикация карточки по шагам

На карточке товара, в блоке «Маркетплейсы», в строке «Ozon» нажмите «Создать объявление» (или «Связать с существующим», если карточка на Ozon уже есть) — откроется отдельная страница публикации.

  1. Категория подбирается в два шага: Ozon хранит категории деревом, где листом является пара «категория + тип товара» — в форме это одно поле поиска и выпадающий список «Родитель › Тип».
  2. Нажмите «✨ Заполнить через AI» — модель заполнит название, описание (в Ozon оно хранится как атрибут «Аннотация»), НДС, атрибуты выбранного типа и оценит габариты и вес в упаковке, если их ещё нет в товаре (оценка сохранится в товар). Цену AI не трогает — она берётся из товара. Значения справочных полей (бренд, тип, объём памяти…) Cardix подбирает по справочнику Ozon, в том числе поиском по всему справочнику; если подходящего значения в справочнике нет, под полем появится подсказка «Автозаполнение предложило „…“ — выберите подходящее» — значение не теряется молча. Характеристики, которых нет в данных товара, AI не выдумывает и оставляет пустыми. Если категория ещё не выбрана, AI подберёт её и тип сама, а потом заполнит поля. Пока AI не запущен, поле описания по умолчанию уже подставлено из обзора Cardix или, если он ещё не сформирован, из описания, засинканного с Ozon.
  3. В блоке «Фото» выберите до 10 изображений из галереи товара (клик переключает выбор, порядок клика = порядок фото на Ozon); прямо на плитках доступны кнопка «⚡» (инфографика из этого фото; фон для неё выбирается переключателем над галереей). Для внешних ссылок есть переключатель «Вставить URL вручную…».
  4. Раскрывающийся блок «Цены с рынка» показывает диапазон и медиану найденных цен конкурентов — клик по столбцу гистограммы или по медиане подставляет значение в поле «Цена (₽)».
  5. Проверьте и, если нужно, донастройте атрибуты категории — справочные поля отображаются выпадающим списком с поиском по справочнику Ozon (у большого справочника, например брендов, начните вводить название), обязательные помечены звёздочкой.
  6. Проверьте блок «Габариты и вес в упаковке» — длина, ширина, высота (см) и вес (кг) коробки, в которой товар поедет покупателю. Без них Ozon не создаёт карточку. Если они уже есть в товаре (блок «Логистика и учёт»), форма заполнит их сама — над полями будет строка «Из товара» с бейджем источника. Поменяли габариты в форме — нажмите «Сохранить в товар», чтобы они подставлялись и в другие формы.
  7. НДС — выберите ставку: 22%, 10%, 5% или 7% (для УСН), «Без НДС (0%)». Если ставка указана в товаре, AI-заполнение подставит её само.
  8. Нажмите «Сохранить черновик» или «Опубликовать на Ozon» — публикация вызывает Ozon Product Import API, а затем проверяет, создал ли Ozon карточку и прошла ли она валидацию.

Проверка перед публикацией. Под кнопкой «Опубликовать» Cardix показывает, чего не хватает: фото, габариты, цена, обязательные атрибуты категории (например, «ТН ВЭД коды ЕАЭС», «Нужен код маркировки»). Пока список не пуст, а также пока идёт автозаполнение или загружаются атрибуты категории, кнопка неактивна — заведомо неполная карточка в Ozon не отправляется. Черновик можно сохранить в любой момент.

Форма публикации на Ozon

Про фото: Ozon скачивает изображения по URL самостоятельно, поэтому файлы должны быть доступны по публичной ссылке. Если у товара не включён публичный доступ (см. «Каталог товаров»), форма предупреждает: «Товар не открыт по публичной ссылке — Ozon не сможет скачать эти фото» — включите доступ по ссылке в карточке товара или вставьте внешние URL вручную.

Товар с вариантами

Если у товара несколько вариантов — например, цвет и объём памяти (см. «Варианты товара»), — под общими полями формы появляется блок «Варианты»: строка на каждый вариант.

  • Публиковать — какие варианты отправить на Ozon. Новые варианты включены; галочка «Публиковать все» включает или снимает все разом.
  • Артикул (offer_id) — у каждого варианта свой. Оставьте поле пустым — Cardix возьмёт артикул варианта (у основного варианта — артикул карточки; до 50 символов) или создаст свой cardix-…. Артикул варианта, уже отправленного на Ozon, не меняется.
  • Цена, зачёркнутая цена и баркод при первом открытии формы подставляются из вкладки «Варианты» товара; здесь их можно поправить только для Ozon. Если оставить цену пустой, при сохранении подставится цена из вкладки «Варианты» — форма отметит такую строку. После первого сохранения формы действуют значения из её строк: правки во вкладке «Варианты» в форму Ozon уже не попадают — меняйте цену и баркод для Ozon здесь. Зачёркнутая цена должна быть больше цены.
  • Статус и ошибки Ozon у каждого варианта свои и обновляются сами. Пока хоть один вариант на проверке, в форме есть кнопка «Проверить статус».
  • Выключение уже опубликованного варианта не снимает его карточку с Ozon — для этого снимите товар с публикации (кнопка «Снять с публикации» есть в форме, пока на Ozon есть хоть один вариант). Пока вариант на проверке Ozon, снять карточку нельзя — дождитесь ответа.

У товара с комплектациями (см. «Варианты товара») в блоке только варианты, которые есть в товаре.

Общих полей «Артикул» и «Цена» в блоке «Цена и параметры» в этом случае нет — цены задаются в строках. Клик по цене в «Ценах с рынка» подставит её во все включённые варианты.

Как Ozon объединяет варианты. Каждый включённый вариант уходит на Ozon отдельным товаром со своим артикулом, а в одну карточку их собирает общий признак «Объединить на одной карточке» — Cardix ставит в него бренд и модель. Варианты должны отличаться только признаками, которые Ozon считает вариативными (аспектами): цвет, размер, объём памяти. AI-заполнение сопоставляет оси вариантов с такими признаками категории и показывает значения под строкой варианта, например «Ozon: Цвет товара: черный». Если для какой-то оси (например, «SIM-карта») такого признака в категории нет, над строками появится предупреждение «Ozon склеит варианты только с одинаковым значением „SIM-карта“ — по этой оси будут отдельные карточки». Тогда Cardix добавляет значение этой оси к бренду и модели в признаке объединения: варианты с eSIM соберутся в одну карточку, с nano-SIM — в другую, а цвет и память останутся переключателями внутри каждой. Если у всех осей нет признака, каждый вариант станет отдельной карточкой. Вариативные признаки нельзя менять после первой поставки или продажи — проверьте их до публикации.

Название варианта на Ozon — название карточки и опции через запятую: «Apple iPhone 16 Pro, 256 ГБ, Natural Titanium». Фото — собственные фото варианта, если они выбраны во вкладке «Варианты»; иначе — фото его цвета и общие фото модели, если AI нашёл их при сборе; иначе фото карточки. Вариант по умолчанию (первый в списке) без своих фото всегда уходит с фото карточки — их вы подбираете в форме. Если вы выключили его в форме, фото карточки получит первый включённый вариант: учитываются отметки в форме на момент публикации, даже если вы их ещё не сохраняли.

После публикации варианта Cardix отправляет то, что Ozon принимает только у созданного товара:

  • минимальную цену, если она задана у варианта. Ozon разрешает менять цену товара не чаще 10 раз в час;
  • оптовые цены — до 4 уровней, в процентах скидки от цены: «от 10 шт — 95 000 ₽» при цене 100 000 ₽ станет скидкой 5% от 10 штук. Если уровней больше 4, уйдут первые 4, а под строкой появится предупреждение.

Если Ozon не принял минимальную цену или опт, под строкой варианта будет «⚠ …» — сама публикация при этом остаётся.

Проверка перед публикацией для вариантов: хотя бы один включённый вариант, цена больше 0 у каждого включённого, зачёркнутая цена больше цены, артикулы не повторяются.

Снятие с публикации переносит в архив Ozon все опубликованные варианты карточки разом.

Статусы и ошибки

Статус карточки отображается цветной плашкой вверху формы: Черновик, На проверке, Опубликовано, Ошибка. «Опубликовано» ставится только когда Ozon подтвердил, что карточка создана и прошла валидацию, — принятый импорт сам по себе ещё ничего не значит. Пока Ozon проверяет карточку, показывается баннер «⏳ Ожидаем подтверждения от Ozon…». Cardix проверяет статус в фоне — и с закрытой вкладкой; как только Ozon ответит, статус в открытой форме обновится сам. Первые минуты проверка идёт каждые 30 секунд, дальше всё реже (до раза в 5 минут), чтобы не перегружать API Ozon; если за 2 часа Ozon так и не ответил, карточка получит статус «Ошибка» с подсказкой проверить её в кабинете. Кнопка «Проверить статус» проверяет сразу. Если Ozon карточку не принял, статус станет «Ошибка», а под ним — причины от Ozon по-русски, например «Габариты и вес: не заполнены; Нужен код маркировки: обязательное поле».

Черновик можно удалить через меню «⋯» → «Удалить черновик»; если публикация уже отправлена в Ozon (статус «На проверке»), Cardix предупредит, что карточка всё равно может появиться на площадке при следующей синхронизации.

Снятие с публикации и удаление

Снять с публикации — карточка переносится в архив Ozon (Product Import API, метод архивации), запись в Cardix остаётся со статусом «Снято».

Удалить запись — доступно для снятых карточек и черновиков: запись, связка с товаром, ключевые слова и позиции удаляются из Cardix безвозвратно. Сама площадка при этом не затрагивается — архивная карточка остаётся в архиве Ozon, её нужно удалять или разархивировать в кабинете Ozon отдельно.

«Снять с публикации» переносит карточку в архив Ozon — восстановить её (и продолжить редактирование) можно в кабинете Ozon, в разделе «Товары и цены → Архив».

Частые вопросы

Почему фото не подтягиваются на Ozon после публикации? Скорее всего, товар недоступен по публичной ссылке — Ozon не смог скачать файлы по URL. Включите публичный доступ или используйте внешние URL.

Сколько ждать подтверждения после «Опубликовать»? Импорт асинхронный: Cardix проверяет статус через несколько секунд автоматически, но фактическая модерация на стороне Ozon может занять больше времени — обновляйте статус кнопкой «Проверить статус».

Можно ли отредактировать уже опубликованную карточку? Да, форма остаётся доступной — повторное сохранение с публикацией обновит карточку на Ozon.

AI не находит нужную категорию — что делать? Выберите категорию и тип вручную через поиск, затем запустите AI-заполнение ещё раз — оно подставит атрибуты уже в рамках выбранной категории.

Смотрите также