Как получить ключ API Яндекс Маркета
Токен, ID бизнеса и ID кампании: где их взять и какие доступы обязательно отметить, чтобы работала отгрузка.
Для Яндекс Маркета нужны три значения: токен, ID бизнеса и ID кампании. Все три — в кабинете продавца.
Шаг 1. Создайте токен
Зайдите в кабинет продавца Яндекс Маркета, нажмите на иконку аккаунта → «Настройки» и в меню слева выберите «API и модули». В блоке «Токены авторизации» нажмите «Создать новый токен».
Шаг 2. Выберите доступы — это ключевой момент
Яндекс предложит отметить, что можно делать этим токеном. Самый простой и надёжный вариант — «Полное управление кабинетом».
Если хотите выдать доступ точечно, отметьте эти группы — именно с правом изменения, а не «только просмотр»:
- Обработка заказов и учёт товаров — заказы, сборка, статусы, этикетки, коды маркировки, остатки.
- Управление товарами и карточками — загрузка вашего каталога.
- Управление ценами — цены товаров.
- Общение с покупателями — отзывы и ответы на них.
- Просмотр финансовой информации и отчётности — комиссии, выручка, расходы.
- Поставки (если работаете по FBY) — заявки на поставку; здесь достаточно просмотра.
- Доступ к акциям и продвижению — акции, в которых участвуют ваши товары; здесь тоже достаточно просмотра.
Скопируйте готовый токен. Он действует бессрочно — пока вы сами его не удалите.
Шаг 3. Найдите ID бизнеса и ID кампании
Это два разных числа, и их легко перепутать.
- ID бизнеса — номер вашего кабинета целиком (общий на все магазины внутри него). Виден в настройках кабинета.
- ID кампании — номер конкретного магазина (витрины). Виден в настройках магазина; он же обычно есть в адресной строке при работе с магазином.
Шаг 4. Вставьте в UnitPlace и выберите формат этикетки
- Откройте Настройки → Магазины и ключи и в карточке магазина нажмите «+ Яндекс Маркет».
- Вставьте ID бизнеса, ID кампании и API-токен.
- Выберите формат этикетки — без него кнопка «Подключить» не активна. Так мы будем печатать ярлыки для ваших отправлений:
- Горизонтальный — 58×40 мм, QR-код (подходит для большинства термопринтеров).
- Вертикальный — 75×120 мм, линейный штрих-код.
- Придумайте название интеграции и нажмите «Подключить».
Мы сразу проверим токен: если у него нет доступа к каталогу, скажем об этом прямо в форме. Право на изменение (сборка, остатки, цены) проверить заранее нельзя — поэтому так важен шаг 2.
Если что-то пошло не так
«Ключ недействителен или отозван» — скорее всего, токен скопирован не целиком.
«У токена нет доступа к товарам бизнеса» или товары и финансы не загрузились — у токена не хватает доступа к каталогу. Пересоздайте токен с «Полным управлением кабинетом».
Заказы видны, но «Собрать» не работает — токен выдан в режиме «только просмотр». Нужен токен с правом изменения.