--- title: "Детализации к отчётам реализации за период" description: "Метод возвращает детализации к отчётам реализации за указанный период." lang: ru-RU source: https://valeryverkhoturov.github.io/wb-api-client-docs/reference/api/finances/post-api-finance-v1-sales-reports-detailed --- # Детализации к отчётам реализации за период ```http POST /api/finance/v1/sales-reports/detailed ``` **База:** `https://finance-api.wildberries.ru` · **Модуль:** [`finances`](https://valeryverkhoturov.github.io/wb-api-client-docs/reference/api/finances/) · **Раздел:** Финансовые отчёты · [Документация спецификации ↗](https://dev.wildberries.ru/en/docs/openapi/documents-and-accounting#tag/financialReports/operation/postV1SalesReportsDetailed) Метод возвращает детализации к [отчётам реализации](https://seller.wildberries.ru/suppliers-mutual-settlements) за указанный период. Данные доступны с 29 января 2024 года. Вы можете выгрузить данные в [Google Таблицы](https://dev.wildberries.ru/knowledge-base/articles/019d49a4-650c-7b04-9596-ba441936f9d3) [Лимит запросов](https://dev.wildberries.ru/openapi/api-information#tag/introduction/Limity-zaprosov) на один профиль продавца: | Тип | Период | Лимит | Интервал | Всплеск | | ------------------ | ------ | --------- | -------- | -------- | | Персональный | 1 мин | 1 запрос | 1 мин | 1 запрос | | Сервисный | 1 мин | 1 запрос | 1 мин | 1 запрос | | Базовый с секретом | 1 мин | 1 запрос | 1 мин | 1 запрос | | Базовый | 24 ч | 2 запроса | 12 ч | 1 запрос | ## Тело запроса `application/json` — схема `SalesReportsDetailedReq`, обязательно - `dateFrom` `string` (обязательно) — Начальная дата отчёта. Можно передать дату или дату со временем. Время можно указывать с точностью до секунд или миллисекунд. Дата передаётся в формате [RFC3339](https://datatracker.ietf.org/doc/html/rfc3339), время — в часовом поясе Москва `UTC+3`. Примеры: - `2025-06-20` - `2025-06-20T23:59:59` - `2025-06-20T00:00:00.12345` - `2025-06-20T00:00:00` - `dateTo` `string` (обязательно) — Конечная дата отчёта. Дата в формате [RFC3339](https://datatracker.ietf.org/doc/html/rfc3339). Можно передать дату или дату со временем. Время можно указывать с точностью до секунд или миллисекунд. Время передаётся в часовом поясе Москва `UTC+3`. Примеры: - `2025-06-20` - `2025-06-20T23:59:59` - `2025-06-20T00:00:00.12345` - `2025-06-20T00:00:00` - `limit` `integer` — Количество строк в ответе - `rrdId` `integer` — ID строки ответа. Необходим для получения отчёта частями. Начинайте загрузку отчёта с `"rrdid":0`. В последующих запросах передавайте значение `rrdId` из последней строки предыдущего ответа. Повторяйте запрос, пока не получите ответ `204` - `period` `string` = `daily` | `weekly` — Периодичность отчётов: - `weekly` — еженедельные - `daily` — ежедневные - `fields` `string[]` — Список полей, которые вернутся в ответе. Если параметр не указан, возвращаются все поля ## Ответы | Код | Описание | Схема | | ----- | ---------------------- | --------------------------------------- | | `200` | Успешно | `PostV1SalesReportsDetailedResponse200` | | `204` | Нет данных | — | | `400` | Неправильный запрос | `object` | | `401` | Не авторизован | `object` | | `402` | Требуется платёж | `object` | | `403` | Доступ запрещён | `object` | | `429` | Слишком много запросов | `object` | **Структура `200` — `SalesReportsDetailedRes[]`:** - `reportId` `integer` — ID отчёта - `dateFrom` `string` — Дата начала отчётного периода - `dateTo` `string` — Дата конца отчётного периода - `createDate` `string` — Дата формирования отчёта - `currency` `string` — Валюта отчёта - `reportType` `integer` = `1` | `2` — Тип отчёта: - `1` — основной - `2` — по выкупам - `rrdId` `integer` — ID строки - `giId` `integer` — ID поставки - `dlvPrc` `number` — Фиксированный коэффициент склада по поставке - `fixTariffDateFrom` `string` — Дата начала действия фиксации - `fixTariffDateTo` `string` — Дата конца действия фиксации - `subjectName` `string` — Предмет - `nmId` `integer` — Артикул WB - `brandName` `string` — Бренд - `vendorCode` `string` — Артикул продавца - `title` `string` — Название товара - `techSize` `string` — Размер - `sku` `string` — Баркод - `docTypeName` `string` — Тип документа - `quantity` `integer` — Количество - `retailPrice` `string` — Цена розничная - `retailAmount` `string` — Wildberries реализовал Товар (Пр) - `salePercent` `integer` — Согласованный продуктовый дисконт, % - `commissionPercent` `number` — Размер кВВ, % - `officeName` `string` — Склад - `sellerOperName` `string` — Обоснование для оплаты - `orderDt` `string` — Дата и время заказа - `saleDt` `string` — Дата и время продажи - `rrDate` `string` — Дата операции - `shkId` `integer` — Штрихкод - `retailPriceWithDisc` `string` — Цена розничная с учётом согласованной скидки - `deliveryAmount` `integer` — Количество доставок - `returnAmount` `integer` — Количество возврата - `deliveryService` `string` — Услуги по доставке товара покупателю - `giBoxTypeName` `string` — Тип коробов - `productDiscountForReport` `number` — Итоговая согласованная скидка, % - `sellerPromo` `number` — Промокод, % - `spp` `number` — Платформенные скидки, % - `kvwBase` `number` — Размер кВВ без НДС, % базовый - `kvw` `number` — Итоговый кВВ без НДС, % - `supRatingUp` `number` — Размер снижения кВВ из-за рейтинга, % - `isKgvpV2` `number` — Размер снижения кВВ из-за акции, % - `ppvzSalesCommission` `string` — Вознаграждение с продаж до вычета услуг поверенного, без НДС - `forPay` `string` — К перечислению продавцу за реализованный товар - `ppvzReward` `string` — Возмещение за выдачу и возврат товаров на ПВЗ - `acquiringFee` `string` — Компенсация платёжных услуг/комиссия за интеграцию платёжных сервисов - `acquiringPercent` `number` — Размер компенсации платёжных услуг/комиссии за интеграцию платёжных сервисов - `paymentProcessing` `string` — Тип платежа: компенсация платёжных услуг/комиссия за интеграцию платёжных сервисов - `acquiringBank` `string` — Наименование банка-эквайера - `vw` `string` — Вознаграждение Wildberries (ВВ), без НДС - `vwNds` `string` — НДС с вознаграждения Wildberries - `ppvzOfficeName` `string` — Наименование офиса доставки - `ppvzOfficeId` `integer` — ID офиса доставки - `ppvzSupplierName` `string` — Партнёр - `ppvzSupplierInn` `string` — ИНН партнёра - `declarationNumber` `string` — Номер таможенной декларации - `bonusTypeName` `string` — Виды доставок, штрафов и корректировок ВВ - `stickerId` `string` — Стикер МП - `country` `string` — Страна продажи - `srvDbs` `boolean` — Признак услуги платной доставки - `penalty` `string` — Общая сумма штрафов - `additionalPayment` `string` — Корректировка Вознаграждения Wildberries (ВВ) - `rebillLogisticCost` `string` — Возмещение издержек по перемещению и операционной обработке товара - `rebillLogisticOrg` `string` — Организатор перевозки - `paidStorage` `string` — Хранение - `deduction` `string` — Удержания - `paidAcceptance` `string` — Операции на приёмке - `orderId` `integer` — ID сборочного задания - `kiz` `string` — Код маркировки [Честного знака](https://честныйзнак.рф) - `isB2b` `boolean` — Признак B2B-продажи - `trbxId` `string` — ID короба для обработки товара - `installmentCofinancingAmount` `string` — Скидка по программе софинансирования - `wibesDiscountPercent` `number` — Скидка Wibes, % - `cashbackAmount` `string` — Сумма баллов, удержанных по программе лояльности - `cashbackDiscount` `string` — Компенсация скидки по программе лояльности - `cashbackCommissionChange` `string` — Стоимость участия в программе лояльности - `paymentSchedule` `string` — Разовое изменение срока перечисления денежных средств - `deliveryMethod` `string` — Способ продажи и тип товара - `sellerPromoId` `integer` — ID собственной акции продавца с дополнительной скидкой - `sellerPromoDiscount` `number` — Размер дополнительной скидки по собственной акции продавца, % - `loyaltyId` `integer` — ID скидки лояльности от продавца - `loyaltyDiscount` `number` — Размер скидки лояльности от продавца, % - `uuidPromocode` `string` — ID промокода - `salePricePromocodeDiscountPrc` `number` — Скидка за промокод, % - `articleSubstitution` `string` — ID подменного артикула - `salePriceAffiliatedDiscountPrc` `number` — Скидка по подменному артикулу, % - `agencyVat` `number` — Удержание Агентского НДС, %. Только для продавцов из Кыргызстана - `salePriceWholesaleDiscountPrc` `number` — Оптовая скидка для бизнеса, % - `b2bCustomerTin` `string` — ИНН B2B-покупателя - `paidWithSocialCertificate` `boolean` — Оплата социальным сертификатом - `warehouseLogisticsCoeff` `number` — Коэффициент доставки - `buyerTaxRegistrationReasonCode` `string` — КПП B2B-покупателя - `utdUcdNumber` `string` — Номер УПД или УКД - `utdUcdDate` `string` — Дата УПД или УКД - `orderUid` `string` — ID корзины заказа — транзакции. Заказы в одной корзине покупателя будут иметь одинаковый `orderUid` - `srid` `string` — ID заказа. В ответах методов сборочных заданий [FBS](https://dev.wildberries.ru/openapi/orders-fbs#tag/fbsAssemblyOrders), [DBW](https://dev.wildberries.ru/openapi/orders-dbw#tag/dbwAssemblyOrders), [DBS](https://dev.wildberries.ru/openapi/dbs#tag/dbsAssemblyOrders) и [Самовывоз](https://dev.wildberries.ru/openapi/in-store-pickup#tag/inStorePickupAssemblyOrders) `srid` равен `rid` **Структура `400`:** - `status` `integer` (обязательно) — HTTP статус-код - `title` `string` (обязательно) — Заголовок ошибки - `detail` `string` (обязательно) — Детали ошибки - `requestId` `string` (обязательно) — ID запроса - `origin` `string` (обязательно) — ID внутреннего сервиса WB **Структура `401`:** - `title` `string` — Заголовок ошибки - `detail` `string` — Детали ошибки - `code` `string` — Внутренний код ошибки - `requestId` `string` — Уникальный ID запроса - `origin` `string` — ID внутреннего сервиса WB - `status` `number` — HTTP статус-код - `statusText` `string` — Расшифровка HTTP статус-кода - `timestamp` `string` — Дата и время запроса **Структура `402`:** - `title` `string` — Заголовок ошибки - `detail` `string` — Детали ошибки. Ошибка возвращается только сервисам из [Каталога решений для бизнеса](https://dev.wildberries.ru/business-solutions) **Структура `403`:** - `title` `string` — Заголовок ошибки - `detail` `string` — Детали ошибки - `code` `string` — Внутренний код ошибки - `requestId` `string` — ID запроса - `origin` `string` — ID внутреннего сервиса WB - `status` `number` — HTTP статус-код - `statusText` `string` — Расшифровка HTTP статус-кода - `timestamp` `string` — Дата и время запроса **Структура `429`:** - `title` `string` — Заголовок ошибки - `detail` `string` — Детали ошибки - `code` `string` — Внутренний код ошибки - `requestId` `string` — Уникальный ID запроса - `origin` `string` — ID внутреннего сервиса WB - `status` `number` — HTTP статус-код - `statusText` `string` — Расшифровка HTTP статус-кода - `timestamp` `string` — Дата и время запроса ## Примеры вызова Аргументы показаны именами параметров — подставьте свои значения. Языки, в клиенте которых этой операции нет, не показаны. **Python** ```python from wb_api_client.finances import Configuration, ApiClient from wb_api_client.finances.api import FinancesApi cfg = Configuration(access_token="<ваш JWT WB>") api = FinancesApi(ApiClient(cfg)) result = api.post_v1_sales_reports_detailed(sales_reports_detailed_req=...) print(result) ``` **TypeScript** ```ts import { Configuration, FinancesApi, } from "@valeryverkhoturov/wb-api-client/finances"; const cfg = new Configuration({}); cfg.setAccessToken("<ваш JWT WB>"); const api = new FinancesApi(cfg); const { data } = await api.postV1SalesReportsDetailed(salesReportsDetailedReq); console.log(data); ``` **Go** ```go import ( "context" "fmt" wbfinances "github.com/ValeryVerkhoturov/wb-api-client-go/finances" ) cfg := wbfinances.NewConfiguration() cfg.SetAccessToken("<ваш JWT WB>") client := wbfinances.NewAPIClient(cfg) result, _, err := client.FinancesAPI.PostV1SalesReportsDetailed(context.Background()).SalesReportsDetailedReq(salesReportsDetailedReq).Execute() if err != nil { panic(err) } fmt.Printf("%+v\n", result) ``` **Java** ```java import io.github.valeryverkhoturov.wbapi.finances.ApiClient; import io.github.valeryverkhoturov.wbapi.finances.SecretString; import io.github.valeryverkhoturov.wbapi.finances.api.FinancesApi; ApiClient client = new ApiClient(); client.setAccessToken(new SecretString("<ваш JWT WB>")); FinancesApi api = new FinancesApi(client); System.out.println(api.postV1SalesReportsDetailed(salesReportsDetailedReq)); ``` **PHP** ```php use ValeryVerkhoturov\WbApiClient\Finances\Configuration; use ValeryVerkhoturov\WbApiClient\Finances\SecretString; use ValeryVerkhoturov\WbApiClient\Finances\Api\FinancesApi; use GuzzleHttp\Client; $config = (new Configuration()) ->setAccessTokenSecret(new SecretString('<ваш JWT WB>')); $api = new FinancesApi(new Client(), $config); print_r($api->postV1SalesReportsDetailed($sales_reports_detailed_req)); ``` **OneScript** ```bsl #Использовать "wb-api-client" Настройки = Новый Конфигурация(); Настройки.УстановитьТокен("<ваш JWT WB>"); Клиент = Новый FinancesApi(Настройки); Сообщить(Клиент.PostV1SalesReportsDetailed(Тело).Тело); ``` **C#** ```csharp using ValeryVerkhoturov.WbApiClient.Finances.Api; using ValeryVerkhoturov.WbApiClient.Finances.Client; var config = new Configuration(); config.AccessTokenSecret = new SecretString("<ваш JWT WB>"); var api = new FinancesApi(config); Console.WriteLine(api.PostV1SalesReportsDetailed(salesReportsDetailedReq)); ``` **Rust** ```rust use wb_api_client::finances::apis::{configuration::Configuration, finances_api}; #[tokio::main] async fn main() { let mut cfg = Configuration::new(); cfg.set_access_token("<ваш JWT WB>"); let result = finances_api::post_v1_sales_reports_detailed(&cfg, sales_reports_detailed_req).await; println!("{:#?}", result); } ```