Документы и бухгалтерия (finances)
Узнать больше о документах и бухгалтерии можно в справочном центре
Просмотр баланса, финансовых отчётов и документов продавца.
Узнать больше о документах и бухгалтерии можно в справочном центре
Просмотр баланса, финансовых отчётов и документов продавца.
Для доступа к методам используйте токен для категории Финансы
Узнать больше о балансе продавца можно в справочном центре
Чтобы получить текущий баланс, воспользуйтесь методом загрузки.
Получить баланс продавца{{ /api/v1/account/balance }}
Описание метода
Метод возвращает данные виджета баланса на главной странице портала продавцов.
Лимит запросов на один профиль продавца:
| Тип | Период | Лимит | Интервал | Всплеск |
|---|---|---|---|---|
| Персональный | 1 мин | 1 запрос | 1 мин | 1 запрос |
| Сервисный | 1 мин | 1 запрос | 1 мин | 1 запрос |
| Базовый с секретом | 1 мин | 1 запрос | 1 мин | 1 запрос |
| Базовый | 24 ч | 1 запрос | 24 ч | 1 запрос |
Authorizations:
HeaderApiKey
Responses
Response samples
- 200
- 401
- 402
- 403
- 429
Content type
application/json
{- "currency": "RUB",
- "current": 10196.21,
- "for_withdraw": 6395.8
}
Для доступа к методам используйте токен для категории Финансы
Узнать больше о финансовых отчётах можно в справочном центре
Методы получения:
Список отчётов реализации{{ /api/finance/v1/sales-reports/list }}
Описание метода
Метод доступен по
Персональному токену,
Сервисному токену
Метод возвращает список отчётов релизации по формату таблицы отчётов.
Данные доступны с 29 января 2024 года.
Лимит запросов на один профиль продавца:
| Период | Лимит | Интервал | Всплеск |
|---|---|---|---|
| 1 мин | 1 запрос | 1 мин | 1 запрос |
Authorizations:
HeaderApiKey
Request Body schema: application/jsonrequired
| dateFrom required | string Начальная дата отчёта.
|
| dateTo required | string Конечная дата отчёта.
|
| limit | integer <= 1000 Default: 1000 Количество отчётов в ответе |
| offset | integer Default: 0 Сколько элементов пропустить. Например, для значения |
| period | string Default: weekly Enum: daily weekly Периодичность отчётов:
|
Responses
Request samples
- Payload
Content type
application/json
{- "dateFrom": "2026-03-17",
- "dateTo": "2026-03-20",
- "limit": 211,
- "offset": 345,
- "period": "daily"
}Response samples
- 200
- 400
- 401
- 403
- 429
Content type
application/json
[- {
- "reportId": 307401554,
- "sellerFinanceName": "ИП Кружинин В. Р.",
- "dateFrom": "2026-03-16",
- "dateTo": "2026-03-22",
- "createDate": "2026-03-23",
- "currency": "RUB",
- "reportType": 1,
- "retailAmountSum": "258",
- "forPaySum": "183.79",
- "avgSalePercent": 0,
- "deliveryServiceSum": "2558.47",
- "paidStorageSum": "626.84",
- "paidAcceptanceSum": "243.81",
- "deductionSum": "150",
- "penaltySum": "1457.61",
- "additionalPaymentSum": "9509.71",
- "cashbackAmountSum": "2",
- "cashbackDiscountSum": "19",
- "cashbackCommissionChangeSum": "0.2",
- "paymentSchedule": "-1",
- "bankPaymentSum": "5172.94"
}
]Детализации к отчётам реализации по ID отчётов{{ /api/finance/v1/sales-reports/detailed/{reportId} }}
Описание метода
Метод доступен по
Персональному токену,
Сервисному токену
Метод возвращает детализации к отчётам реализации по ID отчётов.
Данные доступны с 29 января 2024 года.
Лимит запросов на один профиль продавца:
| Период | Лимит | Интервал | Всплеск |
|---|---|---|---|
| 1 мин | 1 запрос | 1 мин | 1 запрос |
Authorizations:
HeaderApiKey
path Parameters
| reportId required | integer <int64> ID отчёта. |
Request Body schema: application/jsonrequired
| limit | integer <= 100000 Default: 100000 Количество строк в ответе |
| rrdId | integer Default: 0 ID строки ответа. Необходим для получения отчёта частями. |
| fields | Array of strings Список полей, которые вернутся в ответе. Если параметр не указан, возвращаются все поля |
Responses
Request samples
- Payload
Content type
application/json
{- "limit": 21100,
- "rrdId": 0,
- "fields": [
- "rrdId",
- "nmId",
- "currency",
- "retailAmount",
- "acquiringFee",
- "srid"
]
}Response samples
- 200
- 400
- 401
- 402
- 403
- 404
- 429
Content type
application/json
[- {
- "reportId": 1234567,
- "dateFrom": "2026-03-16",
- "dateTo": "2026-03-22",
- "createDate": "2026-03-23",
- "currency": "RUB",
- "reportType": 1,
- "rrdId": 1232610467,
- "giId": 123456,
- "dlvPrc": 1.8,
- "fixTariffDateFrom": "2026-03-18",
- "fixTariffDateTo": "2026-03-19",
- "subjectName": "Мини-печи",
- "nmId": 1234567,
- "brandName": "BlahBlah",
- "vendorCode": "MAB123",
- "title": "ДС тарелка",
- "techSize": "0",
- "sku": "1231312352310",
- "docTypeName": "Продажа",
- "quantity": 1,
- "retailPrice": "1249",
- "retailAmount": "367",
- "salePercent": 0,
- "commissionPercent": 24,
- "officeName": "Склад WB",
- "sellerOperName": "Продажа",
- "orderDt": "2026-03-14T00:00:00Z",
- "saleDt": "2026-03-21T00:00:00Z",
- "rrDate": "2025-10-20",
- "shkId": 1239159661,
- "retailPriceWithDisc": "399.68",
- "deliveryAmount": 0,
- "returnAmount": 0,
- "deliveryService": "0",
- "giBoxTypeName": "Монопаллета",
- "productDiscountForReport": 0,
- "sellerPromo": 0,
- "spp": 25.31,
- "kvwBase": 24.15,
- "kvw": 1.81,
- "supRatingUp": 0,
- "isKgvpV2": 0,
- "ppvzSalesCommission": "23.74",
- "forPay": "376.99",
- "ppvzReward": "0",
- "acquiringFee": "14.89",
- "acquiringPercent": 4.06,
- "paymentProcessing": "Комиссия за организацию платежа с НДС",
- "acquiringBank": "Вайлдберриз Банк",
- "vw": "22.25",
- "vwNds": "4.45",
- "ppvzOfficeName": "Москва Москва Очаковское шоссе 6к2",
- "ppvzOfficeId": 105383,
- "ppvzSupplierName": "ИП Жасмин",
- "ppvzSupplierInn": "010101010101",
- "declarationNumber": "",
- "bonusTypeName": "Штраф МП. Невыполненный заказ (отмена клиентом после недовоза)",
- "stickerId": "1964038895",
- "country": "Россия",
- "srvDbs": true,
- "penalty": "231.35",
- "additionalPayment": "0",
- "rebillLogisticCost": "1.349",
- "rebillLogisticOrg": "ИП Иванов Иван Иванович(123456789012)",
- "paidStorage": "12647.29",
- "deduction": "6354",
- "paidAcceptance": "865",
- "orderId": 2816993144,
- "kiz": "0102900000376311210G2CIS?ehge)S\u001d91002A\u001d92F9Qof4FDo/31Icm14kmtuVYQzLypxm3HWkC1vQ/+pVVjm1dNAth1laFMoAGn7yEMWlTjxIe7lQnJqZ7TRZhlHQ==",
- "isB2b": false,
- "trbxId": "WB-TRBX-1234567",
- "installmentCofinancingAmount": "0",
- "wibesDiscountPercent": 1,
- "cashbackAmount": "2",
- "cashbackDiscount": "19",
- "cashbackCommissionChange": "0.2",
- "paymentSchedule": "-1",
- "deliveryMethod": "FBS, (МГТ)",
- "sellerPromoId": 14350,
- "sellerPromoDiscount": 3,
- "loyaltyId": 0,
- "loyaltyDiscount": 0,
- "uuidPromocode": "",
- "salePricePromocodeDiscountPrc": 0,
- "articleSubstitution": "",
- "salePriceAffiliatedDiscountPrc": 0,
- "agencyVat": 0,
- "salePriceWholesaleDiscountPrc": 0,
- "b2bCustomerTin": "010101010101",
- "paidWithSocialCertificate": false,
- "warehouseLogisticsCoeff": 0,
- "buyerTaxRegistrationReasonCode": "7701123301",
- "utdUcdNumber": "12356856523",
- "utdUcdDate": "2026-10-12",
- "orderUid": "id375f16c4bec295d9995393af803ff7b",
- "srid": "0f1c3999172603062979867564654dac5b702849"
}
]Детализации к отчётам реализации за период{{ /api/finance/v1/sales-reports/detailed }}
Описание метода
Метод возвращает детализации к отчётам реализации за указанный период.
Данные доступны с 29 января 2024 года.
Лимит запросов на один профиль продавца:
| Тип | Период | Лимит | Интервал | Всплеск |
|---|---|---|---|---|
| Персональный | 1 мин | 1 запрос | 1 мин | 1 запрос |
| Сервисный | 1 мин | 1 запрос | 1 мин | 1 запрос |
| Базовый с секретом | 1 мин | 1 запрос | 1 мин | 1 запрос |
| Базовый | 24 ч | 2 запроса | 12 ч | 1 запрос |
Authorizations:
HeaderApiKey
Request Body schema: application/jsonrequired
| dateFrom required | string Начальная дата отчёта.
|
| dateTo required | string Конечная дата отчёта.
|
| limit | integer <= 100000 Default: 100000 Количество строк в ответе |
| rrdId | integer Default: 0 ID строки ответа. Необходим для получения отчёта частями. |
| period | string Default: weekly Enum: daily weekly Периодичность отчётов:
|
| fields | Array of strings Список полей, которые вернутся в ответе. Если параметр не указан, возвращаются все поля |
Responses
Request samples
- Payload
Content type
application/json
{- "dateFrom": "2026-03-17",
- "dateTo": "2026-03-20",
- "limit": 21100,
- "rrdId": 0,
- "period": "daily",
- "fields": [
- "rrdId",
- "nmId",
- "docTypeName",
- "retailAmount",
- "acquiringFee",
- "srid"
]
}Response samples
- 200
- 400
- 401
- 402
- 403
- 429
Content type
application/json
[- {
- "reportId": 1234567,
- "dateFrom": "2026-03-16",
- "dateTo": "2026-03-22",
- "createDate": "2026-03-23",
- "currency": "RUB",
- "reportType": 1,
- "rrdId": 1232610467,
- "giId": 123456,
- "dlvPrc": 1.8,
- "fixTariffDateFrom": "2026-03-18",
- "fixTariffDateTo": "2026-03-19",
- "subjectName": "Мини-печи",
- "nmId": 1234567,
- "brandName": "BlahBlah",
- "vendorCode": "MAB123",
- "title": "ДС тарелка",
- "techSize": "0",
- "sku": "1231312352310",
- "docTypeName": "Продажа",
- "quantity": 1,
- "retailPrice": "1249",
- "retailAmount": "367",
- "salePercent": 0,
- "commissionPercent": 24,
- "officeName": "Склад WB",
- "sellerOperName": "Продажа",
- "orderDt": "2026-03-14T00:00:00Z",
- "saleDt": "2026-03-21T00:00:00Z",
- "rrDate": "2025-10-20",
- "shkId": 1239159661,
- "retailPriceWithDisc": "399.68",
- "deliveryAmount": 0,
- "returnAmount": 0,
- "deliveryService": "0",
- "giBoxTypeName": "Монопаллета",
- "productDiscountForReport": 0,
- "sellerPromo": 0,
- "spp": 25.31,
- "kvwBase": 24.15,
- "kvw": 1.81,
- "supRatingUp": 0,
- "isKgvpV2": 0,
- "ppvzSalesCommission": "23.74",
- "forPay": "376.99",
- "ppvzReward": "0",
- "acquiringFee": "14.89",
- "acquiringPercent": 4.06,
- "paymentProcessing": "Комиссия за организацию платежа с НДС",
- "acquiringBank": "Вайлдберриз Банк",
- "vw": "22.25",
- "vwNds": "4.45",
- "ppvzOfficeName": "Москва Москва Очаковское шоссе 6к2",
- "ppvzOfficeId": 105383,
- "ppvzSupplierName": "ИП Жасмин",
- "ppvzSupplierInn": "010101010101",
- "declarationNumber": "",
- "bonusTypeName": "Штраф МП. Невыполненный заказ (отмена клиентом после недовоза)",
- "stickerId": "1964038895",
- "country": "Россия",
- "srvDbs": true,
- "penalty": "231.35",
- "additionalPayment": "0",
- "rebillLogisticCost": "1.349",
- "rebillLogisticOrg": "ИП Иванов Иван Иванович(123456789012)",
- "paidStorage": "12647.29",
- "deduction": "6354",
- "paidAcceptance": "865",
- "orderId": 2816993144,
- "kiz": "0102900000376311210G2CIS?ehge)S\u001d91002A\u001d92F9Qof4FDo/31Icm14kmtuVYQzLypxm3HWkC1vQ/+pVVjm1dNAth1laFMoAGn7yEMWlTjxIe7lQnJqZ7TRZhlHQ==",
- "isB2b": false,
- "trbxId": "WB-TRBX-1234567",
- "installmentCofinancingAmount": "0",
- "wibesDiscountPercent": 1,
- "cashbackAmount": "2",
- "cashbackDiscount": "19",
- "cashbackCommissionChange": "0.2",
- "paymentSchedule": "-1",
- "deliveryMethod": "FBS, (МГТ)",
- "sellerPromoId": 14350,
- "sellerPromoDiscount": 3,
- "loyaltyId": 0,
- "loyaltyDiscount": 0,
- "uuidPromocode": "",
- "salePricePromocodeDiscountPrc": 0,
- "articleSubstitution": "",
- "salePriceAffiliatedDiscountPrc": 0,
- "agencyVat": 0,
- "salePriceWholesaleDiscountPrc": 0,
- "b2bCustomerTin": "010101010101",
- "paidWithSocialCertificate": false,
- "warehouseLogisticsCoeff": 0,
- "buyerTaxRegistrationReasonCode": "7701123301",
- "utdUcdNumber": "12356856523",
- "utdUcdDate": "2026-10-12",
- "orderUid": "id375f16c4bec295d9995393af803ff7b",
- "srid": "0f1c3999172603062979867564654dac5b702849"
}
]
Для доступа к методам используйте токен для категории Документы
С помощью этих методов вы можете получить документы продавца различных категорий: акты, бухгалтерские отчёты, оферты, письма, списки товаров, УКД, УПД, уведомления и так далее.
Для работы с документами получите списки:
- Категорий документов
- Документов продавца, доступных для загрузки
Вы можете загрузить один или несколько документов из полученного списка.
Категории документов{{ /api/v1/documents/categories }}
Описание метода
Метод возвращает категории документов для получения списка документов продавца.
Лимит запросов на один профиль продавца:
| Тип | Период | Лимит | Интервал | Всплеск |
|---|---|---|---|---|
| Персональный | 10 сек | 1 запрос | 10 сек | 5 запросов |
| Сервисный | 10 сек | 1 запрос | 10 сек | 5 запросов |
| Базовый с секретом | 10 сек | 1 запрос | 10 сек | 5 запросов |
| Базовый | 24 ч | 1 запрос | 24 ч | 1 запрос |
Authorizations:
HeaderApiKey
query Parameters
| locale | string Default: en Example: locale=ru Язык поля
|
Responses
Response samples
- 200
- 401
- 402
- 403
- 429
Content type
application/json
{- "data": {
- "categories": [
- {
- "name": "redeem-notification",
- "title": "Уведомление о выкупе"
}
]
}
}Список документов{{ /api/v1/documents/list }}
Описание метода
Метод возвращает список документов продавца. Вы можете получить один или несколько документов из полученного списка.
Лимит запросов на один профиль продавца:
| Тип | Период | Лимит | Интервал | Всплеск |
|---|---|---|---|---|
| Персональный | 10 сек | 1 запрос | 10 сек | 5 запросов |
| Сервисный | 10 сек | 1 запрос | 10 сек | 5 запросов |
| Базовый с секретом | 10 сек | 1 запрос | 10 сек | 5 запросов |
| Базовый | 24 ч | 1 запрос | 24 ч | 1 запрос |
Authorizations:
HeaderApiKey
query Parameters
| locale | string Default: en Example: locale=ru Язык поля
|
| beginTime | string <date> Example: beginTime=2024-07-09 Начало периода. Только вместе с |
| endTime | string <date> Example: endTime=2024-07-15 Конец периода. Только вместе с |
| sort | string Default: date Enum: date category Example: sort=category Сортировка:
Только вместе с |
| order | string Default: desc Enum: desc asc Example: order=asc Сортировка:
Только вместе с |
| category | |
| serviceName | string Example: serviceName=redeem-notification-44841941 Уникальный ID документа |
| limit | integer <= 50 Default: 50 Example: limit=10 Максимальное количество строк ответа |
| offset | integer Default: 0 Example: offset=90 После какой строки выдавать данные |
Responses
Response samples
- 200
- 400
- 401
- 402
- 403
- 429
Content type
application/json
{- "data": {
- "documents": [
- {
- "serviceName": "redeem-notification-44841941",
- "name": "redeem-notification",
- "category": "Уведомление о выкупе",
- "extensions": [
- "zip"
], - "creationTime": "2023-10-03T00:18:06.879Z",
- "viewed": false
}
]
}
}Получить документ{{ /api/v1/documents/download }}
Описание метода
Метод загружает один документ из списка документов продавца.
Лимит запросов на один профиль продавца:
| Тип | Период | Лимит | Интервал | Всплеск |
|---|---|---|---|---|
| Персональный | 10 сек | 1 запрос | 10 сек | 5 запросов |
| Сервисный | 10 сек | 1 запрос | 10 сек | 5 запросов |
| Базовый с секретом | 10 сек | 1 запрос | 10 сек | 5 запросов |
| Базовый | 24 ч | 1 запрос | 24 ч | 1 запрос |
Authorizations:
HeaderApiKey
query Parameters
| serviceName required | string Example: serviceName=redeem-notification-44841941 Уникальный ID документа |
| extension required | string Example: extension=zip Формат документа |
Responses
Response samples
- 200
- 400
- 401
- 402
- 403
- 429
Content type
application/json
{- "data": {
- "fileName": "Notice of redemption 44841941.zip",
- "extension": "zip",
- "document": "UEsDBBQACAgIAAAAAAAAAAAAAAAAAAAAAABHAAAA0KPQstC10LTQvtC80LvQtdC90LjQtSDQviDQstGL0LrRg9C/0LUg4oSWNDQ4NDE5NDEg0L7RgiAyNS4wOS4yMDIzLnhsc3jsnQk0lP3f/0dEUiRkNwmVECI7o0WS7EklxprdkH2bKVkqISRkGSlkaxRlN2TPnmzJvu/Gzmz/Uz33fY/L8/Q8zrn/x/07565zcjrn9f1cn/V6f69v53zTVCWnYATtA+0DAX/Rg0AgM5ip5l2Yg5OwKeyu+Wl3O1vbcA3YV5FDVfPej2vXKptOK1V9LjycmPDG72uW4vcG9xdsOI1V2wj86sk6+4nHJeZ92NFgC/He3gmDlccFXSyumXYUGSKK4hLLsqu5aBTspu5lqlcGB/JNlQVn1Eumj6o8ZEWPRotEVGkH9/kf457totEKj2N2P4dSZWAIaC0ajy5J+VL5fen1YOhcGMxvvUw+XOKFOHL...LSL/tC77s0GzTi2iBuHorbMpcOaw0Hmsc/gpk7ty3/cdDYRmhkRUPAIC37P94CA8oiP/fIvpPK8n9l43YARWRgH/tI6E3ntD/nfOfPyj9jxxDwn+b8/8dZqBDQPjPNSAACJgBAAD21P9s/y8AAP//UEsHCFHrudyQEwAASxQAAFBLAQIUABQACAgIAAAAAACH4v2BaSgAAGNjAABHAAAAAAAAAAAAAAAAAAAAAADQo9Cy0LXQtNC+0LzQu9C10L3QuNC1INC+INCy0YvQutGD0L/QtSDihJY0NDg0MTk0MSDQvtGCIDI1LjA5LjIwMjMueGxzeFBLAQIUABQACAgIAAAAAADTmLxwRQcAAGAPAABLAAAAAAAAAAAAAAAAAN4oAADQo9Cy0LXQtNC+0LzQu9C10L3QuNC1INC+INCy0YvQutGD0L/QtSDihJY0NDg0MTk0MSDQvtGCIDI1LjA5LjIwMjMueGxzeC5zaWdQSwECFAAUAAgACAAAAAAAUeu53JATAABLFAAACAAAAAAAAAAAAAAAAACcMAAAbWNoZC56aXBQSwUGAAAAAAMAAwAkAQAAYkQAAAAA"
}
}Получить документы{{ /api/v1/documents/download/all }}
Описание метода
Метод загружает несколько документов из списка документов продавца.
Лимит запросов на один профиль продавца:
| Тип | Период | Лимит | Интервал | Всплеск |
|---|---|---|---|---|
| Персональный | 5 мин | 1 запрос | 5 мин | 5 запросов |
| Сервисный | 5 мин | 1 запрос | 5 мин | 5 запросов |
| Базовый с секретом | 5 мин | 1 запрос | 5 мин | 5 запросов |
| Базовый | 24 ч | 1 запрос | 24 ч | 1 запрос |
Authorizations:
HeaderApiKey
Request Body schema: application/json
Array of objects [ 1 .. 50 ] items |
Responses
Request samples
- Payload
Content type
application/json
{- "params": [
- {
- "extension": "zip",
- "serviceName": "redeem-notification-44841941"
}, - {
- "extension": "xlsx",
- "serviceName": "act-income-mp-392460936"
}
]
}Response samples
- 200
- 400
- 401
- 402
- 403
- 429
Content type
application/json
{- "data": {
- "fileName": "documents.zip",
- "extension": "zip",
- "document": "UEsDBBQACAgIAAAAAAAAAAAAAAAAAAAAAABHAAAA0KPQstC10LTQvtC80LvQtdC90LjQtSDQviDQstGL0LrRg9C/0LUg4oSWNDQ4NDE5NDEg0L7RgiAyNS4wOS4yMDIzLnhsc3jsnQk0lP3f/0dEUiRkNwmVECI7o0WS7EklxprdkH2bKVkqISRkGSlkaxRlN2TPnmzJvu/Gzmz/Uz33fY/L8/Q8zrn/x/07565zcjrn9f1cn/V6f69v53zTVCWnYATtA+0DAX/Rg0AgM5ip5l2Yg5OwKeyu+Wl3O1vbcA3YV5FDVfPej2vXKptOK1V9LjycmPDG72uW4vcG9xdsOI1V2wj86sk6+4nHJeZ92NFgC/He3gmDlccFXSyumXYUGSKK4hLLsqu5aBTspu5lqlcGB/JNlQVn1Eumj6o8ZEWPRotEVGkH9/kf457totEKj2N2P4dSZWAIaC0ajy5J+VL5fen1YOhcGMxvvUw+XOKFOHL...LSL/tC77s0GzTi2iBuHorbMpcOaw0Hmsc/gpk7ty3/cdDYRmhkRUPAIC37P94CA8oiP/fIvpPK8n9l43YARWRgH/tI6E3ntD/nfOfPyj9jxxDwn+b8/8dZqBDQPjPNSAACJgBAAD21P9s/y8AAP//UEsHCFHrudyQEwAASxQAAFBLAQIUABQACAgIAAAAAACH4v2BaSgAAGNjAABHAAAAAAAAAAAAAAAAAAAAAADQo9Cy0LXQtNC+0LzQu9C10L3QuNC1INC+INCy0YvQutGD0L/QtSDihJY0NDg0MTk0MSDQvtGCIDI1LjA5LjIwMjMueGxzeFBLAQIUABQACAgIAAAAAADTmLxwRQcAAGAPAABLAAAAAAAAAAAAAAAAAN4oAADQo9Cy0LXQtNC+0LzQu9C10L3QuNC1INC+INCy0YvQutGD0L/QtSDihJY0NDg0MTk0MSDQvtGCIDI1LjA5LjIwMjMueGxzeC5zaWdQSwECFAAUAAgACAAAAAAAUeu53JATAABLFAAACAAAAAAAAAAAAAAAAACcMAAAbWNoZC56aXBQSwUGAAAAAAMAAwAkAQAAYkQAAAAA"
}
}