Request
- Path parameters
- Body
Responses
200 OK
400 Bad Request
- Body
- ApiErrorDTO
401 Unauthorized
- Body
403 Forbidden
- Body
404 Not Found
- Body
420 Method Failure
- Body
500 Internal Server Error
- Body

Отчет по товарам

Info

Console

Возвращает подробный отчет по товарам, которые вы разместили на Маркете. С помощью отчета вы можете узнать, например, об остатках на складе, об условиях хранения ваших товаров и т. д.

Количество товаров, по которым можно получить отчет с помощью запроса, ограничено. В одном запросе может быть не более 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

application/json

{
    "shopSkus": [
        "string"
    ]
}

Name

Type

Description

shopSkus*

string[]

Список ваших идентификаторов SKU. Максимальное количество идентификаторов: 500. Обязательный параметр. Должен содержать хотя бы один SKU.
Ваш SKU — идентификатор товара в вашей системе.

Разрешена любая последовательность длиной до 80 знаков. В нее могут входить английские и русские буквы, цифры и символы . , / \ ( ) [ ] - = _

Правила использования SKU:

У каждого товара SKU должен быть свой.
SKU товара нельзя менять — можно только удалить товар и добавить заново с новым SKU.
Уже заданный SKU нельзя освободить и использовать заново для другого товара. Каждый товар должен получать новый идентификатор, до того никогда не использовавшийся в вашем каталоге.

Что такое SKU и как его назначать.

Responses

200 OK

Отчёт по товарам.

Body

application/json

{
    "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
                    }
                ],
                "pictures": [
                    "string"
                ]
            }
        ]
    }
}

Name	Type	Description
status	ApiResponseStatusType	Тип ответа. Enum: `OK`, `ERROR`
result	GoodsStatsDTO	Отчет по товарам.

ApiResponseStatusType

Тип ответа.

Type	Description
ApiResponseStatusType	Enum: `OK`, `ERROR`

GoodsStatsDTO

Отчет по товарам.

Name	Type	Description
shopSkus	GoodsStatsGoodsDTO[]	Список товаров. Информация о товаре.

GoodsStatsGoodsDTO

Информация о товаре.

Name	Type	Description
shopSku	string	Ваш SKU.
marketSku	integer<int64>	SKU на Маркете — идентификатор карточки товара на Маркете.
name	string	Название товара.
price	number	Цена на товар, выставленная партнером.
categoryId	integer<int64>	Идентификатор категории товара на Маркете.
categoryName	string	Название категории товара на Маркете.
weightDimensions	GoodsStatsWeightDimensionsDTO	Информация о весе и габаритах товара. Если товар уже привязан к карточке (`marketSku`), в ответе вернутся габариты из карточки Маркета, а не размеры, которые вы передаете.
warehouses	GoodsStatsWarehouseDTO[]	Информация о складах, на которых хранится товар. Параметр не приходит, если товара нет ни на одном складе. Информация о складе.
tariffs	TariffDTO[]	Информация о тарифах, по которым нужно заплатить за услуги Маркета. Информация о тарифах, по которым нужно заплатить за услуги Маркета.
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	WarehouseStockDTO[]	Информация об остатках товаров на складе. Информация об остатках товара.

TariffDTO

Информация о тарифах, по которым нужно заплатить за услуги Маркета.

Name	Type	Description
type	TariffType	Услуга Маркета, за которую начисляется тариф. Enum: `AGENCY_COMMISSION`, `PAYMENT_TRANSFER`, `FULFILLMENT`, `STORAGE`, `WITHDRAW`, `SURPLUS`, `FEE`, `CANCELLED_ORDER_FEE`, `DELIVERY_TO_CUSTOMER`, `CROSSREGIONAL_DELIVERY`, `DISPOSAL`, `SORTING_CENTER_STORAGE`, `EXPRESS_DELIVERY`, `TRANSIT_BOX`, `TRANSIT_PALLET`, `SORTING`
percent	number	Значение тарифа в процентах.
amount	number	Значение тарифа в рублях.

WarehouseStockDTO

Информация об остатках товара.

Name	Type	Description
type*	WarehouseStockType	Тип остатков. Enum: `FIT`, `FREEZE`, `AVAILABLE`, `QUARANTINE`, `UTILIZATION`, `DEFECT`, `EXPIRED`
count*	integer<int64>	Значение остатков.

TariffType

Услуга Маркета, за которую начисляется тариф:

AGENCY_COMMISSION — прием платежа покупателя.
PAYMENT_TRANSFER — перевод платежа покупателя.
FULFILLMENT — обработка товара на складе Маркета.
STORAGE — хранение товара на складе Маркета в течение суток.
SURPLUS — хранение излишков на складе Маркета.
WITHDRAW — вывоз товара со склада Маркета.
FEE — размещение товара на Маркете.
CANCELLED_ORDER_FEE — отмена заказа продавцом.
DELIVERY_TO_CUSTOMER — доставка покупателю.
CROSSREGIONAL_DELIVERY — доставка в федеральный округ, город или населенный пункт.
DISPOSAL — утилизация.
SORTING_CENTER_STORAGE — хранение невыкупов и возвратов.
EXPRESS_DELIVERY — экспресс-доставка покупателю.
TRANSIT_BOX — поставка товара через транзитный склад (за короб).
TRANSIT_PALLET — поставка товара через транзитный склад (за палету).
SORTING — обработка заказа.

Подробнее о тарифах читайте в Справке для продавцов.

Type	Description
TariffType	Enum: `AGENCY_COMMISSION`, `PAYMENT_TRANSFER`, `FULFILLMENT`, `STORAGE`, `WITHDRAW`, `SURPLUS`, `FEE`, `CANCELLED_ORDER_FEE`, `DELIVERY_TO_CUSTOMER`, `CROSSREGIONAL_DELIVERY`, `DISPOSAL`, `SORTING_CENTER_STORAGE`, `EXPRESS_DELIVERY`, `TRANSIT_BOX`, `TRANSIT_PALLET`, `SORTING`

WarehouseStockType

Тип остатков товаров на складе:

AVAILABLE (соответствует типу «Доступный к заказу» в отчете «Остатки на складе» в личном кабинете магазина) — товар, доступный для продажи.
DEFECT (соответствует типу «Брак») — товар с браком.
EXPIRED (соответствует типу «Просрочен») — товар с истекшим сроком годности.
FIT (соответствует типу «Годный») — товар, который доступен для продажи или уже зарезервирован.
FREEZE — товар, который зарезервирован для заказов.
QUARANTINE (соответствует типу «Карантин») — товар, временно недоступный для продажи (например, товар перемещают из одного помещения склада в другое).
UTILIZATION — товар, который будет утилизирован.

Type	Description
WarehouseStockType	Enum: `FIT`, `FREEZE`, `AVAILABLE`, `QUARANTINE`, `UTILIZATION`, `DEFECT`, `EXPIRED`

400 Bad Request

Запрос содержит неправильные данные.

Body

application/json

{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name	Type	Description
status	ApiResponseStatusType	Тип ответа. Enum: `OK`, `ERROR`
errors	ApiErrorDTO[]	Список ошибок. Общий формат ошибки.

ApiErrorDTO

Общий формат ошибки.

Name	Type	Description
code*	string	Код ошибки.
message	string	Описание ошибки.

401 Unauthorized

В запросе не указаны данные для авторизации.

Body

application/json

{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name	Type	Description
status	ApiResponseStatusType	Тип ответа. Enum: `OK`, `ERROR`
errors	ApiErrorDTO[]	Список ошибок. Общий формат ошибки.

403 Forbidden

Данные для авторизации неверны или доступ к ресурсу запрещен.

Body

application/json

{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name	Type	Description
status	ApiResponseStatusType	Тип ответа. Enum: `OK`, `ERROR`
errors	ApiErrorDTO[]	Список ошибок. Общий формат ошибки.

404 Not Found

Запрашиваемый ресурс не найден.

Body

application/json

{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name	Type	Description
status	ApiResponseStatusType	Тип ответа. Enum: `OK`, `ERROR`
errors	ApiErrorDTO[]	Список ошибок. Общий формат ошибки.

420 Method Failure

Превышено ограничение на доступ к ресурсу.

Body

application/json

{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name	Type	Description
status	ApiResponseStatusType	Тип ответа. Enum: `OK`, `ERROR`
errors	ApiErrorDTO[]	Список ошибок. Общий формат ошибки.

500 Internal Server Error

Внутренняя ошибка сервера.

Body

application/json

{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name	Type	Description
status	ApiResponseStatusType	Тип ответа. Enum: `OK`, `ERROR`
errors	ApiErrorDTO[]	Список ошибок. Общий формат ошибки.

Отчет по товарам

RequestRequest

Path parametersPath parameters

BodyBody

ResponsesResponses

200 OK200 OK

BodyBody

ApiResponseStatusTypeApiResponseStatusType

GoodsStatsDTOGoodsStatsDTO

GoodsStatsGoodsDTOGoodsStatsGoodsDTO

GoodsStatsWeightDimensionsDTOGoodsStatsWeightDimensionsDTO

GoodsStatsWarehouseDTOGoodsStatsWarehouseDTO

TariffDTOTariffDTO

WarehouseStockDTOWarehouseStockDTO

TariffTypeTariffType

WarehouseStockTypeWarehouseStockType

400 Bad Request400 Bad Request

BodyBody

ApiErrorDTOApiErrorDTO

401 Unauthorized401 Unauthorized

BodyBody

403 Forbidden403 Forbidden

BodyBody

404 Not Found404 Not Found

BodyBody

420 Method Failure420 Method Failure

BodyBody

500 Internal Server Error500 Internal Server Error

BodyBody

Была ли статья полезна?

Request

Path parameters

Body

Responses

200 OK

Body

ApiResponseStatusType

GoodsStatsDTO

GoodsStatsGoodsDTO

GoodsStatsWeightDimensionsDTO

GoodsStatsWarehouseDTO

TariffDTO

WarehouseStockDTO

TariffType

WarehouseStockType

400 Bad Request

Body

ApiErrorDTO

401 Unauthorized

Body

403 Forbidden

Body

404 Not Found

Body

420 Method Failure

Body

500 Internal Server Error

Body