Как подключить Яндекс Маркет к ТурбоКапусте
Для подключения нужны API-ключ и ID кампании магазина. Отдельно проверьте, включён ли доступ магазина к API: действующий ключ сам по себе этого не гарантирует.
Подготовьте ключ и ID магазина
Создать API-ключ в кабинете Маркета может владелец или менеджер кабинета. Выберите права под нужные операции и сохраните ключ для подключения ТурбоКапусты. Не используйте пароль от Яндекса вместо ключа.
Для поля «ID кампании» нужен campaignId конкретного магазина. Это не businessId кабинета и не идентификатор рекламной кампании. Если у Вас несколько магазинов, проверьте, к какому из них относится выбранный ID и имеет ли ключ доступ к нему.
Начните с прав на просмотр
Для анализа нужны права на просмотр товаров, цен, заказов и финансовой информации — в зависимости от задачи. Управление товарами и управление ценами предоставляются отдельно. Полное управление кабинетом не требуется только для того, чтобы посмотреть данные.
Точные группы методов перечислены в официальной документации Маркета. Название права описывает разрешённые API-операции, но не гарантирует, что любая функция Маркета уже поддерживается ТурбоКапустой.
Сохраните реквизиты и проверьте подключение
Менять реквизиты могут владелец и администратор пространства. В одном пространстве хранится один набор реквизитов Яндекс Маркета: замена ID кампании переключает подключение, а не добавляет ещё один магазин.
- Выберите нужное рабочее пространство в ТурбоКапусте и откройте «Настройки» → «Доступы».
- Найдите блок Yandex Market, нажмите «Добавить доступы» и заполните поля «API-ключ» и «ID кампании».
- Нажмите «Сохранить доступы», затем «Проверить». Проверьте отдельно те данные, с которыми собираетесь работать.
- После подтверждения доступа и синхронизации откройте «Товары». Сверьте артикулы и магазин с кабинетом Маркета.
Что проверить при ошибке
После изменения прав на стороне Маркета повторите проверку, когда изменения вступят в силу. Если проблема сохраняется, напишите в «Поддержка»: укажите ID кампании, задачу и результат проверки без API-ключа. Не публикуйте ключ в переписке или скриншотах.
| Ситуация | Следующий шаг |
|---|---|
| Ключ сохранён, но данные не читаются | Проверьте ключ, соответствие campaignId магазину и доступ магазина к API. |
| Каталог доступен, отчёт — нет | Проверьте права нужной группы методов и поддержку самого отчёта. |
| API отключён на стороне Маркета | Устраните причину в кабинете продавца: ручное отключение, неактивность или незавершённое подключение магазина. |
| Аналитика отмечена «Не проверено» | Для проверки может не хватать подходящего товара. Этот статус не означает нулевые продажи. |
Источники и требования площадок
Правила площадок могут меняться. Перед подключением или публикацией проверьте актуальную инструкцию.
Добавьте доступ к кабинету
В настройках выберите маркетплейс, сохраните ключ и проверьте доступ к нужным данным. Пароль от кабинета не потребуется.
Создать аккаунтПервая задача после подключения