Скидка 30% на все темы дизайна — только до конца месяца! Купить со скидкой
База знаний
Bodysite.Help — единая база знаний и хаб поддержки по всем продуктам

Выгрузка товаров через API

Плагин «Интеграция с Яндекс.Маркет» передаёт на Маркет карточки товаров (название, описание, категория, характеристики, фото) через Partner API.

Важно: карточки, цены и остатки передаются отдельно. offerId должен совпадать во всех трёх процессах.


Требования

  • Плагин установлен, профиль кампании (DBS / FBS / FBS express) включён
  • Указан ID кампании Яндекс.Маркета
  • Настроен API-ключ или OAuth-токен
  • Получен Business ID (кнопка «Получить Business ID»)
  • Настроены выбор товаров, сопоставление категорий, поля карточки

Где настраивать

Магазин → Настройки → Плагины → Интеграция с Яндекс.Маркет → профиль кампании → блок «Выгрузка карточек на Яндекс.Маркет».


Настройка

1. Авторизация

Укажите API-ключ или OAuth-токен → сохраните → нажмите «Получить Business ID».

2. Выбор товаров

Категории / списки / типы, скрытые и недоступные товары, формат offerId, шаблон артикула.

3. Сопоставление категорий
  • «Обновить категории»
  • Для каждой категории магазина — листовая категория Маркета
  • «Сохранить»

Без сопоставления товар пропускается.

4. Поля карточки

Источники для названия, описания, артикула, бренда, габаритов, штрихкодов.
Фото подставляются из карточки товара автоматически.

5. Характеристики

Выберите категорию Маркета → «Загрузить параметры» → сопоставьте обязательные поля → сохраните.

6. Опции
  • «Выгружать карточки товаров» — включить выгрузку
  • «Удалять снятые товары с Маркета» — удалять карточки, которых нет в текущей выборке (включать осторожно)

Запуск

Вручную

«Запустить выгрузку» → дождитесь завершения. В отчёте: прогресс, выгружено, пропущено, ошибки (до 100).

По cron
php /путь/к/shop-script/cli.php shop pokupkiYaMarketOfferMappings 1

1 — номер профиля (DBS = 1, FBS = 2, FBS express = 3). Рекомендуется: 1 раз в сутки.


Что передаётся

offerId, название, описание, бренд, артикул, штрихкоды, страны, теги, вес и габариты, фото, категория Маркета, характеристики.


Ошибки

ПроблемаРешение
Пропущен — нет категорииСопоставить категорию
Пропущен — нет offerIdПроверить формат артикула
Ошибка авторизацииОбновить токен / ключ
Business ID пустой«Получить Business ID»
Ошибка по товаруИсправить данные / характеристики
Выгрузка стоитЛимит API (420) — подождать

Лог: wa-log/shop/plugins/pokupki/campaign.{номер}.offer-mappings.error.log


Чек-лист

  • Профиль включён, ID кампании и Business ID заполнены
  • Токен / ключ действует
  • Категории сопоставлены
  • Поля карточки и характеристики настроены
  • offerId совпадает с ценами и остатками
  • Выгрузка запущена или настроен cron
Инструкция была полезна?
83% считают ответ полезным
Спасибо за обратную связь!
Чтобы добавить комментарий, войдите в личный кабинет
Как правильно обращаться в техподдержку?
Не работает решение, что делать?
Не применяются настройки плагина, почему?
Куда пропали лицензии?
Как интегрировать плагин в мою тему дизайна
Купил плагин, как активировать лицензию?
Как можно получить скидку?
Есть ли тестовый период за продукт
Слетела лицензия что делать?
Не могу настроить CRON, что делать?
Написать в техподдержку
В техническую поддержку входит:
  • Консультации по вопросам приобретения
  • Консультации по функционалу и возможностям
  • Выявление и решение проблем в работе функционала
В техническую поддержку не входит:
  • Настройка решения
  • Доработка под запросы клиента
  • Устранение багов в консультационной форме (без предоставления доступов к сайту)
Платная диагностика:
  • Диагностика сложных и неоднозначных проблем
  • Выявление конфликтов со сторонними решениями
  • Выявление конфликтов в вашей среде сервера
  • Приоритетный срок на обработку тикетов
  • Оплата только банковской картой