SellerAgent

Тема

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

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

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

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

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

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

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

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

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

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

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

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

    • Просмотр товаров и карточек.
    • Просмотр информации о заказах.
    • Просмотр финансовой информации и отчетности.

  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 не найдено». Проверьте, что токен выпущен в правильном кабинете и в нём есть хотя бы один магазин.

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

Нажмите «Синхронизировать». В верхней панели появится индикатор стадий:

Яндекс.Маркет: синхронизация · каталог → остатки → заказы → статистика заказов

Первый прогон — 1–5 минут. Можно закрыть вкладку.

Когда увидите «Синхронизировано N мин назад» — можно открывать ABC.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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