Публикация на 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
На странице Настройки → Маркетплейсы кнопка «+ Добавить кабинет» открывает модал: шаг 1 — выбор площадки (Ozon), шаг 2 — форма подключения со сворачиваемой подсказкой с шагами выше, полем «Название кабинета» и двумя полями credentials — Client-Id и API-ключ.
Кнопка «↻ Синхронизировать» проверяет введённые ключи без сохранения (запрашивает первую страницу товаров); «Подключить» сохраняет их и сразу синхронизирует существующие товары.
После подключения карточка кабинета в списке показывает статус, число синхронизированных товаров, время последней синхронизации и ссылку «↗ Кабинет Ozon» на seller.ozon.ru. Кнопка «Редактировать» открывает ту же форму для смены ключей или названия, кнопка отключения — удаляет кабинет.
Можно подключить больше одного кабинета Ozon — например, для второго магазина — тем же «+ Добавить кабинет»: см. «Несколько кабинетов на маркетплейсе».
Публикация карточки по шагам
На карточке товара, в блоке «Маркетплейсы», у плитки «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 (Product Import API, метод архивации), запись в Cardix остаётся со статусом «Снято».
Удалить запись — доступно для снятых карточек и черновиков: запись, связка с товаром, ключевые слова и позиции удаляются из Cardix безвозвратно. Сама площадка при этом не затрагивается — архивная карточка остаётся в архиве Ozon, её нужно удалять или разархивировать в кабинете Ozon отдельно.
«Снять с публикации» переносит карточку в архив Ozon — восстановить её (и продолжить редактирование) можно в кабинете Ozon, в разделе «Товары и цены → Архив».
Частые вопросы
Почему фото не подтягиваются на Ozon после публикации? Скорее всего, товар недоступен по публичной ссылке — Ozon не смог скачать файлы по URL. Включите публичный доступ или используйте внешние URL.
Сколько ждать подтверждения после «Опубликовать»? Импорт асинхронный: Cardix проверяет статус через несколько секунд автоматически, но фактическая модерация на стороне Ozon может занять больше времени — обновляйте статус кнопкой «Проверить статус».
Можно ли отредактировать уже опубликованную карточку? Да, форма остаётся доступной — повторное сохранение с публикацией обновит карточку на Ozon.
AI не находит нужную категорию — что делать? Выберите категорию и тип вручную через поиск, затем запустите AI-заполнение ещё раз — оно подставит атрибуты уже в рамках выбранной категории.