Публикация на Ozon: Client-Id, Api-Key и карточка через API
Cardix публикует карточки на Ozon напрямую через Product Import API Ozon Seller — в отличие от Авито, здесь нет промежуточного фида: сохранение с публикацией сразу отправляет карточку на модерацию Ozon.
Что нужно в кабинете Ozon Seller
- Войдите в Ozon Seller Portal под аккаунтом продавца.
- Откройте Настройки → API-ключи → Создать ключ.
- Скопируйте Client-Id и Api-Key — ключ показывается один раз, сохраните его сразу.
Аутентификация Ozon строится на этих двух постоянных заголовках (Client-Id + Api-Key), а не на OAuth — ключ не истекает сам по себе, только если вы отзовёте его в кабинете Ozon.
Подключение в Cardix
На странице Настройки → Маркетплейсы карточка «Ozon» (ozon.ru — синхронизация товаров, публикация карточек) показывает кнопку «Подключить Ozon». Форма подключения содержит сворачиваемую подсказку с шагами выше и два поля — Client-Id и API-ключ.
Кнопка «↻ Синхронизировать» проверяет введённые ключи без сохранения (запрашивает первую страницу товаров); «Подключить» сохраняет их и сразу синхронизирует существующие товары.
После подключения карточка показывает статус, число синхронизированных товаров, время последней синхронизации и ссылку «↗ Кабинет Ozon» на seller.ozon.ru. Кнопка «Редактировать» открывает ту же форму для смены ключей или отключения интеграции.
Публикация карточки по шагам
На карточке товара, в блоке «Маркетплейсы», у плитки «Ozon» нажмите «Создать объявление» (или «Связать с существующим», если карточка на Ozon уже есть) — откроется отдельная страница публикации.
- Категория подбирается в два шага: Ozon хранит категории деревом, где листом является пара «категория + тип товара» — в форме это одно поле поиска и выпадающий список «Родитель › Тип».
- Нажмите «✨ Заполнить через AI» — один запрос к LLM заполнит название, описание (в Ozon оно хранится как атрибут «Аннотация»), цену, НДС и все атрибуты выбранного типа. Если категория ещё не выбрана, AI подберёт её и тип сама, а потом заполнит поля. Пока AI не запущен, поле описания по умолчанию уже подставлено из обзора Cardix или, если он ещё не сформирован, из описания, засинканного с Ozon.
- В блоке «Фото» выберите до 10 изображений из галереи товара (клик переключает выбор, порядок клика = порядок фото на Ozon); прямо на плитках доступны AI-кнопки «✨» (замена фона) и «⚡» (инфографика из этого фото). Для внешних ссылок есть переключатель «Вставить URL вручную…».
- Раскрывающийся блок «Цены с рынка» показывает диапазон и медиану найденных цен конкурентов — клик по столбцу гистограммы или по медиане подставляет значение в поле «Цена (₽)».
- Проверьте и, если нужно, донастройте атрибуты категории — справочные поля отображаются выпадающим списком, обязательные помечены звёздочкой.
- Нажмите «Сохранить черновик» или «Опубликовать на Ozon» — публикация вызывает Ozon Product Import API и через несколько секунд проверяет статус задачи.
Про фото: Ozon скачивает изображения по URL самостоятельно, поэтому файлы должны быть доступны по публичной ссылке. Если у товара не включён публичный доступ (см. «Каталог товаров»), форма предупреждает: «Товар не открыт по публичной ссылке — Ozon не сможет скачать эти фото» — включите доступ по ссылке в карточке товара или вставьте внешние URL вручную.
Статусы и ошибки
Статус карточки отображается цветной плашкой вверху формы: Черновик, На проверке, Опубликовано, Ошибка. Пока Ozon обрабатывает импорт, показывается баннер «⏳ Ожидаем подтверждения от Ozon…» с кнопкой «Проверить статус» для повторного опроса. При ошибке Ozon форма показывает текст ошибки, полученный от площадки.
Черновик можно удалить через меню «⋯» → «Удалить черновик»; если публикация уже отправлена в Ozon (статус «На проверке»), Cardix предупредит, что карточка всё равно может появиться на площадке при следующей синхронизации.
Частые вопросы
Почему фото не подтягиваются на Ozon после публикации? Скорее всего, товар недоступен по публичной ссылке — Ozon не смог скачать файлы по URL. Включите публичный доступ или используйте внешние URL.
Сколько ждать подтверждения после «Опубликовать»? Импорт асинхронный: Cardix проверяет статус через несколько секунд автоматически, но фактическая модерация на стороне Ozon может занять больше времени — обновляйте статус кнопкой «Проверить статус».
Можно ли отредактировать уже опубликованную карточку? Да, форма остаётся доступной — повторное сохранение с публикацией обновит карточку на Ozon.
AI не находит нужную категорию — что делать? Выберите категорию и тип вручную через поиск, затем запустите AI-заполнение ещё раз — оно подставит атрибуты уже в рамках выбранной категории.