SellerAgent

Тема

Подключения ​

Раздел «Подключения» в боковом меню. Здесь вы привязываете API-ключи каждого маркетплейса к своему магазину в SellerAgent. Без подключения хотя бы одного магазина все остальные разделы (ABC, Прогноз поставок, Юнит-экономика) будут пустыми. Налоговая ставка теперь задаётся не здесь, а в Финансы → Налоговые ставки — одна на всё пространство (ИП).

Как устроена страница ​

На экране — три блока сверху вниз: Ozon, Wildberries, Яндекс.Маркет. Внутри каждого блока — карточки магазинов этого маркетплейса. Каждый магазин работает по одной и той же логике, но требует свой набор данных для подключения.

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

Название магазина обязательно при создании подключения. Это короткое имя внутри конкретного маркетплейса: Основной, ИП Иванов, B2C (по умолчанию форма подставляет «Основной»). Название уникально в пределах одного маркетплейса, поэтому два Ozon-магазина не могут оба называться Основной; при этом Основной в Ozon и Основной в WB допустимы. На аналитических экранах название показывается вместе с MP, чтобы одинаковые названия в разных маркетплейсах не путались.

У каждой карточки два состояния:

  • Магазин не подключён — внутри карточки форма ввода ключей. Для Ozon и WB — отдельные поля, для Яндекс.Маркета — ввод токена и кнопка «Найти магазины», потом выбор нужного из выпадающего списка.
  • Магазин подключён — зелёная метка «Подключено» в шапке карточки, замаскированные ключи, время последней синхронизации, кнопка «Синхронизировать» и меню «Дополнительно». Поля налоговой ставки в карточке больше нет — она переехала в «Финансы → Налоговые ставки» (см. ниже). Кнопка «Отключить» останавливает новые синхронизации, скрывает магазин из фильтров отчётов, но не удаляет ключи.
  • Магазин отключён — ключи сохранены, но синхронизация не запускается и магазин не показывается в фильтрах ABC/Юнит-экономики/Прогноза/Остатков. Владелец может снова включить магазин без повторного ввода ключей или удалить карточку.

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

Подробные инструкции, как получить ключи и что куда вводить — на отдельных страницах:

Права: кто что может ​

  • Владелец — может всё: добавлять и удалять подключения, запускать любые виды синхронизации.
  • Сотрудник — видит карточки магазинов, может запустить синхронизацию, но не может ввести или поменять ключи. На месте формы ввода — иконка замка с подсказкой «Управлять подключением может только владелец».

Если у вас роль «Сотрудник» и нужно добавить новый магазин, попросите владельца вашей команды. Список ролей и кто как назначается — в Команде и приглашениях.

Налоговая ставка — переехала в «Финансы → Налоговые ставки» ​

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

Куда влияют те же режим и ставки:

  • ABC-отчёт — колонка «Налог, ₽» и расчёт чистой прибыли / маржи / ROI: налог = выручка × эффективная ставка за период по тому же помесячному режиму, что и ОПиУ.
  • Юнит-экономика — расчёт плановой маржи.

Подробнее про экран и остальные ставки (страховые, резерв на налоги) — в Финансы → Налоговые ставки.

Запуск синхронизации ​

В подключённой карточке — кнопка «Синхронизировать» и меню ▾ с вариантами глубины:

  • Быстрая — инкрементально, ≈ 90 дней назад при первом запуске. Это режим по умолчанию.
  • За период… — выбор окна 180 дней / 1 год / 2 года / 3 года.
  • Полная история — обход всей истории, которую отдаёт API маркетплейса. Может занять 10–30 минут.

Подробности про что обновляется и как читать прогресс — в Синхронизации данных.

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

Можно подключить несколько магазинов одного маркетплейса (например, две Ozon-учётки разных юрлиц). Каждый магазин — отдельная карточка со своими ключами и своим ABC-отчётом. В аналитических экранах каждый магазин считается отдельно, поэтому один и тот же товар в разных магазинах не смешивается. Налоговая ставка при этом общая на пространство (ИП) — см. Финансы → Налоговые ставки — налог не дублируется между магазинами. В Прогнозе поставок данные всех магазинов сливаются в одну сводную таблицу.

В ABC-отчёте, Прогнозе поставок и Юнит-экономике можно выбрать один магазин, несколько магазинов внутри одного МП или все активные магазины сразу.

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

Безопасно ли вводить мои API-ключи? Ключи шифруются на бэкенде и используются только для запросов к API маркетплейса от вашего имени. Они нигде не отображаются в исходном виде — после сохранения в карточке вы видите только маску (например, 123***456 для Ozon Client-Id). При желании ключ можно перевыпустить в ЛК маркетплейса и сохранить новый.

Что произойдёт после «Отключить»? Магазин получает статус «отключён», новые синхронизации больше не ставятся, а сам магазин исчезает из фильтров отчётов. API-ключи и исторические данные остаются в базе. Включение возвращает магазин в active-состояние без повторного ввода ключей.

Чем «Отключить» отличается от «Удалить магазин»?Отключить — безопасно: магазин остаётся в списке подключений, ключи и историческая аналитика сохраняются, синхронизация не идёт, в отчётах магазин не выбирается. Удалить магазин — магазин исчезает из интерфейса, но все его данные (ключи, товары, заказы, остатки, себестоимость, плановая юнит-экономика) физически остаются в системе и автоматически не удаляются — то есть удаление обратимо силами поддержки. Перед удалением приложение попросит ввести точное имя магазина вида «Ozon — Основной».

У меня ошибка после синка — где её посмотреть? В карточке магазина появится красный баннер «Последняя синхронизация завершилась с ошибкой» с описанием. Для WB ошибки расшифровываются подсказкой: например, «токен не имеет нужной категории» → перевыпустить токен с галочками Контент / Статистика / Аналитика / Финансы. Баннер исчезнет после следующей успешной синхронизации.

Можно ли подключить магазин на чужой аккаунт? Нет, ключи в SellerAgent привязаны к вашему рабочему пространству. Если хотите дать доступ к данным коллеге — пригласите его в команду через Настройки → Команда с ролью «Сотрудник», он будет видеть те же магазины.

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