Как работает синхронизация данных

Откуда берутся цифры, как часто они обновляются и почему могут отличаться от кабинета маркетплейса.

Статья объясняет, откуда mpvalue берёт цифры, как часто их обновляет, почему первый расчёт идёт дольше обычного и что делать, если данные в сервисе и в кабинете площадки не совпадают.

Откуда берутся данные

Источников всего два — и это важно понимать, чтобы не искать причину расхождений не там.

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

Сервис работает только на чтение: он забирает данные из вашего кабинета и ничего в нём не меняет. Ключи хранятся зашифрованными (AES-256).

Как часто обновляются данные

• Автоматически — ежедневно, рано утром по московскому времени, до начала рабочего дня. К моменту, когда вы открываете дашборд, стандартные периоды уже посчитаны.
• При открытии раздела — сервис берёт готовый результат из своего хранилища, поэтому переключение периодов и разделов происходит мгновенно, без новых обращений к площадке.
• Финансовые данные (комиссии, удержания, корректировки) приходят с задержкой на стороне самой площадки — обычно на день-два, а часть удержаний доезжает ещё позже. Это ограничение маркетплейса, а не сервиса.

Почему первая загрузка дольше

При первом входе (и при первом открытии раздела за новый период) сервис делает «холодный» расчёт: запрашивает всю историю по API, сводит её со справочником товаров и пересчитывает экономику по каждому SKU. Это занимает от одной до нескольких минут, на больших ассортиментах — дольше.

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

Как обновить вручную

1. Круглая кнопка ↻ в верхней панели — перезапрашивает данные текущего раздела за выбранный период.
2. В разделах склада («Остатки / OOS», «Платное хранение», «Чёрный список») есть собственная кнопка ↻ Обновить.
3. В разделе «Реклама» — кнопка 🔄 Обновить из API и рядом отметка, когда данные обновлялись в последний раз. Свежий запрос к рекламному API идёт дольше остальных: площадка готовит отчёты по кампаниям несколько десятков секунд.

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

Почему цифры расходятся с кабинетом площадки

Чаще всего дело не в ошибке, а в разной методике счёта:

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

Если не получилось

Разделы пустые, данных нет вообще. Проверьте раздел «Кабинет»: ключи могли быть отозваны или введены с опечаткой. Для Wildberries токен должен включать все нужные категории (Контент, Статистика, Аналитика, Маркетплейс, Цены и скидки, Продвижение), иначе часть разделов останется без данных.

Раздел «Реклама» пустой, остальное работает. Для Ozon рекламные данные идут через отдельный Performance API — добавьте в форме подключения Client ID и Client Secret.

Прибыль и маржа нулевые или пустые. Не загружена себестоимость. Откройте «Юнит-экономику» и загрузите файл — после загрузки расчёт обновится автоматически.

Не помогло — напишите в поддержку: Telegram @mpvalue_ru или mpvalue@yandex.ru. Укажите площадку, период и раздел, где видите расхождение.