SellerAgent

Тема

Синхронизация данных ​

Что SellerAgent получает из маркетплейсов, как часто это происходит автоматически, как запустить вручную и как читать индикатор прогресса.

Что синхронизируется ​

Для каждого подключённого магазина SellerAgent регулярно получает от маркетплейса:

  • Каталог товаров — название, артикул, штрихкод, бренд, категория, ссылка на картинку.
  • Остатки — Ozon FBO/FBS, WB FBW/FBS, Яндекс.Маркет FBY/FBS/DBS (Экспресс учитывается как FBS).
  • Заказы — Ozon FBO/FBS/rFBS, WB FBW/FBS и Яндекс.Маркет FBY/FBS/DBS/Экспресс, со всеми доступными статусами (выкуплен, в пути, отменён, возвращён и т.д.).
  • Финансовые транзакции / отчёты реализации — комиссии, логистика, эквайринг, штрафы.

Без свежей синхронизации ABC, Прогноз поставок и Юнит-экономика опираются на старые данные.

Автоматическая синхронизация ​

По умолчанию синхронизация запускается раз в сутки в 04:00 UTC (07:00 МСК) — для всех подключённых магазинов, по очереди. Этого достаточно, если вам нужны цифры с задержкой в один день.

Расписание ручкой не настраивается: оно фиксированное. Если нужны более свежие данные — запускайте вручную.

Ручной запуск ​

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

Кнопка «Синхронизировать» = пункт «Быстрая» в выпадающем списке. Это один и тот же режим: отдельная кнопка позволяет запустить обычную синхронизацию, не открывая меню. Дальше — что именно делает «Быстрая».

Быстрая (по умолчанию) ​

Инкрементальный синк — догоняет то, что появилось или изменилось с прошлого раза. Подходит для большинства случаев; длительность — секунды-минуты.

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

Окно по заказам и финансам:

  • Самый первый запуск этого магазина — окно ≈ 90 дней назад от текущего момента.
  • Все последующие запуски — окно «от момента последнего успешного синка», но не меньше 14 дней назад от текущего момента. Минимум 14 дней — это страховочный нахлёст: за это время маркетплейс может задним числом обновить статус уже синкнутых заказов / выкупить ранее «в пути» / провести компенсацию. Без нахлёста такие апдейты бы потерялись.

Что именно тянется в режиме «Быстрая» — отличается по МП:

  • Ozon — товары (полный список) → остатки (полный снимок) → заказы (окно) → «обновить активные» (точечно подтягивает свежий статус для уже синхронизированных заказов в активных статусах за последние 60 дней, до 1000 шт.) → транзакции (окно). Справочник категорий общий для всех Ozon-магазинов и обновляется отдельно раз в сутки около 03:30 UTC (06:30 МСК), поэтому в стадиях синхронизации магазина его нет.
  • Wildberries — карточки (полный список) → остатки (полный отчёт) → история остатков за ~90 дней (только первый синк или «Полная история», через отчёт WB) → заказы (окно) → отчёт реализации (окно; отдельный отсчёт «от последнего успешного» — если отчёт реализации синкался раньше / позже заказов, окна могут расходиться).
  • Яндекс.Маркет — справочник складов → каталог (полный) → остатки (полный) → заказы (окно) → статистика по заказам (только по тем, что подтянули в этот синк).

За период… ​

Подменю с вариантами: 180 дней, 1 год, 2 года, 3 года. Используйте, если нужно дотянуть историю глубже — например, для сравнения год к году или ретроспективы.

Длительность зависит от каталога: 1 год обычно занимает несколько минут, 3 года — до получаса.

Полная история ​

Обход всей истории, которую API маркетплейса вообще отдаёт. Перед запуском SellerAgent покажет диалог-подтверждение: «Может занять 10–30 минут. Можно закрыть вкладку — синхронизация продолжится в фоне». Используйте редко — обычно один раз сразу после подключения нового магазина, если хотите сразу иметь полную ретроспективу.

Индикатор прогресса ​

Когда синк работает, его видно сразу в двух местах.

В верхней панели интерфейса (топбар): спиннер + название МП + текущая стадия, например:

Ozon: синхронизация · товарыWildberries: синхронизация · отчёт реализации

Когда синк закончится — индикатор сменится на зелёную точку и подпись «Синхронизировано N мин назад».

В карточке магазина (раздел «Подключения»): синий блок «Синхронизация в процессе: <стадия> · начата N мин назад», ниже — примерный прогресс-бар и список крупных шагов. Завершённые шаги отмечаются галочкой, текущий шаг — спиннером, ошибка — красным значком. Если синк упал — на месте статуса появится красный баннер с описанием ошибки. Баннер не исчезает до следующего успешного синка — чтобы вы не пропустили проблему.

Стадии разные для каждого МП:

  • Ozon: товары → остатки → заказы → активные заказы → финансы → возвраты → обновление отчётов.
  • Wildberries: карточки → остатки → история остатков → заказы → финотчёт → обновление отчётов.
  • Яндекс.Маркет: склады → каталог → остатки → заказы → статистика заказов → услуги → обновление отчётов.

Стадии идут в плановом порядке, но индикатор примерный: внутри крупного шага может быть много страниц, окон истории или ожидание готовности отчёта маркетплейса. Если одна стадия упала, SellerAgent покажет ошибку на шаге и в итоговом баннере; часть независимых стадий может всё равно дойти до конца.

Что нельзя ​

  • Запустить два синка одного магазина одновременно. Если синк уже идёт — кнопка «Синхронизировать» неактивна. Дождитесь окончания или дождитесь автосинка.
  • Поменять расписание автоматической синхронизации в интерфейсе. Оно фиксированное — раз в сутки в 04:00 UTC.
  • Откатить синк. Если синк подтянул данные, которые вы не хотели видеть — нет, в одну сторону. Но это редко проблема — данные синкаются как есть из МП.

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

Я нажал «Синхронизировать», но индикатор так и не появился. Возможно, индикатор скрыт на узком экране (он показывается только на широких) или синк уже отработал за пару секунд. Откройте страницу «Подключения» и посмотрите в карточке магазина время «Последняя синхронизация» — оно должно быть «несколько секунд назад».

Синк упал с ошибкой «токен не имеет нужной категории» (WB). Перевыпустите токен WB с категориями Контент / Статистика / Аналитика / Финансы и сохраните в карточке подключения. Если торгуете по FBS, добавьте также категорию Маркетплейс — без неё SellerAgent пропустит сборочные задания и остатки со складов продавца, но продолжит синхронизацию FBW и финансов. Заказы DBS пока не синхронизируются. Подробности — в Подключение Wildberries.

Синк закончился, но в ABC цифры старые. Скорее всего, у вас открыта вкладка с кэшем — обновите страницу (F5) или поменяйте период в фильтре. Также проверьте, что в селекторе магазина выбран именно тот магазин, который синкали.

Сколько данных хранится в SellerAgent? Все исторические данные — заказы, остатки, транзакции, цены — хранятся локально без срока истечения. После «Отключить» магазин данные остаются и доступны в ABC до тех пор, пока вы не подключите магазин снова с новыми ключами.

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