Если вы скачивали из кабинета Wildberries файл с длинным названием reportDetailByPeriod, то наверняка испытывали смесь любопытства и ужаса. Там десятки столбцов: комиссии, логистика, эквайринг, штрафы, хранение — и всё это без малейшего намёка на человеческое «сколько я заработал». Просто гора цифр, в которой легко утонуть.
В MarketMetrics мы взяли этот мощный, но неудобный отчёт и превратили его в фундамент всей финансовой аналитики. В этой статье разложим по полочкам: из чего состоит отчёт, какие строки важны для расчёта реальной прибыли, где прячутся скрытые расходы и как сервис делает всю расшифровку за вас.
Что такое reportDetailByPeriod и зачем он нужен
reportDetailByPeriod — это единственный официальный документ Wildberries, в котором маркетплейс детально отчитывается перед продавцом о каждом движении денег. Именно из него вы узнаёте:
- точную сумму комиссии за продажу конкретного товара;
- стоимость доставки до покупателя;
- плату за хранение на складах WB;
- все штрафы и удержания (брак, возвраты, нарушения маркировки);
- эквайринг и прочие платежи.
Без этого отчёта невозможно посчитать реальную прибыль. Оборот вы видите в оперативных сводках, но только reportDetailByPeriod показывает, сколько денег WB уже списал или спишет с вашего счёта. Именно его данные лежат в основе юнит-экономики, P&L и отчёта по прибыли в MarketMetrics.
https://statistics-api.wildberries.ru/api/v5/supplier/reportDetailByPeriod
Подробнее о том, как использовать этот отчёт для управления прибылью, читайте в статье «reportDetailByPeriod: как читать и использовать для прибыли».
Ключевые поля отчёта: что означают и на что смотреть
Отчёт содержит несколько десятков колонок. Мы выделим те, которые напрямую влияют на вашу прибыль.
1. Идентификаторы товара и операции
- nm_id — уникальный номер товара в системе WB (номенклатура).
- supplier_article — ваш внутренний артикул.
- rr_dt — дата расчётного документа (расчёт с WB), а не дата продажи.
- doc_type_name — тип документа (продажа, возврат, штраф и т.д.).
- srid / order_id — идентификаторы отгрузки/заказа.
2. Доходные строки
- ppvz_for_pay — сумма к выплате продавцу по операции (ключевой показатель).
- ppvz_vw — выручка/стоимость с НДС.
- ppvz_vw_nds — выручка/стоимость без НДС.
3. Расходные строки (самое важное для прибыли)
- ppvz_sales_commission — комиссия WB за продажу.
- delivery_rub — стоимость доставки товара до покупателя (логистика).
- rebill_logistic_cost — дополнительные доначисления по логистике.
- storage_fee — плата за хранение товаров на складах WB.
- acquiring_fee — комиссия за эквайринг (обработку платежа).
- penalty — штрафы.
- deduction — удержания за нарушения, перерасчёты.
- additional_payment — дополнительные начисления/удержания.
- acceptance — расходы на приёмку товаров.
📊 Пример расчёта прибыли из отчёта reportDetailByPeriod:
Вы продали товар за 2 500 ₽. Из отчёта видно:
- Комиссия WB (15%) = 375 ₽
- Логистика = 35 ₽
- Хранение = 6 ₽
- Эквайринг = 37,5 ₽
- Штрафы = 0 ₽
Итоговая сумма к выплате (ppvz_for_pay) = 2 500 − 375 − 35 − 6 − 37,5 = 2 046,5 ₽
Но это ещё не чистая прибыль — из неё не вычтена себестоимость товара и расходы на рекламу.
Уже на этом этапе видно: чтобы получить чистую прибыль, нужно просуммировать все расходные строки и вычесть их из выручки. Вручную — адская работа. MarketMetrics делает это автоматически, причём группирует данные по товарам и складам.
Скрытые расходы: где WB прячет комиссии, штрафы и хранение
Главная ловушка reportDetailByPeriod — отложенные начисления. WB может списать стоимость хранения за прошлый месяц не сразу, а через несколько недель. Штраф за бракованный товар может прилететь через два отчётных периода. Если вы смотрите только на оперативные данные, вы видите завышенную прибыль.
Кроме того, Wildberries применяет сложную систему тарифов: стоимость логистики зависит от склада, габаритов, региона доставки. Без сводки по товарам вы никогда не узнаете, что, например, с одного склада доставка обходится в два раза дороже, чем с другого.
MarketMetrics решает обе проблемы: сервис накапливает все строки отчёта и привязывает их к периоду фактической продажи. Так вы видите не «бухгалтерские даты», а реальную картину доходности за выбранный месяц.
Можно ли работать с отчётом вручную и сколько это стоит времени
Технически — да, можно. Вы скачиваете CSV, открываете в Excel, чистите, фильтруете, строите сводные таблицы. На один магазин с парой десятков товаров уходит 2–4 часа в неделю. Если ассортимент — сотни позиций, а складов несколько, это превращается в отдельную профессию.
При этом риск ошибки огромен: одна пропущенная строка, неправильная сумма — и вы принимаете решение на искажённых данных. MarketMetrics исключает ручной труд: вы подключаете кабинет WB, и сервис сам забирает reportDetailByPeriod, разбирает, связывает с товарами и выводит готовые цифры.
Кстати, у нас есть подробный гайд по бесплатной аналитике Wildberries в Excel — «Бесплатная аналитика Wildberries в Excel: готовый шаблон и инструкция». Но честно: при масштабе 100+ SKU лучше сразу переходить на автоматизацию.
Как MarketMetrics обрабатывает reportDetailByPeriod
Наш алгоритм делает три вещи, которые невозможно повторить в Excel без программирования:
- Автоматический сбор и очистка: сервис забирает отчёт по API, удаляет дубли, корректно обрабатывает отрицательные значения (возвраты) и сопоставляет строки с вашим каталогом товаров.
- Привязка к SKU и складам: каждая операция раскладывается на конкретный товар и склад. Так в отчёте «Прибыль по товарам» вы видите, сколько принёс каждый артикул с каждого склада.
- Построение сводок и визуализация: данные агрегируются по дням, неделям и месяцам, выводятся в дашборды, графики и таблицы. Появляются готовые отчёты: P&L, юнит-экономика, структура расходов.
📊 Пример обработки отчёта в MarketMetrics
Благодаря этому вы тратите ноль минут на «разбор» отчёта и сто процентов времени — на управленческие решения.
Похожим образом мы работаем и с отчётами Ozon — подробнее в статье «Финансовые отчёты Ozon: что нужно знать продавцу».
Как увидеть свою расшифровку уже сегодня
Вам не придётся больше скачивать многоколоночные файлы и ломать голову над формулами. Просто сделайте три шага:
- Зарегистрируйтесь в MarketMetrics — https://marketmetrics.ru/register.php
- Подключите кабинет Wildberries по инструкции «Как подключить Wildberries к MarketMetrics»
- Откройте раздел «Финансы и прибыль» — вся расшифровка reportDetailByPeriod уже там
🎯 Пробный период — 14 дней полного доступа к тарифу Pro
Вы сразу увидите свои реальные комиссии, логистику и прибыль за последние 30–60 дней. Никакой карты, никаких скрытых условий.
О том, что вы успеете сделать за пробный период, читайте в статье «Пробный период аналитики Wildberries в marketmetrics.ru».