Подключение Яндекс Маркета

Для подключения Яндекс Маркета MarkerView нужны Business ID и API key. В карточке также есть поле для OAuth-токена, но актуальный и документированный путь для нового подключения — отдельный API key с ограниченными правами. В облачной версии все значения вводятся через интерфейс MarkerView, без терминала и файлов конфигурации.

Создать API key

По официальной инструкции Яндекс Маркета токены создают владелец или менеджер кабинета.

1. В кабинете продавца нажмите значок аккаунта и откройте Настройки → API и модули.
2. В блоке Токены авторизации нажмите Создать новый токен.
3. Дайте токену понятное отдельное название, например «MarkerView».
4. Выберите доступ «Общение с покупателями». Если кабинет предлагает чтение и управление раздельно, разрешите необходимые действия с отзывами и вопросами; не выдавайте доступ к финансам или заказам без необходимости.
5. Создайте и скопируйте токен.

Актуальные названия групп и порядок действий приведены в документации Яндекса: создание API key и группы доступов. Не публикуйте токен и не отправляйте его в поддержку целиком. При утечке удалите токен в кабинете Маркета и создайте новый.

Business ID — идентификатор бизнеса, а не отдельного товара. Его можно взять из адреса страницы бизнеса или данных кабинета. Campaign ID относится к конкретному магазину и в текущем подключении MarkerView необязателен. Если сомневаетесь, сверяйте идентификаторы с документацией Partner API.

Подключить источник

1. В MarkerView откройте Маркетплейсы.
2. В карточке Яндекс Маркет заполните API key и Business ID.
3. Поле OAuth token оставьте пустым: эта инструкция и текущий документированный сценарий используют API key.
4. При необходимости укажите Campaign ID; для получения отзывов на уровне бизнеса он не обязателен.
5. Нажмите Сохранить доступы.
6. Если карточка выключена, включите её переключателем.
7. Нажмите Синхронизировать.

Ожидаемый результат: в карточке появляются «Доступы сохранены» и «Готов к синхронизации», а MarkerView сообщает о запуске. Результат смотрите в разделе отзывов. Состав истории и медиа определяется тем, что возвращает API вашему бизнесу; MarkerView не обещает загрузить недоступные площадкой данные.

Пустые поля при повторном сохранении не удаляют записанные значения. Чтобы заменить ключ, вставьте новый и сохраните карточку.

Публикация ответов

Переключатель Публикация ответов разрешает MarkerView отправлять ответы на Маркет. Оставьте его выключенным, если сотрудники должны только читать и модерировать данные. Для отправки ответов токену нужны права на соответствующие методы общения с покупателями.

Состояния и частые ошибки

• «Не настроен» — нет Business ID либо не сохранён ни API key, ни OAuth token.
• «Отключён» — реквизиты сохранены, но источник исключён из синхронизации.
• Ошибка 401 — ключ неверен, удалён либо ещё не применились изменения. По документации Яндекса обновление прав может занимать до 10 минут.
• 403 обычно означает, что токену не разрешена нужная группа методов или пользователь не имеет доступа к указанному бизнесу.
• Пустой результат при рабочем ключе — проверьте, что указан именно Business ID нужного бизнеса, а не Campaign ID магазина.
• «Уже выполняется» — текущая синхронизация ещё не завершилась.
• Если отзыв есть в MarkerView, но отсутствует на карточке сайта, сравните артикул предложения с каталогом по инструкции «Каталог товаров».

Одна карточка Яндекс Маркета в MarkerView подключает один бизнес. Для другого Business ID нужен отдельный аккаунт MarkerView.