Интеграции

API‑токен Яндекс Маркета: где взять, чем Business ID отличается от Campaign ID и как подключить магазин к системе учёта

У Яндекс Маркета один актуальный способ доступа для внешних систем — API‑Key токен, который выдаётся на весь кабинет. Идентификаторы магазина вводить не обязательно: по токену система сама находит магазины, их модель размещения и оба ID. Разбираем на примере NeoIT Hub: где создать токен, какие права ему нужны, что такое Business ID и Campaign ID, какие модели Маркета поддерживаются и когда идентификаторы всё‑таки приходится указывать вручную.

Источники сверены Автор: Редакция NeoIT8 официальных источниковНе покрывает: Магазины моделей FBY, DBS и FBS Express в этой статье не описываются: интеграция протестирована для модели FBS, остальные будут добавляться по мере тестирования. OAuth‑авторизация не разбирается — Маркет считает её устаревшей.

Один токен на весь кабинет

У Яндекс Маркета внешняя система получает доступ по API‑Key токену. Это единственный актуальный способ: OAuth Маркет считает устаревшим, а отдельной кнопки «Подключить через Яндекс» в партнёрском API нет. Токен выдаётся не магазину, а всему кабинету — поэтому в NeoIT Hub вручную вводится только он. Идентификаторы магазина и кабинета система получает сама: по токену она запрашивает список магазинов, их модель размещения и оба ID.

Порядок короткий: вставить токен → «Найти магазины» → выбрать магазин → «Подключить». Если подходящий магазин один, он выбирается автоматически. После этого магазин Маркета работает как канал: остаток уходит из общего единого остатка, цену считает репрайсер, заказы FBS приходят в общее окно рядом с Wildberries и Ozon.

Схема: ключ-токен слева, от него стрелки к четырём карточкам-витринам, одна подсвечена; от неё стрелка к складу-хабу, от хаба стрелки к коробкам, ценнику и коробке-заказу
Токен Яндекс Маркета выдаётся на весь кабинет: NeoIT находит все магазины и работает с выбранным

Где создать API‑токен Яндекс Маркета

Токен создаётся в кабинете продавца partner.market.yandex.ru, раздел Настройки → API и модули. Там же виден статус доступа к API. Порядок создания описан в документации Маркета — «Создание и использование API‑Key‑токена». Токен показывается один раз: скопируйте его сразу.

Какие права нужны

Токен должен давать доступ к каталогу товаров кабинета, ценам, остаткам и заказам магазина. Права выбираются при создании токена в разделе «API и модули». Если прав не хватает, магазины не найдутся или найдётся не тот список — тогда проще пересоздать токен с нужными доступами, чем вводить идентификаторы руками.

Business ID и Campaign ID: в чём разница

ИдентификаторЧто этоЗа что отвечаетВ API
Business IDкабинет (бизнес‑аккаунт)общий каталог товаров, единый для всех магазинов кабинетаbusinessId
Campaign IDконкретный магазин внутри кабинетазаказы, цены и остатки именно этого магазинаcampaignId

В одном кабинете магазинов может быть несколько, и они могут работать по разным моделям. Поэтому Campaign ID сам по себе не означает FBS: модель у каждого магазина своя, и система определяет её сама по данным Маркета. Именно ради этого NeoIT Hub находит магазины по токену, а не просит вписать номер.

Какие модели Маркета поддерживаются

Сейчас интеграция протестирована для модели FBS Яндекс Маркета. FBY, DBS и Express пока не гарантируются. Такие магазины не скрываются: они видны в списке с указанием модели и причиной, по которой их нельзя выбрать. Поддержка будет добавляться по мере тестирования.

Отдельный случай — FBS Express

У Маркета он помечен той же моделью размещения, что и обычный FBS, а отличается складом. NeoIT Hub различает их и не считает Express обычной FBS‑моделью: в списке такой магазин подписан «Это Express‑склад: отдельная модель, пока не проверена».

Подключение магазина в NeoIT Hub: по шагам

Страница «Яндекс Маркет» в «Интеграциях» NeoIT Hub: поле «API-Key токен», кнопка «Найти магазины», список магазинов кабинета с моделями FBY, DBS, FBS и FBS Express — выбран магазин FBS, остальные помечены «пока проверен только для модели FBS»
Подключение Яндекс Маркета: по одному токену NeoIT находит все магазины кабинета и показывает модель каждого (данные демонстрационные)

Откройте карточку Яндекс Маркета

Раздел «Интеграции» → карточка Яндекс Маркет → «Подключить» (у подключённого магазина — «Настроить»). Справа — памятка «Как подключить», подробный FAQ — в меню «Поддержка» в шапке, пункт «Вопросы и ответы» по этой странице.

Вставьте API‑Key токен и нажмите «Найти магазины»

Единственное обязательное поле — «API‑Key токен». По кнопке «Найти магазины» система запрашивает у Маркета все магазины кабинета и показывает их списком: название, модель размещения (FBY, DBS, FBS, FBS Express), а у подходящих — название кабинета и Campaign ID.

Выберите магазин

Магазин модели FBS доступен для выбора; остальные подписаны «NeoIT пока проверен только для модели FBS». Если подходящий магазин один, он уже выбран — под списком появится подпись «Подходящий магазин один — он выбран».

Если доступ к API у магазина отключён

Например, из‑за неактивности или отсутствия действующего договора. Магазин будет виден в списке, но выбрать его не получится — это состояние кабинета на стороне Маркета, а не ошибка ввода.

Проверьте связку

Блок «Проверка соединения» обращается к Маркету и подтверждает всё сразу: токен работает, выбранный магазин ему доступен, принадлежит тому же кабинету и его модель поддерживается. Результат показывается словами — например «Подключено · FBS · название магазина». Проверка ничего не сохраняет.

Нажмите «Подключить»

Кнопка выполняет ту же проверку ещё раз и, если она прошла, сохраняет настройки и включает регулярный обмен. Магазин, который Маркет не подтвердил, сохранить нельзя. Токен после сохранения показывается замаскированным.

Когда идентификаторы приходится указывать вручную

Продолжение страницы «Яндекс Маркет»: список магазинов с подписью «Подходящий магазин один — он выбран», раскрытый блок «Указать идентификаторы вручную» с полями Campaign ID и Business ID, блок «Проверка соединения» с кнопкой «Проверить»
Резервный способ — Campaign ID и Business ID вручную; проверка соединения ничего не сохраняет (данные демонстрационные)

Резервный способ на случай, если магазина нет в списке — например, у токена урезаны доступы. Поля спрятаны в блоке «Указать идентификаторы вручную» на странице подключения. Campaign ID виден в адресной строке кабинета при работе с конкретным магазином, Business ID — в разделе бизнеса; заполнять Business ID необязательно — система подставит кабинет выбранного магазина сама.

Проверка остаётся полной

Ручной ввод не обходит проверку: вписать магазин чужого кабинета или неподдерживаемой модели не получится. Поэтому, если магазин не находится, пересоздать токен с нужными правами обычно быстрее, чем искать идентификаторы.

Публикация остатков: включить, выключить, «Только чтение»

Раздел «Интеграции» NeoIT Hub: сводка «Источник каталога» и «Публикация остатков»; карточки Wildberries, Ozon и Яндекс Маркета со статусом «Подключено», переключателем публикации остатков и кнопками «Настроить», «Сделать основным», «Отключить»
Раздел «Интеграции»: у каждого маркетплейса своя карточка со статусом, переключателем публикации остатков и кнопкой «Сделать основным» (данные демонстрационные)

Право системы записывать остатки в магазин — отдельный переключатель на карточке Яндекс Маркета в разделе «Интеграции». «Публикация остатков включена» — система перезаписывает остатки магазина своими значениями ближайшим циклом; «Только чтение» — данные из Маркета загружаются, обратно ничего не отправляется. Над карточками строка сводки показывает, в какие каналы публикация разрешена сейчас.

Срок токена, замена и отключение

Срок действия API‑Key токена Маркет не ограничивает — на карточке подключения вместо счётчика дней показан знак «∞». Это отличает Маркет от Wildberries (180 дней) и Ozon (90 дней у новых ключей): напоминать о продлении здесь нечего, но отозвать токен в кабинете Маркета можно в любой момент.

  • Заменить токен. Вставьте новый в поле «API‑Key токен» и сохраните; если оставить поле как есть, сохранённый токен не изменится. Проверка и поиск магазинов с замаскированным значением используют сохранённый токен.
  • Отозвать доступ. Удалите токен в кабинете Маркета и отключите интеграцию кнопкой «Отключить» на карточке.
  • Отключить интеграцию. Обмен с Яндекс Маркетом прекратится: заказы, товары и остатки загружаться не будут, публикация остановится. Загруженные ранее данные останутся в системе.

Состояния карточки в «Интеграциях»

СостояниеЧто означаетЧто делать
Не подключенотокен не сохранён или магазин не выбран«Подключить»
Подключенотокен и магазин сохранены, регулярный обмен идётследить за переключателем публикации
Основнойэтот магазин — источник каталога и остатков для всей компаниименять через «Сделать основным» у другого источника или «Переключить источник» у виртуального склада
Ошибкаканал отвечает с ошибками — отозван токен, у магазина отключён доступ к API, площадка недоступнапрочитать текст ошибки в блоке диагностики, устранить причину, нажать «Сбросить ошибки»

Чего подключение не делает

  • Не создаёт карточки на Маркете. Карточки заводятся в кабинете; система сопоставляет их со своими товарами и работает с остатками, ценами и заказами.
  • Не обслуживает магазины FBY, DBS и FBS Express. Они видны в списке с пометкой; поддержка добавляется по мере тестирования.
  • Не сохраняет неподтверждённый магазин. «Подключить» проходит только после успешной проверки на стороне Маркета.
  • Не использует OAuth. Только API‑Key токен, созданный продавцом в кабинете.

Частые вопросы

Нужно ли вводить Campaign ID и Business ID?

Нет. Вставьте токен и нажмите «Найти магазины» — система получит оба идентификатора сама. Ручные поля нужны только если магазина нет в списке, например из‑за урезанных прав токена.

Где посмотреть Campaign ID, если всё‑таки нужен?

В адресной строке кабинета Маркета при работе с конкретным магазином. Business ID — в разделе бизнеса, но его можно не заполнять: система подставит кабинет выбранного магазина.

«Найти магазины» показывает список, но мой магазин нельзя выбрать. Почему?

Либо у магазина не FBS‑модель (FBY, DBS или Express — они подписаны в списке), либо у него отключён доступ к API на стороне Маркета — например, нет действующего договора. Это состояние кабинета, а не ошибка ввода.

В кабинете несколько FBS‑магазинов. Как подключить все?

Одно подключение — один магазин (Campaign ID). Если подходящих несколько, система напишет «Найдено подходящих магазинов: N. Выберите один» — автоматического выбора в этом случае нет, отметьте нужный магазин в списке.

Публикация включена, а остатки на Маркете не меняются. Что проверить?

По порядку: у токена есть право на остатки; товар сопоставлен с карточкой Маркета; публикация не остановлена общим стоп‑краном компании в модуле «Склады». Подробно ограничения разобраны в материале о единых остатках.

Чем проверка отличается от кнопки «Подключить»?

Проверка обращается к Маркету и показывает результат словами, ничего не сохраняя. «Подключить» повторяет ту же проверку и, если она прошла, сохраняет настройки и включает регулярный обмен.

Источники

  1. NeoIT Hub — справка «Яндекс Маркет»: API-Key токен, Business ID и Campaign ID, модели FBS/FBY/DBS/Express, права токена, проверка и сохранение, ручные идентификаторы, замена токена, отключение neoit.ru
  2. NeoIT Hub — страница подключения Яндекс Маркета (integration-ym.html) и раздел «Интеграции»: названия полей, кнопок и состояний проверены на production 12.09.2026 neoit.ru
  3. Яндекс Маркет — документация API для партнёров: «Создание и использование API-Key-токена» yandex.ru
  4. Яндекс Маркет — кабинет продавца (Настройки → API и модули) partner.market.yandex.ru
  5. NeoIT Hub — База знаний: «Единые остатки для Wildberries, Ozon и Яндекс Маркета» neoit.ru
  6. NeoIT Hub — База знаний: «Репрайсер для Wildberries, Ozon и Яндекс Маркета» neoit.ru
  7. NeoIT Hub — База знаний: «Client ID и API Key Ozon: где взять, какие права нужны и как подключить кабинет» neoit.ru
  8. NeoIT Hub — База знаний: «API‑токен Wildberries: где взять, какие категории доступа нужны и как подключить кабинет» neoit.ru

Материал подготовлен NeoIT Hub. Источники сверены 12.09.2026. Это не юридическая консультация.