Отчет по товарам
Возвращает подробный отчет по товарам, которые вы разместили на Маркете. С помощью отчета вы можете узнать, например, об остатках на складе, об условиях хранения ваших товаров и т. д.
Количество товаров, по которым можно получить отчет с помощью запроса, ограничено. В одном запросе может быть не более 500 товаров.
⚙️ Лимит: 5000 товаров в минуту, не более 500 товаров в одном запросе |
---|
Request
POST
https://api.partner.market.yandex.ru/campaigns/{campaignId}/stats/skus
Path parameters
Name |
Type |
Description |
campaignId* |
integer<int64> |
Идентификатор кампании в API и магазина в кабинете. Каждая кампания в API соответствует магазину в кабинете. Чтобы узнать идентификаторы своих магазинов, воспользуйтесь запросом GET campaigns. |
Body
{
"shopSkus": [
"string"
]
}
Name |
Type |
Description |
shopSkus* |
string[] |
Список ваших идентификаторов SKU.
Максимальное количество идентификаторов: 500.
Обязательный параметр. Должен содержать хотя бы один SKU.
Разрешена любая последовательность длиной до 80 знаков. В нее могут входить английские и русские буквы, цифры и символы Правила использования SKU:
Что такое SKU и как его назначать
|
Responses
200 OK
Отчет по товарам.
Body
{
"status": "OK",
"result": {
"shopSkus": [
{
"shopSku": "string",
"marketSku": 0,
"name": "string",
"price": 0,
"categoryId": 0,
"categoryName": "string",
"weightDimensions": {
"length": 0,
"width": 0,
"height": 0,
"weight": 0
},
"warehouses": [
{
"id": 0,
"name": "string",
"stocks": [
{
"type": "FIT",
"count": 0
}
]
}
],
"tariffs": [
{
"type": "AGENCY_COMMISSION",
"percent": 0,
"amount": 0,
"parameters": [
{
"name": "string",
"value": "string"
}
]
}
],
"pictures": [
"string"
]
}
]
}
}
Name |
Type |
Description |
status |
Тип ответа.
|
|
result |
Отчет по товарам. |
GoodsStatsDTO
Отчет по товарам.
Name |
Type |
Description |
shopSkus |
Список товаров. |
GoodsStatsGoodsDTO
Информация о товаре.
Name |
Type |
Description |
shopSku |
string |
Ваш SKU — идентификатор товара в вашей системе. Разрешена любая последовательность длиной до 80 знаков. В нее могут входить английские и русские буквы, цифры и символы Правила использования SKU:
Что такое SKU и как его назначать
|
marketSku |
integer<int64> |
SKU на Маркете — идентификатор карточки товара на Маркете. |
name |
string |
Название товара. |
price |
number |
Цена на товар, выставленная партнером. |
categoryId |
integer<int64> |
Идентификатор категории товара на Маркете. |
categoryName |
string |
Название категории товара на Маркете. |
weightDimensions |
Информация о весе и габаритах товара.
Если товар уже привязан к карточке ( |
|
warehouses |
Информация о складах, на которых хранится товар. Параметр не приходит, если товара нет ни на одном складе.
|
|
tariffs |
Информация о тарифах, по которым нужно заплатить за услуги Маркета. По некоторым услугам могут возвращаться несколько разных стоимостей. Например, в модели FBS стоимость услуги |
|
pictures |
string[] |
Ссылки (URL) изображений товара в хорошем качестве. |
GoodsStatsWeightDimensionsDTO
Информация о весе и габаритах товара.
Если товар уже привязан к карточке (marketSku
), в ответе вернутся габариты из карточки Маркета, а не размеры, которые вы передаете.
Name |
Type |
Description |
length |
number |
Длина товара в сантиметрах. |
width |
number |
Ширина товара в сантиметрах. |
height |
number |
Высота товара в сантиметрах. |
weight |
number |
Вес товара в килограммах. |
GoodsStatsWarehouseDTO
Информация о складе.
Name |
Type |
Description |
id |
integer<int64> |
Идентификатор склада. |
name |
string |
Название склада. |
stocks |
Информация об остатках товаров на складе. |
TariffDTO
Информация о тарифах, по которым нужно заплатить за услуги Маркета.
Name |
Type |
Description |
type* |
Услуга Маркета, за которую начисляется тариф.
|
|
percent |
number |
Это поле устарело Не используйте его — это может привести к ошибкам. Значение тарифа в процентах. |
amount* |
number |
Значение тарифа в рублях. |
parameters |
Параметры расчета тарифа. |
WarehouseStockDTO
Информация об остатках товара.
Name |
Type |
Description |
type* |
Тип остатков.
|
|
count* |
integer<int64> |
Значение остатков. |
TariffType
Услуга Маркета, за которую начисляется тариф:
-
AGENCY_COMMISSION
— прием платежа покупателя. -
PAYMENT_TRANSFER
— перевод платежа покупателя. -
STORAGE
— хранение товара на складе Маркета в течение суток. -
SURPLUS
— хранение излишков на складе Маркета. -
WITHDRAW
— вывоз товара со склада Маркета. -
FEE
— размещение товара на Маркете. -
DELIVERY_TO_CUSTOMER
— доставка покупателю. -
CROSSREGIONAL_DELIVERY
— доставка в федеральный округ, город или населенный пункт. -
CROSSREGIONAL_DELIVERY_RETURN
— доставка невыкупов и возвратов. -
DISPOSAL
— утилизация. -
SORTING_CENTER_STORAGE
— хранение невыкупов и возвратов. -
EXPRESS_DELIVERY
— экспресс-доставка покупателю. -
FF_XDOC_SUPPLY_BOX
— поставка товара через транзитный склад (за короб). -
FF_XDOC_SUPPLY_PALLET
— поставка товара через транзитный склад (за палету). -
SORTING
— обработка заказа. -
MIDDLE_MILE
— средняя миля. -
RETURN_PROCESSING
— обработка невыкупов и возвратов. -
EXPRESS_CANCELLED_BY_PARTNER
— отмена заказа с экспресс-доставкой. -
DELIVERY_TO_CUSTOMER_RETURN
— возврат доставляемого товара на склад. -
CROSSBORDER_DELIVERY
— доставка из-за рубежа. -
INTAKE_SORTING_BULKY_CARGO
— сортировка заказов с крупногабаритными товарами, которые Маркет забрал со склада продавца. -
INTAKE_SORTING_SMALL_GOODS
— сортировка заказов с малогабаритными товарами, которые Маркет забрал со склада продавца. -
INTAKE_SORTING_DAILY
— организация забора заказов со склада продавца. -
FF_STORAGE_BILLING
— хранения товаров на складе.
Подробнее об услугах Маркета читайте в Справке для продавцов.
Type |
Description |
Enum: |
TariffParameterDTO
Детали расчета конкретной услуги Маркета.
Name |
Type |
Description |
name* |
string |
Название параметра. |
value* |
string |
Значение параметра. |
WarehouseStockType
Тип остатков товаров на складе:
-
AVAILABLE
(соответствует типу «Доступный к заказу» в отчете «Остатки на складе» в кабинете продавца на Маркете) — товар, доступный для продажи. -
DEFECT
(соответствует типу «Брак») — товар с браком. -
EXPIRED
(соответствует типу «Просрочен») — товар с истекшим сроком годности. -
FIT
(соответствует типу «Годный») — товар, который доступен для продажи или уже зарезервирован. -
FREEZE
— товар, который зарезервирован для заказов. -
QUARANTINE
(соответствует типу «Карантин») — товар, временно недоступный для продажи (например, товар перемещают из одного помещения склада в другое). -
UTILIZATION
— товар, который будет утилизирован.
Type |
Description |
Enum: |
400 Bad Request
Запрос содержит неправильные данные.
Body
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Type |
Description |
status |
Тип ответа.
|
|
errors |
Список ошибок. |
ApiErrorDTO
Общий формат ошибки.
Name |
Type |
Description |
code* |
string |
Код ошибки. |
message |
string |
Описание ошибки. |
401 Unauthorized
В запросе не указаны данные для авторизации.
Body
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Type |
Description |
status |
Тип ответа.
|
|
errors |
Список ошибок. |
403 Forbidden
Данные для авторизации неверны или доступ к ресурсу запрещен.
Body
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Type |
Description |
status |
Тип ответа.
|
|
errors |
Список ошибок. |
404 Not Found
Запрашиваемый ресурс не найден.
Body
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Type |
Description |
status |
Тип ответа.
|
|
errors |
Список ошибок. |
420 Method Failure
Превышено ограничение на доступ к ресурсу.
Body
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Type |
Description |
status |
Тип ответа.
|
|
errors |
Список ошибок. |
500 Internal Server Error
Внутренняя ошибка сервера.
Body
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Type |
Description |
status |
Тип ответа.
|
|
errors |
Список ошибок. |
- 50 000 товаров в сутки, если на витрине меньше 10 000 товаров.
- В 5 раз больше количества ваших товаров, но не более 2 000 000 в сутки, если товаров от 10 000 до 400 000.
- До 2 000 000 товаров в сутки, если товаров больше 400 000.