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

Как привязать кабинет Яндекс.Маркета к SellerAgent: получить Api-Key в партнёрском интерфейсе, ввести его в форму и выбрать нужный магазин из списка.

Что вам понадобится

• Доступ к Партнёрскому интерфейсу Яндекс.Маркета.
• 5 минут.
• Роль «Владелец» в SellerAgent.

Шаг 1. Получить Api-Key в Яндекс.Маркете

1. Зайдите в Партнёрский интерфейс: https://partner.market.yandex.ru/ и нажмите значок аккаунта.

2. Откройте Настройки → API и модули → Токены авторизации.

3. Нажмите «Создать новый токен».

4. Заполните название (например, SellerAgent).

5. Выберите доступы. Рекомендуемый вариант без прав на изменение данных:

   • Просмотр всех данных — единый доступ только на чтение. Его одного достаточно для всего, что делает SellerAgent.

   Если выдаёте минимальный набор доступов вместо общего, включите четыре:

   • Просмотр товаров и карточек — каталог и остатки.
   • Просмотр информации о заказах — заказы и комиссии по каждому заказу.
   • Просмотр финансовой информации и отчетности — отчёт о стоимости услуг: хранение и утилизация.
   • Управление поставками (достаточно просмотра) — нужен для раздела «Поставки»: синхронизация ваших заявок на поставку на склады Маркета.

   Взаимозаменяемых среди них нет, и распределены они не всегда очевидно: остатки идут вместе с товарами, а комиссии по заказам финансовый доступ не открывает — они приходят вместе с заказами. Поэтому нужны все четыре (или общий «Просмотр всех данных» вместо них).

6. Сохраните ключ. Получите длинную строку вида ACMA:abcXYZ….

Подробная справка: https://yandex.ru/dev/market/partner-api/doc/ru/concepts/api-key (ссылка «Где получить Api-Key» есть и в самой форме подключения).

Шаг 2. Ввести ключ и найти магазин в SellerAgent

В Яндекс.Маркете «магазин» (campaign) живёт внутри «кабинета» (business). Один Api-Key может видеть несколько магазинов в нескольких кабинетах — поэтому подключение делается в два этапа:

1. В SellerAgent откройте Подключения → блок Яндекс.Маркет.
2. Если это первый YM-магазин, заполните стартовую форму. Если YM-магазины уже есть, нажмите «Добавить магазин» в заголовке блока.
3. В поле Api-Key вставьте токен из шага 1.
4. Нажмите «Найти магазины» — SellerAgent запросит у Яндекса все кабинеты и магазины, к которым у вашего токена есть доступ.
5. В выпадающем списке «Кабинет · магазин» выберите нужный. Если магазин один — он выберется автоматически.
6. Заполните Название магазина — обязательное короткое имя для удобства (Основной, мой-магазин и т.п.; по умолчанию — «Основной»). Название уникально внутри Яндекс.Маркета; такое же название в Ozon или WB допустимо.
7. Нажмите «Подключить».

Если ничего не нашлось — на форме появится предупреждение «Кабинетов и магазинов для этого Api-Key не найдено». Проверьте, что токен выпущен в правильном кабинете и в нём есть хотя бы один магазин.

Что именно проверяется при подключении

Полезно понимать границу — она объясняет, почему ключ может сохраниться, а данные всё равно не пойти:

• На шаге «Найти магазины» SellerAgent делает один запрос в Маркет — за списком кабинетов и магазинов. Он отвечает ровно на один вопрос: ключ живой или нет. Недействующий Api-Key просто не найдёт магазинов и не сохранится.
• При сохранении SellerAgent дополнительно спрашивает у Маркета набор доступов ключа. Ключ без любого из четырёх доступов не сохранится — форма покажет, чего не хватает и что из-за этого не заработает. Обязательны все четыре: SellerAgent обращается к Маркету только на чтение, поэтому лишних прав они нам не дают. Если Маркет в этот момент недоступен или упёрся в лимит запросов, доступы выяснить не удаётся — тогда ключ сохранится, а нехватку вы увидите в строке прав и в ошибке синхронизации.
• Сразу после подключения под шапкой карточки появляется строка прав: SellerAgent спрашивает у Маркета, какие доступы выданы ключу, и показывает ✓ или ⚠ напротив Товары и остатки, Заказы и комиссии, Финансы и Поставки — все четыре обязательны, без любого из них ключ не сохранится. Кнопка «Обновить» перечитывает права после замены ключа.
• Если доступа всё-таки не хватило, синхронизация не падает целиком: недоступная стадия помечается ошибкой, остальное загружается. В карточке появится красный баннер «Нет доступа к API Яндекс.Маркета: API-ключ недействителен или не хватает прав».

Все четыре доступа обязательны, поэтому подключить магазин с неполным ключом не получится — SellerAgent скажет, чего не хватает. Если неполный ключ остался с прежних времён (уже подключённые магазины мы не перепроверяем), последствия разные по тяжести: без поставок просто не будет заявок, а без доступа к заказам или финансам не будет продаж или удержаний, и сервис будет каждую ночь заново пытаться догрузить недостающую историю — пока вы не замените ключ.

Шаг 3. Проверить, что данные потекли

Сразу после подключения SellerAgent автоматически запускает первую загрузку данных — нажимать ничего не нужно. Ход виден в карточке магазина: блок «Синхронизация в процессе» с текущей стадией и прогрессом (склады → товары → остатки → заказы → комиссии и платежи → услуги → заявки на поставку).

Глубина первой загрузки зависит от тарифа: на бесплатном — заказы и финансы за последние ~4 месяца (120 дней), на платных — вся история, которую отдаёт Маркет (до 4 лет). Первый прогон — 1–5 минут; полная история — дольше. Можно закрыть вкладку — загрузка продолжится в фоне.

Когда в карточке обновится время «Последняя синхронизация» — можно открывать ABC.

Что SellerAgent получает из Яндекс.Маркета

• Каталог — название, артикул, штрихкод, категория. Архивные товары тоже загружаются, иначе их продажи остались бы без названия.
• Остатки — на складах Маркета (FBY), а для FBS и DBS — на ваших складах отгрузки.
• Заказы FBY — все статусы.
• Статистика заказов — детальные данные по выручке и удержаниям.
• Стоимость услуг — отчёт Маркета о хранении и утилизации на складах FBY. Участвует в расчёте чистой прибыли.
• Заявки на поставку (только FBY) — питают раздел «Поставки». Нужен доступ к поставкам; без него пропускаются только они.
• Справочник складов (только для FBY) — отдельный справочник по каждому магазину, чтобы названия складов в Прогнозе поставок были человеческими.

Схемы FBS, DBS и Экспресс Яндекс.Маркета синхронизируются: заказы со склада продавца учитываются как соответствующая схема (Экспресс приравнивается к FBS). Схема определяется по типу размещения заказа, а если он не указан — по типу размещения магазина в кабинете. LAAS (логистика Маркета как услуга) пока не поддерживается — для таких магазинов данные со складов продавца не подтягиваются.

Налоговая ставка

Налог задаётся один раз на всё пространство (ИП), а не в карточке магазина. Откройте «Финансы» → «Налоговые ставки»: выберите режим налогообложения на год и проставьте ставки основного налога и НДС по месяцам (по умолчанию УСН «Доходы» 6 %, без НДС). Подробности — в Финансы → Налоговые ставки.

Несколько магазинов в одном кабинете

Если у вас в Яндекс.Маркете несколько магазинов под одним бизнес-кабинетом, на каждый магазин нужно отдельное подключение в SellerAgent. В блоке Яндекс.Маркет нажмите «Добавить магазин», вставьте Api-Key, нажмите «Найти магазины» и выберите следующий магазин. Все такие магазины могут жить в одном рабочем пространстве.

Важно: в Яндекс.Маркете схема работы задаётся на уровне магазина (FBY, FBS, DBS, LAAS). Поддерживаются FBY, FBS, DBS и Экспресс; LAAS пока требует отдельной реализации.

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

В списке «Кабинет · магазин» пусто. Проверьте Api-Key — он должен быть выпущен в том кабинете, где есть нужные магазины. Если кабинетов у вас несколько, у токена может не быть доступа ко всем — выпустите ключ непосредственно в нужном кабинете.

В строке прав жёлтая метка напротив «Финансы» (или другого пункта). Ключ выпущен без соответствующего доступа. Перевыпустите его в кабинете Маркета с нужным набором (проще всего — общий «Просмотр всех данных») и сохраните кнопкой «Заменить ключ» — магазин не отключается, история сохраняется. Затем нажмите «Обновить» в строке прав, чтобы метки перечитались.

В карточке ошибка «Нет доступа к API Яндекс.Маркета: API-ключ недействителен или не хватает прав». Либо ключ отозван, либо у него нет доступа для той стадии, которая упала. Сверьтесь со строкой прав в карточке: жёлтая метка покажет, какого доступа не хватает. Если все метки зелёные — перевыпустите ключ, скорее всего он отозван.

Что такое businessId и campaignId, которые я вижу в карточке после подключения?

• businessId — ID вашего бизнес-кабинета в Яндекс.Маркете (одно юрлицо может иметь несколько кабинетов).
• campaignId — ID конкретного магазина внутри кабинета.

Эти числа отображаются для справки — менять их можно только пересохранением подключения с другим Api-Key.

Перевыпустил Api-Key — что делать? В карточке YM нажмите «Заменить ключ» и вставьте новый Api-Key — магазин не отключается, привязка к кабинету и магазину сохраняется, заново выбирать магазин из списка не нужно, а сразу после замены автоматически пройдёт проверочная синхронизация. Новый ключ должен видеть тот же кабинет и магазин — иначе сервис его отклонит; другой магазин подключайте отдельным подключением.

Как часто обновлять Api-Key? Яндекс.Маркет не ограничивает срок жизни ключа жёстко. Перевыпускайте по своему регламенту безопасности (например, раз в год) или если ключ мог утечь.

Связанные разделы

• Подключения — общий обзор, права, налоговая ставка.
• Синхронизация данных — как и когда данные обновляются автоматически.
• Прогноз поставок — где увидите FBY-склады Яндекс.Маркета сводно с другими МП.