К справке
Ключи маркетплейсов·обновлено 9 октября 2026 г.

Как получить ключ API Яндекс Маркета

Токен, ID бизнеса и ID кампании: где их взять и какие доступы обязательно отметить, чтобы работала отгрузка.

Для Яндекс Маркета нужны три значения: токен, ID бизнеса и ID кампании. Все три — в кабинете продавца.

Шаг 1. Создайте токен

Зайдите в кабинет продавца Яндекс Маркета, нажмите на иконку аккаунта → «Настройки» и в меню слева выберите «API и модули». В блоке «Токены авторизации» нажмите «Создать новый токен».

Создавать токены может только владелец кабинета или его менеджер. Если кнопки нет — у вашей учётной записи не хватает прав.
Скриншот
ЯМ → Настройки → API и модули → блок «Токены авторизации» с кнопкой «Создать новый токен»

Шаг 2. Выберите доступы — это ключевой момент

Яндекс предложит отметить, что можно делать этим токеном. Самый простой и надёжный вариант — «Полное управление кабинетом».

Если хотите выдать доступ точечно, отметьте эти группы — именно с правом изменения, а не «только просмотр»:

  • Обработка заказов и учёт товаров — заказы, сборка, статусы, этикетки, коды маркировки, остатки.
  • Управление товарами и карточками — загрузка вашего каталога.
  • Управление ценами — цены товаров.
  • Общение с покупателями — отзывы и ответы на них.
  • Просмотр финансовой информации и отчётности — комиссии, выручка, расходы.
  • Поставки (если работаете по FBY) — заявки на поставку; здесь достаточно просмотра.
  • Доступ к акциям и продвижению — акции, в которых участвуют ваши товары; здесь тоже достаточно просмотра.
Не выбирайте вариант «только просмотр» (read-only). UnitPlace не просто показывает заказы Яндекса — он собирает их за вас: переводит в статус «готов к отправке», передаёт коды маркировки, печатает этикетки, обновляет остатки и цены, публикует ответы на отзывы. С токеном «только просмотр» кнопка «Собрать» будет возвращать ошибку.
Скриншот
ЯМ: форма создания токена, момент выбора доступов — видно «Полное управление кабинетом» и список групп с галочками

Скопируйте готовый токен. Он действует бессрочно — пока вы сами его не удалите.

Шаг 3. Найдите ID бизнеса и ID кампании

Это два разных числа, и их легко перепутать.

  • ID бизнеса — номер вашего кабинета целиком (общий на все магазины внутри него). Виден в настройках кабинета.
  • ID кампании — номер конкретного магазина (витрины). Виден в настройках магазина; он же обычно есть в адресной строке при работе с магазином.
Скриншот
ЯМ: место, где видны ID бизнеса и ID кампании (номер магазина) — оба числа в кадре
Если магазинов в кабинете несколько — подключите каждый отдельной интеграцией («⋯» в строке Яндекс Маркета → «Добавить ещё кабинет Яндекс Маркет», на тарифах «Про» и «Безлимит»): ID бизнеса будет один и тот же, а ID кампании у каждого свой.
Если вы работаете и по FBY («Яндекс хранит и отгружает»), отдельно его подключать не нужно: в поле «ID кампании» укажите магазин FBS, а кампанию FBY мы найдём под тем же токеном сами.

Шаг 4. Вставьте в UnitPlace и выберите формат этикетки

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

Мы сразу проверим токен: если у него нет доступа к каталогу, скажем об этом прямо в форме. Право на изменение (сборка, остатки, цены) проверить заранее нельзя — поэтому так важен шаг 2.

Если что-то пошло не так

«Ключ недействителен или отозван» — скорее всего, токен скопирован не целиком.

«У токена нет доступа к товарам бизнеса» или товары и финансы не загрузились — у токена не хватает доступа к каталогу. Пересоздайте токен с «Полным управлением кабинетом».

Заказы видны, но «Собрать» не работает — токен выдан в режиме «только просмотр». Нужен токен с правом изменения.