Что такое отчёт Wildberries reportDetailByPeriod и где его найти

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. И при этом не учитывают логистику, хранение, штрафы, удержания и эквайринг.
Как результат — «бумажная» прибыль сильно отличается от реальной.

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

ReportDetailByPeriod — это «лента транзакций». Если не агрегировать данные по товару, складу или категории, вы не увидите прибыль/убыток по конкретным товарам и вклад отдельных категорий в общую прибыль.

Ошибка 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, схемам и отдельным товарам.

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

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

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

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

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

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

Как marketmetrics.ru автоматизирует работу с reportDetailByPeriod

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

В сервисе marketmetrics.ru этот отчёт обрабатывается автоматически:

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

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

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

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

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

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

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

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

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