⚡ Cardix

Публикация на Яндекс.Маркет: Api-Key и карточка через Partner API

Cardix публикует карточки на Яндекс.Маркет через Partner API — сохранение с публикацией отправляет данные оффера площадке синхронно, а саму карточку Маркет создаёт и модерирует в фоне; Cardix опрашивает статус, пока карточка не появится или площадка не вернёт ошибку.

Что нужно в кабинете Яндекс.Маркета

  1. Войдите в partner.market.yandex.ru под аккаунтом продавца.
  2. Слева внизу откройте «Настройки» → «Обмен данными (API)» → вкладку «Api-Key».
  3. Нажмите «Создать токен» и выберите доступ «Управление товарами и карточками» (подойдёт и «Полное управление кабинетом»).
  4. Скопируйте токен — он показывается один раз.

В отличие от Ozon, отдельный Client-Id вводить не нужно: Cardix определяет businessId кабинета автоматически по токену при подключении (GET /v2/campaigns).

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

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

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

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

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

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

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

  1. Заполните Название (до 256 символов) и Описание (до 6000 символов) — по умолчанию описание подставляется из обзора Cardix.
  2. В блоке «Фото» выберите до 30 изображений из галереи товара (клик переключает выбор, порядок клика = порядок фото на Маркете); на плитках доступны AI-кнопки «✨» (замена фона) и «⚡» (инфографика из этого фото).
  3. Раскрывающийся блок «Цены с рынка» показывает диапазон и медиану найденных цен конкурентов — клик по столбцу гистограммы или по медиане подставляет значение в поле «Цена (₽)»; там же — необязательное поле «Бренд».
  4. В поле «Категория» введите название или найдите нужный пункт в списке — Cardix показывает плоский список листовых категорий дерева ЯМ с полным путём.
  5. Нажмите «✨ Заполнить через AI» — модель сама подберёт ветку и листовую категорию (если категория ещё не выбрана), а затем заполнит название, описание, бренд, цену и характеристики категории одним запросом.
  6. Заполните обязательные характеристики категории — справочные поля отображаются выпадающим списком, текстовые/числовые — полем ввода, булевы — переключателем «Да/Нет».
  7. Нажмите «Сохранить черновик» или «Опубликовать на Яндекс.Маркете» — публикация отправляет оффер через Partner API (offer-mappings/update) и ставит фоновую задачу проверки статуса карточки.

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

Статус показан плашкой рядом с заголовком страницы: Черновик, ⏳ Ожидаем подтверждения..., ✓ Опубликовано, ✗ Ошибка. Обновление приходит в реальном времени без перезагрузки страницы — как только Маркет подтверждает карточку, статус меняется на «Опубликовано». Держать вкладку открытой не обязательно — прогресс сохраняется и восстановится при следующем визите (опрос идёт до 30 минут, раз в 30 секунд).

Если Маркет отклонил карточку, под заголовком появляется точный текст ошибки от площадки.

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

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

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

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

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

Нужен ли Client-Id, как у Ozon? Нет, для Яндекс.Маркета достаточно одного Api-Key — businessId кабинета Cardix определяет сама.

Сколько ждать подтверждения после «Опубликовать»? Отправка оффера синхронна, но саму карточку Маркет создаёт и модерирует в фоне — обычно быстрее, но опрос статуса продолжается до 30 минут на случай задержки на стороне площадки.

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

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

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