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

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

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

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

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

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

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

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

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

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

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

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

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

Проверка перед публикацией. Под кнопкой Cardix показывает, чего не хватает: фото, габариты, цена, бренд, обязательные характеристики. Пока список не пуст или идёт автозаполнение/загрузка характеристик, кнопка неактивна; черновик сохраняется всегда.

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

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

Каждый вариант — отдельный товар Маркета со своим SKU (offerId), ценой, зачёркнутой ценой и баркодом. SKU можно задать самому; пусто — у варианта по умолчанию остаётся прежний SKU карточки, а при первой публикации он будет cardix-ym-…; у остальных Cardix возьмёт артикул варианта, а если артикула нет, назначит cardix-ym-…. После отправки на Маркет SKU не меняется — так требует Маркет.
Маркет объединяет варианты в одну карточку, если у них одинаковое «Название группы вариантов» (по умолчанию — бренд и модель, поле в блоке «Варианты») и различаются отличительные характеристики категории — цвет, объём памяти, размер. Их подбирает «✨ Заполнить через AI» и показывает у варианта строкой «Маркет: …».
Когда объединения не будет, в блоке появится предупреждение, а товары уйдут отдельными карточками: категория не поддерживает объединение; для оси (например, «SIM-карта») у категории нет отличительной характеристики; у двух вариантов одинаковые отличительные характеристики.
Галка «Публиковать» — какие варианты отправить. При публикации Cardix отправляет все отмеченные варианты одним запросом; если Маркет отклонил хотя бы один, он не принимает ни один из них — у вариантов появится причина («Маркет не принял ни один вариант из-за …»), исправьте и опубликуйте снова. Снятая галка не снимает товар с Маркета — для этого снимите товар с публикации.
Цены: зачёркнутая цена уходит на Маркет, если скидка от 5 до 99%. Оптовые цены Маркет через API не принимает — уровни из вкладки «Варианты» на Маркет не уходят.
Статусы — у каждого варианта; статус товара в списке — сводный. «Снять с публикации» отправляет в архив Маркета все варианты товара.
Быстрая смена цены в карточке площадки («Маркетплейсы» → карточка) меняет цену только варианта по умолчанию; цены остальных вариантов — в форме публикации.

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

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

Если Маркет отклонил карточку, под заголовком появляется точный текст ошибки от площадки — с названиями характеристик, а не их номерами. «Ошибка» ставится и когда Маркет просит дозаполнить карточку («Маркет просит дозаполнить карточку: …» со списком недостающих характеристик), и когда у карточки есть ошибки контента. Если товар попал на карточку, которой управляет сам Маркет (типично для брендовых товаров), это нормальный исход — статус «Опубликовано».

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

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

Снять с публикации — оффер архивируется на Яндекс.Маркете (Partner API, метод архивации офферов), запись в Cardix получает статус «Снято», если Маркет архивирует все товары. У товара с вариантами в архив уходят все его товары на Маркете. Если Маркет не архивирует часть товаров (например, на складе Маркета есть остатки), Cardix покажет предупреждение «Маркет не снял N из M товаров: …», а карточка не получит статус «Снято», пока не уйдут оставшиеся: распродайте или вывезите остатки и снимите повторно.

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

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

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

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

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

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