Wildberries API TypeScript SDK / <internal> / DetailReportItem

Interface: DetailReportItem

Defined in: types/finances.types.ts:96

Response item from getSupplierReportDetailByPeriod() (v5, deprecated).

Deprecated

Will be removed after 2026-07-15 when WB disables the v5 endpoint. Migrate to SalesReportDetailedItem (v1). Key differences:

• camelCase field names (was snake_case)
• Money amounts as string (was number) — use parseMoneyAmount() helper

See migration guide: https://salacoste.github.io/daytona-wildberries-typescript-sdk/guides/migration-finance-reports-v5-to-v1

Properties

Property	Type	Description	Defined in
<a id="realizationreport_id"></a> realizationreport_id?	number	Номер отчёта	types/finances.types.ts:98
<a id="date_from"></a> date_from?	string	Дата начала отчётного периода	types/finances.types.ts:100
<a id="date_to"></a> date_to?	string	Дата конца отчётного периода	types/finances.types.ts:102
<a id="create_dt"></a> create_dt?	string	Дата формирования отчёта	types/finances.types.ts:104
<a id="currency_name"></a> currency_name?	string	Валюта отчёта	types/finances.types.ts:106
<a id="suppliercontract_code"></a> suppliercontract_code?	object | null	Договор	types/finances.types.ts:108
<a id="rrd_id"></a> rrd_id?	number	Номер строки	types/finances.types.ts:110
<a id="gi_id"></a> gi_id?	number	Номер поставки	types/finances.types.ts:112
<a id="dlv_prc"></a> dlv_prc?	number	Фиксированный коэффициент склада по поставке	types/finances.types.ts:114
<a id="fix_tariff_date_from"></a> fix_tariff_date_from?	string	Дата начала действия фиксации	types/finances.types.ts:116
<a id="fix_tariff_date_to"></a> fix_tariff_date_to?	string	Дата конца действия фиксации	types/finances.types.ts:118
<a id="subject_name"></a> subject_name?	string	Предмет	types/finances.types.ts:120
<a id="nm_id"></a> nm_id?	number	Артикул WB	types/finances.types.ts:122
<a id="brand_name"></a> brand_name?	string	Бренд	types/finances.types.ts:124
<a id="sa_name"></a> sa_name?	string	Артикул продавца	types/finances.types.ts:126
<a id="ts_name"></a> ts_name?	string	Размер	types/finances.types.ts:128
<a id="barcode"></a> barcode?	string	Баркод	types/finances.types.ts:130
<a id="doc_type_name"></a> doc_type_name?	string	Тип документа	types/finances.types.ts:132
<a id="quantity"></a> quantity?	number	Количество	types/finances.types.ts:134
<a id="retail_price"></a> retail_price?	number	Цена розничная	types/finances.types.ts:136
<a id="retail_amount"></a> retail_amount?	number	Вайлдберриз реализовал Товар (Пр)	types/finances.types.ts:138
<a id="sale_percent"></a> sale_percent?	number	Согласованный продуктовый дисконт, %	types/finances.types.ts:140
<a id="commission_percent"></a> commission_percent?	number	Размер кВВ, %	types/finances.types.ts:142
<a id="office_name"></a> office_name?	string	Склад	types/finances.types.ts:144
<a id="supplier_oper_name"></a> supplier_oper_name?	string	Обоснование для оплаты	types/finances.types.ts:146
<a id="order_dt"></a> order_dt?	string	Дата заказа. <br>Присылается с явным указанием часового пояса	types/finances.types.ts:148
<a id="sale_dt"></a> sale_dt?	string	Дата продажи. <br>Присылается с явным указанием часового пояса	types/finances.types.ts:150
<a id="rr_dt"></a> rr_dt?	string	Дата операции	types/finances.types.ts:152
<a id="shk_id"></a> shk_id?	number	Штрихкод	types/finances.types.ts:154
<a id="retail_price_withdisc_rub"></a> retail_price_withdisc_rub?	number	Цена розничная с учётом согласованной скидки	types/finances.types.ts:156
<a id="delivery_amount"></a> delivery_amount?	number	Количество доставок	types/finances.types.ts:158
<a id="return_amount"></a> return_amount?	number	Количество возврата	types/finances.types.ts:160
<a id="delivery_rub"></a> delivery_rub?	number	Услуги по доставке товара покупателю	types/finances.types.ts:162
<a id="gi_box_type_name"></a> gi_box_type_name?	string	Тип коробов	types/finances.types.ts:164
<a id="product_discount_for_report"></a> product_discount_for_report?	number	Итоговая согласованная скидка, %	types/finances.types.ts:166
<a id="supplier_promo"></a> supplier_promo?	number	Промокод, %	types/finances.types.ts:168
<a id="ppvz_spp_prc"></a> ppvz_spp_prc?	number	Скидка постоянного Покупателя (СПП), %	types/finances.types.ts:170
<a id="ppvz_kvw_prc_base"></a> ppvz_kvw_prc_base?	number	Размер кВВ без НДС, % базовый	types/finances.types.ts:172
<a id="ppvz_kvw_prc"></a> ppvz_kvw_prc?	number	Итоговый кВВ без НДС, %	types/finances.types.ts:174
<a id="sup_rating_prc_up"></a> sup_rating_prc_up?	number	Размер снижения кВВ из-за рейтинга, %	types/finances.types.ts:176
<a id="is_kgvp_v2"></a> is_kgvp_v2?	number	Размер снижения кВВ из-за акции, %	types/finances.types.ts:178
<a id="ppvz_sales_commission"></a> ppvz_sales_commission?	number	Вознаграждение с продаж до вычета услуг поверенного, без НДС	types/finances.types.ts:180
<a id="ppvz_for_pay"></a> ppvz_for_pay?	number	К перечислению продавцу за реализованный товар	types/finances.types.ts:182
<a id="ppvz_reward"></a> ppvz_reward?	number	Возмещение за выдачу и возврат товаров на ПВЗ	types/finances.types.ts:184
<a id="acquiring_fee"></a> acquiring_fee?	number	Эквайринг/Комиссии за организацию платежей	types/finances.types.ts:186
<a id="acquiring_percent"></a> acquiring_percent?	number	Размер комиссии за эквайринг/Комиссии за организацию платежей, %	types/finances.types.ts:188
<a id="payment_processing"></a> payment_processing?	string	Тип платежа за Эквайринг/Комиссии за организацию платежей	types/finances.types.ts:190
<a id="acquiring_bank"></a> acquiring_bank?	string	Наименование банка-эквайера	types/finances.types.ts:192
<a id="ppvz_vw"></a> ppvz_vw?	number	Вознаграждение Вайлдберриз (ВВ), без НДС	types/finances.types.ts:194
<a id="ppvz_vw_nds"></a> ppvz_vw_nds?	number	НДС с вознаграждения Вайлдберриз	types/finances.types.ts:196
<a id="ppvz_office_name"></a> ppvz_office_name?	string	Наименование офиса доставки	types/finances.types.ts:198
<a id="ppvz_office_id"></a> ppvz_office_id?	number	Номер офиса доставки	types/finances.types.ts:200
<a id="ppvz_supplier_id"></a> ppvz_supplier_id?	number	Номер партнёра	types/finances.types.ts:202
<a id="ppvz_supplier_name"></a> ppvz_supplier_name?	string	Партнёр	types/finances.types.ts:204
<a id="ppvz_inn"></a> ppvz_inn?	string	ИНН партнёра	types/finances.types.ts:206
<a id="declaration_number"></a> declaration_number?	string	Номер таможенной декларации	types/finances.types.ts:208
<a id="bonus_type_name"></a> bonus_type_name?	string	Виды логистики, штрафов и корректировок ВВ.<br> Поле будет в ответе при наличии значения	types/finances.types.ts:210
<a id="sticker_id"></a> sticker_id?	string	Цифровое значение стикера, который клеится на товар в процессе сборки заказа по схеме "Маркетплейс"	types/finances.types.ts:212
<a id="site_country"></a> site_country?	string	Страна продажи	types/finances.types.ts:214
<a id="srv_dbs"></a> srv_dbs?	boolean	Признак услуги платной доставки	types/finances.types.ts:216
<a id="penalty"></a> penalty?	number	Общая сумма штрафов	types/finances.types.ts:218
<a id="additional_payment"></a> additional_payment?	number	Корректировка Вознаграждения Вайлдберриз (ВВ)	types/finances.types.ts:220
<a id="rebill_logistic_cost"></a> rebill_logistic_cost?	number	Возмещение издержек по перевозке/по складским операциям с товаром	types/finances.types.ts:222
<a id="rebill_logistic_org"></a> rebill_logistic_org?	string	Организатор перевозки.<br> Поле будет в ответе при наличии значения	types/finances.types.ts:224
<a id="storage_fee"></a> storage_fee?	number	Хранение	types/finances.types.ts:226
<a id="deduction"></a> deduction?	number	Удержания	types/finances.types.ts:228
<a id="acceptance"></a> acceptance?	number	Операции на приёмке	types/finances.types.ts:230
<a id="assembly_id"></a> assembly_id?	number	Номер сборочного задания	types/finances.types.ts:232
<a id="kiz"></a> kiz?	string	Код маркировки.<br> Поле будет в ответе при наличии значения	types/finances.types.ts:234
<a id="srid"></a> srid?	string	Уникальный ID заказа. Примечание для использующих API Marketplace: srid равен rid в ответах методов сборочных заданий.	types/finances.types.ts:236
<a id="report_type"></a> report_type?	1 | 2 | 3 | 4	Тип отчёта: - 1 — стандартный - 2 — для уведомления о выкупе - 3 — уведомление о выкупе для Грузии - 4 — уведомление о выкупе для Грузии	types/finances.types.ts:238
<a id="is_legal_entity"></a> is_legal_entity?	boolean	Признак B2B-продажи	types/finances.types.ts:240
<a id="trbx_id"></a> trbx_id?	string	Номер короба для обработки товара	types/finances.types.ts:242
<a id="installment_cofinancing_amount"></a> installment_cofinancing_amount?	number	Скидка по программе софинансирования	types/finances.types.ts:244
<a id="wibes_wb_discount_percent"></a> wibes_wb_discount_percent?	number	Скидка Wibes, %	types/finances.types.ts:246
<a id="cashback_amount"></a> cashback_amount?	number	Сумма, удержанная за начисленные баллы программы лояльности	types/finances.types.ts:248
<a id="cashback_discount"></a> cashback_discount?	number	Компенсация скидки по программе лояльности	types/finances.types.ts:250
<a id="cashback_commission_change"></a> cashback_commission_change?	number	Стоимость участия в программе лояльности	types/finances.types.ts:252
<a id="order_uid"></a> order_uid?	string	ID транзакции. Заказы в одной корзине покупателя будут иметь одинаковый order_uid	types/finances.types.ts:254
<a id="delivery_method"></a> delivery_method?	string	Способ продажи: FBS — со склада продавца, FBW — со склада WB, DBS — доставка продавцом	types/finances.types.ts:256
<a id="loyalty_id"></a> loyalty_id?	number	Идентификатор программы лояльности продавца	types/finances.types.ts:258
<a id="loyalty_discount"></a> loyalty_discount?	number	Скидка по программе лояльности продавца, %	types/finances.types.ts:260
<a id="payment_schedule"></a> payment_schedule?	number	Разовое изменение срока перечисления денежных средств	types/finances.types.ts:262
<a id="seller_promo_id"></a> seller_promo_id?	number	ID собственной акции продавца с дополнительной скидкой	types/finances.types.ts:264
<a id="seller_promo_discount"></a> seller_promo_discount?	number	Размер дополнительной скидки по собственной акции продавца, %	types/finances.types.ts:266
<a id="uuid_promocode"></a> uuid_promocode?	string	ID промокода	types/finances.types.ts:268
<a id="sale_price_promocode_discount_prc"></a> sale_price_promocode_discount_prc?	number	Скидка за промокод, %	types/finances.types.ts:270
<a id="article_substitution"></a> article_substitution?	string	ID подменного артикула / Substitute article ID. Substitute articles (подменные артикулы) are alternate product identifiers used for external promotion campaigns. Each substitute article can carry its own discount (3%–50%) on top of the seller's existing discount, allowing sellers to attribute sales to specific marketing channels. Empty string "" indicates no substitute article was used for this transaction. Added in WB API update on 2026-04-06 (news id=11270). Example "SUB-CAMPAIGN-001" See https://seller.wildberries.ru/news-v2/news-details?id=11270 Since v3.6.0	types/finances.types.ts:286
<a id="sale_price_affiliated_discount_prc"></a> sale_price_affiliated_discount_prc?	number	Скидка по подменному артикулу, % / Substitute article discount, percent. The additional discount applied via the substitute article (3–50%). Layered on top of any existing seller discount and shown to buyers as e.g. "Вам -10%". Added in WB API update on 2026-04-06 (news id=11270). Example 10 See https://seller.wildberries.ru/news-v2/news-details?id=11270 Since v3.6.0	types/finances.types.ts:299
<a id="agency_vat"></a> agency_vat?	number	Agency VAT (semantics undocumented by WB as of 2026-04-08). Field present in the WB OpenAPI spec example response for /api/v5/supplier/reportDetailByPeriod but NOT in the public WB news announcements (id=11270, id=11226). Local spec wildberries_api_doc/13-finances.yaml does not document this field either. Semantics, units, and rollout date are unknown. SDK exposes the field as number for type safety; consumers should verify with WB before relying on its value. Example 0 Since v3.6.0	types/finances.types.ts:312
<a id="sale_price_wholesale_discount_prc"></a> sale_price_wholesale_discount_prc?	number	Оптовая скидка для бизнеса, % / Wholesale business discount, percent. The new "Оптовая скидка для бизнеса" column added on 2026-04-06 in preparation for the upcoming прогрессирующая скидка для юрлиц и ИП (progressive wholesale discount for legal entities and individual entrepreneurs) tool. Currently always returns 0; will populate with non-zero values once WB launches the tool. Daily reports include this field from the 2026-04-06 report onwards; weekly reports from the 2026-04-06 to 2026-04-12 report onwards. Example 5 See https://seller.wildberries.ru/news-v2/news-details?id=11226 Since v3.6.0	types/finances.types.ts:326