reportDetailByPeriod — это детальный финансовый отчёт Wildberries за выбранный период. В нём по каждой операции по товарам отражено:

• что именно произошло (продажа, возврат, штраф, удержание и т.д.);
• к какому товару (nmId, артикулу) относится операция;
• какие суммы начислены/удержаны по этой операции.

В личном кабинете WB отчёт доступен в разделе финансовых/детальных отчётов (путь может меняться с обновлениями интерфейса, но обычно находится в блоке «Отчёты» → «Финансы / Детальные отчёты»).

Через API WB reportDetailByPeriod доступен по адресу:

https://statistics-api.wildberries.ru/api/v5/supplier/reportDetailByPeriod

Важно: отчёт ориентируется на дату rr_dt (дата расчётного документа), а не на дату продажи/заказа. Это одно из ключевых отличий от отчётов по продажам.

Главное про структуру reportDetailByPeriod

Полей в отчёте много, и на первый взгляд он выглядит пугающе. На практике для юнит‑экономики и P&L вам нужно понимать несколько групп полей.

1. Идентификация товара и операции

• nm_id — номенклатура (SKU WB). Ключ для связывания с продажами и аналитикой товаров.
• supplier_article — ваш внутренний артикул.
• rr_dt — дата расчётного документа (расчёт с WB), а не дата заказа.
• doc_type_name — тип документа (продажа, возврат, штраф и т.д.).
• supplier_oper_name — тип операции на стороне продавца.
• srid / order_id / realizationreport_id — идентификаторы отгрузки/заказа/отчёта.

2. Выручка и сумма к выплате

• ppvz_for_pay — сумма к выплате продавцу по операции.
• ppvz_vw, ppvz_vw_nds — значения выручки/стоимости с/без НДС, полезны для сверок.

Если смотреть только на ppvz_for_pay, вы видите «деньги на выходе», но не видите, какие расходы были внутри.

3. Комиссии Wildberries

• ppvz_sales_commission — комиссия WB за продажу.
• Иногда часть комиссии «распределена» по другим полям в зависимости от схем и настроек, но в базовом сценарии это ключевой показатель.

4. Логистика и хранение

• delivery_rub — основная стоимость доставки/логистики.
• rebill_logistic_cost — дополнительные доначисления по логистике.
• storage_fee — плата за хранение товаров на складах WB.

Эти поля особенно важны для товаров с большой номенклатурой, длинным хвостом и низкой оборачиваемостью.

5. Штрафы, удержания и дополнительные платежи

• penalty — штрафы.
• deduction — удержания за нарушения, перерасчёты и прочее.
• additional_payment — дополнительные начисления/удержания.
• acceptance — расходы, связанные с приёмкой.

Штрафы и удержания часто «убивают» маржу по отдельным товарам, и без их учёта картинка по прибыли будет слишком оптимистичной.

6. Эквайринг и банковские расходы

• acquiring_fee — комиссия за эквайринг при оплате покупателем.

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

Типичные ошибки при работе с reportDetailByPeriod

Даже если вы скачиваете reportDetailByPeriod регулярно, легко допустить ошибки, которые приводят к искажённой картине по прибыли.

Ошибка 1. Путать даты rr_dt и даты продаж

Продажи в одном отчёте WB (по sales) фиксируются по дате заказа/отгрузки, а reportDetailByPeriod — по дате rr_dt (расчёта). Из‑за этого:

• выручка и расходы за один и тот же календарный период могут не совпадать «день‑в‑день»;
• сопоставление «сегодняшних продаж» и «сегодняшних расходов» может быть некорректным.

Решение: для финансовой аналитики (P&L) использовать rr_dt как базовую дату, либо осознанно сдвигать периоды (например, считать P&L по месяцам отчёта WB).

Ошибка 2. Считать только комиссию и игнорировать остальные расходы

Часто продавцы смотрят только:

• ppvz_for_pay (выплату);
• ppvz_sales_commission (комиссию).

И при этом не учитывают:

• delivery_rub, rebill_logistic_cost (логистика);
• storage_fee (хранение);
• penalty, deduction, additional_payment (штрафы и удержания);
• acquiring_fee (эквайринг).

Как результат — «бумажная» прибыль сильно отличается от реальной.

Ошибка 3. Анализ только на уровне строк, без группировки

ReportDetailByPeriod — это «лента транзакций». Если ограничиться просмотром строк, а не агрегировать данные:

• по товару (nmId),
• по складу,
• по категории,

вы не увидите:

• прибыль/убыток по конкретным товарам;
• результат по складам WB;
• вклад отдельных категорий в общую прибыль.

Ошибка 4. Анализ reportDetailByPeriod отдельно от рекламы

Частая картина:

• финансовый отчёт смотрят в одном месте;
• рекламный — в другом;
• продажи — в третьем.

В итоге нет ответа на главный вопрос: «какая прибыль остаётся после всех расходов на рекламу и WB?».

Как связать рекламу WB с прибылью по товарам, мы разбираем в статье «Аналитика рекламы Wildberries: DRR, ROAS и прибыль» .

Как использовать reportDetailByPeriod для P&L по Wildberries

На основе reportDetailByPeriod и данных о продажах можно собрать полноценный P&L (отчёт о прибылях и убытках) по Wildberries.

Минимальная структура P&L по WB за месяц может выглядеть так:

• Выручка (по данным продаж);
• Себестоимость товаров (ваши данные по закупке и подготовке);
• Валовая прибыль;
• Комиссии WB (ppvz_sales_commission и связанные поля);
• Логистика и хранение (delivery_rub, rebill_logistic_cost, storage_fee);
• Штрафы и удержания (penalty, deduction, additional_payment, acceptance);
• Эквайринг (acquiring_fee);
• Расходы на рекламу WB (из рекламных отчётов);
• Чистая прибыль.

Дальше этот P&L можно разложить:

• по категориям (какие категории зарабатывают, какие — нет);
• по складам WB;
• по схемам (если используете DBS);
• по отдельным товарам.

Ручная сборка такого P&L в Excel — трудоёмкий, но возможный путь. В статье «Бесплатная аналитика Wildberries» мы описываем, как его настроить. Но при росте оборотов и ассортимента эту работу логично отдавать сервису аналитики.

reportDetailByPeriod и юнит‑экономика по товарам

Помимо общего P&L по аккаунту, reportDetailByPeriod — ключ к юнит‑экономике по товарам.

Упрощённая схема расчёта для одного SKU:

1. Берём продажи по SKU: количество доставленных единиц и выручку.
2. Добавляем вашу себестоимость единицы товара (unit_cost).
3. Из reportDetailByPeriod агрегируем по этому SKU:
   • комиссию WB;
   • логистику и хранение;
   • штрафы и удержания;
   • эквайринг.
4. Добавляем рекламные расходы по этому SKU (если товар рекламируется).
5. Считаем:
   • прибыль за период по SKU;
   • прибыль на единицу (unit‑profit);
   • маржу с учётом всех расходов WB и рекламы.

Детально о юнит‑экономике WB мы пишем в статье «Юнит‑экономика Wildberries: как считать прибыль по каждому товару» .

Как mp.kassy.center автоматизирует работу с reportDetailByPeriod

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

В сервисе mp.kassy.center этот отчёт обрабатывается автоматически:

• по API регулярно подтягивается reportDetailByPeriod за нужные периоды;
• каждая строка отчёта связывается с конкретным товаром (nmId) и другими параметрами;
• комиссии, логистика, хранение, штрафы, эквайринг агрегируются по товарам и складам;
• эти расходы увязываются с продажами и рекламой WB;
• на основе этого строятся:
  • P&L по WB за период;
  • юнит‑экономика по товарам и складам;
  • отчёты по прибыльным и убыточным товарам;
  • аналитика эффективности рекламы с учётом всех расходов.

Для вас это выглядит так:

1. Вы подключаете кабинет WB по инструкции: «Настройка доступа к API Wildberries в mp.kassy.center» .
2. Даете времени системе подтянуть историю отчетов и продаж.
3. Открываете готовые отчёты по прибыли, юнит‑экономике и P&L — без Excel и ручной сводки.

Какие именно отчёты и уровни детализации доступны на разных тарифах, описано на странице «Тарифы и отчёты mp.kassy.center» .

С чего начать работу с reportDetailByPeriod и аналитикой WB

Если вы раньше не работали с этим отчётом, рекомендуемый порядок такой:

1. Скачайте reportDetailByPeriod за 1–2 месяца и посмотрите, какие виды операций и расходов в нём есть.
2. Сводно посмотрите ключевые суммы: комиссия, логистика, хранение, штрафы, эквайринг.
3. Попробуйте вручную посчитать юнит‑экономику по 3–5 основным товарам в Excel.
4. Подключите mp.kassy.center, чтобы сервис делал это автоматически: зарегистрироваться и подключить WB по API .
5. Сравните свои ручные расчёты с отчётами сервиса за тот же период по тем же товарам.

На пробном периоде вы успеете:

• увидеть реальные цифры по расходам WB в разрезе товаров и категорий;
• выявить убыточные позиции и кампании;
• принять первые решения по чистке ассортимента и оптимизации рекламы.

Подробности о пробном периоде — в статье «Пробный период аналитики Wildberries в mp.kassy.center» .

Подключить отчёт reportDetailByPeriod к аналитике WB