Wildberries API TypeScript SDK / <internal> / SalesReportListItem

Interface: SalesReportListItem

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

Item returned by getSalesReportsList() — metadata for a single sales report. All money amounts are string (not number) to preserve precision. Use parseMoneyAmount() helper for math.

Since

v3.7.0

See

https://dev.wildberries.ru/docs/openapi/financial-reports-and-accounting#tag/Finansovye-otchyoty/operation/postV1SalesReportsList

Properties

Property	Type	Description	Defined in
reportId?	number	Номер отчёта реализации. BigInt precision note: For daily reports, this value may exceed Number.MAX_SAFE_INTEGER (2^53). If you plan to pass this ID to getSalesReportsDetailedByReportId() for daily reports, consider using a BigInt-aware JSON parser on this response — the default JSON.parse will silently truncate precision. For typical weekly reports, number is safe.	types/finances.types.ts:147
sellerFinanceName?	string	Название продавца (юрлицо/ИП)	types/finances.types.ts:149
dateFrom?	string	Дата начала отчётного периода	types/finances.types.ts:151
dateTo?	string	Дата конца отчётного периода	types/finances.types.ts:153
createDate?	string	Дата формирования отчёта	types/finances.types.ts:155
currency?	string	Валюта (e.g., "RUB")	types/finances.types.ts:157
reportType?	1 | 2 | 3	Тип отчёта: 1 — стандартный, 2 — уведомление о выкупе, 3 — уведомление о выкупе для Грузии	types/finances.types.ts:159
retailAmountSum?	string	Сумма розничных цен (string — use parseMoneyAmount)	types/finances.types.ts:161
forPaySum?	string	К перечислению продавцу (string — use parseMoneyAmount)	types/finances.types.ts:163
avgSalePercent?	number	Средний % согласованной скидки	types/finances.types.ts:165
deliveryServiceSum?	string	Сумма услуг доставки (string)	types/finances.types.ts:167
paidStorageSum?	string	Сумма платного хранения (string)	types/finances.types.ts:169
paidAcceptanceSum?	string	Сумма платной приёмки (string)	types/finances.types.ts:171
deductionSum?	string	Сумма удержаний (string)	types/finances.types.ts:173
penaltySum?	string	Сумма штрафов (string)	types/finances.types.ts:175
additionalPaymentSum?	string	Сумма корректировок ВВ (string)	types/finances.types.ts:177
cashbackAmountSum?	string	Сумма начисленного кэшбэка (string)	types/finances.types.ts:179
cashbackDiscountSum?	string	Сумма компенсаций скидки по программе лояльности (string)	types/finances.types.ts:181
cashbackCommissionChangeSum?	string	Стоимость участия в программе лояльности (string)	types/finances.types.ts:183
paymentSchedule?	string	Разовое изменение срока перечисления (string)	types/finances.types.ts:185
bankPaymentSum?	string	Сумма банковского платежа (string)	types/finances.types.ts:187