Яндекс Маркет. Руководство по настройке

Интеграция с Маркетом в Listify — только по Partner API: карточки, цены и остатки. Старый сценарий через YML/XML не используется.

Краткий старт

1. Подготовьте прайсы и наценку — общие шаги.
2. Выберите Яндекс Маркет.
3. Вставьте API-Key, нажмите «Проверить подключение» — подтянутся кабинет, магазин и склад.
4. Выберите режим выгрузки (см. ниже).
5. Для режима «Обновлять всё» добавьте категории и правила, заполните поля.
6. Соберите ассортимент: прайс-лист и/или генерацию по ключевым словам.
7. Сохраните настройки и нажмите Запустить интеграцию.

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

Токен: ЛК Маркета → Настройки → API и модули. Скоупы: товары и карточки, цены, остатки.

1. Создайте токен с нужными правами.
2. Вставьте API-Key в Listify.
3. Нажмите «Проверить подключение».

Скрин: поле API-Key и «Проверить подключение» в Listify Положите файл market-api.png в static/wiki/

Скрин: создание токена в ЛК Яндекс Маркета (Api и модули) Положите файл market-token-market.png в static/wiki/

Режим выгрузки

В настройках канала выберите:

• Обновлять всё — карточки + цены + остатки (нужны категории и правила);
• Цены и остатки — только цены и остатки по уже существующим offerId, категории не нужны;
• Только остатки — только остатки на складе кабинета.

После первой полной выгрузки для ежедневного обновления обычно достаточно режима «Цены и остатки».

Скрин: выпадающий список «Режим выгрузки» Положите файл market-sync-mode.png в static/wiki/

Категории и правила

Добавьте категории из дерева автотоваров Маркета и задайте правила отбора из прайса (наименование содержит …, бренд и т.д.). Нужны для режима «Обновлять всё».

Скрин: выбранные категории Маркета Положите файл market-categories.png в static/wiki/

Скрин: правило отбора товаров для категории Маркета Положите файл market-rule.png в static/wiki/

Поля и упаковка

• SKU продавца (offerId) — правило бренд_артикул или артикул;
• габариты упаковки (мм) и вес (г);
• шаблон описания без HTML: [Код], [Наименование товара], [Бренд];
• доп. характеристики категории при необходимости;
• в блоке «Общие» — логотип для товаров без фото (один файл на аккаунт).

Склад для остатков берётся из кабинета после проверки API.

Скрин: поля Маркета и блок карточки/упаковки Положите файл market-fields.png в static/wiki/

Фильтры

Диапазон цен, мин. наличие, бренды, дедупликация — перед отправкой в API.

Скрин: фильтры канала Яндекс Маркет Положите файл market-filters.png в static/wiki/

Сохраните настройки кнопкой «Сохранить настройки». В профиле сохраняется и выбранный sync_mode — можно держать два набора («полный» и «только цены») и переключаться.

Скрин: кнопка сохранения настроек Маркета Положите файл market-save.png в static/wiki/

Откуда берутся товары

Интеграция не берёт весь каталог поставщика. В выгрузку попадают активная генерация по ключевым словам Маркета и сохранённые прайс-листы артикул+бренд. Их можно использовать вместе. Цена и остаток подставляются из прайса поставщика при запуске. Повтор артикула и бренда остаётся одной позицией. Без активного снимка и без файла запуск остановится: ассортимент не задан.

В режиме «Цены и остатки» и «Только остатки» список предложений берётся из тех же источников. Новые карточки при этом не создаются.

Добавить прайс-лист

Кнопка Добавить прайс-лист стоит рядом с «Запустить интеграцию». Укажите название и файл xlsx, xls или csv с колонками Артикул и Бренд. Цену и остаток в файл класть не нужно.

Таблица под блоком показывает название, число строк и дату. Файл можно удалить. На площадке до 30 таких прайсов. То же название заменяет уже сохранённый файл. Список не привязан к профилю настроек.

Генерация по ключевым словам

В разделе Генерация прайса по фильтрам нажмите «Сформировать прайс по фильтрам» и выберите Яндекс Маркет. Файл не скачивается: снимок сохраняется на площадке.

На странице Маркета блок «Генерация по ключевым словам» показывает статус Не сформирована, Активна или Не активна, а также слова правил, число позиций и дату. Новая генерация заменяет прошлый снимок и включает его. Снять активность исключает снимок из следующих запусков, загруженные прайсы остаются.

Правила — как в общей генерации: слово, бренд, цена продажи, стоп-слова. Пустое слово при указанном бренде отбирает весь бренд. Нужны прайсы поставщиков.

Интеграция

Блок Интеграция: запуск по активной генерации и сохранённым прайсам, статус, счётчики (в том числе обновлённые цены/остатки), ошибки и позиции без категории.

Скрин: блок Интеграция Яндекс Маркета — запуск, режим, счётчики, ошибки Положите файл market-integration.png в static/wiki/