SellerAgent

Тема

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

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

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

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

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

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

Первая загрузка — сразу при подключении ​

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

Глубина первой загрузки зависит от тарифа:

  • Бесплатный тариф — заказы и финансы за последние ~4 месяца (120 дней).
  • Платные тарифы — вся история, которую отдаёт маркетплейс (до 4 лет).

Первая загрузка на средний каталог занимает 1–5 минут; полная история на платном тарифе — дольше, иногда десятки минут. Вкладку можно закрыть — загрузка продолжится в фоне.

Регулярное обновление ​

Дальше данные обновляются сами, по фиксированному расписанию:

  • Каждые 30 минут — свежие заказы и остатки. Отчёты отстают от кабинета маркетплейса максимум на полчаса.
  • Раз в сутки ночью — полное обновление: поздние смены статусов заказов (выкупы, возвраты, отмены задним числом), финансовые транзакции и отчёты реализации.

Расписание в интерфейсе не настраивается.

Когда синхронизация запускается ещё ​

  • После замены API-ключа (кнопка «Заменить ключ» в карточке магазина) автоматически проходит проверочная синхронизация — сразу видно, что новый ключ работает.
  • При переходе на платный тариф история автоматически догружается в глубину (до 4 лет — насколько отдаёт маркетплейс). Ничего нажимать не надо: данные появятся в отчётах по мере загрузки.
  • После ошибки повтор происходит автоматически в течение 30 минут (см. ниже).

Ход синхронизации ​

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

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

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

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

Если синхронизация завершилась с ошибкой ​

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

Если ошибка связана с самим ключом (истёк, отозван, не хватает прав) — автоповтор её не вылечит: перевыпустите ключ в кабинете маркетплейса и сохраните его кнопкой «Заменить ключ» в карточке магазина. Баннер исчезнет после первой успешной синхронизации.

Что нельзя ​

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

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

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

Я только что подключил магазин — когда появятся данные? Первая загрузка запускается сразу после сохранения ключа: на средний каталог — 1–5 минут, полная история на платном тарифе — дольше. Ход виден в карточке магазина.

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

Стадия упала из-за прав, но остальные данные загрузились — так и должно быть? Да. Стадии независимы: недоступная помечается ошибкой, остальные проходят. Но есть разница. Если не хватает необязательного доступа (WB «Маркетплейс» и «Поставки», Ozon и Яндекс.Маркет — поставки), это штатный режим: сервис пропускает эти данные и больше к ним не возвращается. А если не хватает доступа к заказам или финансам, сервис считает историю недозагруженной и каждую ночь заново пытается её догрузить — упираясь в те же права. Такой магазин нужно чинить: перевыпустить ключ с недостающим доступом.

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

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

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