В API Яндекс Маркета кабинет и магазин — разные уровни данных. Путаница между ними особенно заметна, когда компания подключает вторую модель работы: интеграция авторизуется, но запрашивает не тот набор заказов или формирует отчёт с неожиданным охватом.

Что обозначает каждый идентификатор

Для методов уровня кабинета используется businessId. На этом уровне работает, например, часть операций с каталогом. Для методов отдельного магазина нужен campaignId: официальный пример — получение конкретного заказа. При этом набор доступных операций зависит и от модели размещения. Совпадение продавца не делает методы FBY, FBS и DBS взаимозаменяемыми.

Получить доступные связки можно через GET v2/campaigns. Документация уточняет: ответ ограничен доступом переданного токена. Поэтому отсутствие магазина в результате сначала требует проверки доступа и подключения, а не ручного подбора номера по соседнему кабинету.

Собрать справочник привязок

Редакционная рекомендация — хранить таблицу с названием магазина, businessId, campaignId и моделью работы. Понятное название помогает сотруднику проверить назначение строки, но запрос должен использовать соответствующий идентификатор. Не стоит строить привязку только на названии: его могут переименовать, а два магазина могут называться похоже.

Перед первым массовым запуском выберите известный заказ и убедитесь, что интеграция находит его в ожидаемом магазине. Затем проверьте второй магазин отдельно. Это простое испытание обнаруживает ситуацию, когда настройку первого подключения скопировали, а campaignId забыли заменить.

Отчёты требуют отдельной проверки

Для ресурса reports нельзя принять единое правило «всегда передавать кабинет». В зависимости от отчёта требуется businessId либо campaignId. В официальном обзоре для отчёта об оборачиваемости приведён уровень кампании. Проверять нужно описание конкретного метода, а не соседний пример из другой выгрузки.

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