产品报告
方法适用于所有模式.
如果您使用API-Key令牌,调用该方法时需要具备列表中可用权限之一
返回您在市场上投放的产品的详细报告。 例如,您可以使用该报告来了解库存余额、货物的存储条件等。
| ⚙️ 限制: 每分钟5,000件物品 |
|---|
Request
POST
https://api.partner.market.yandex.ru/v2/campaigns/{campaignId}/stats/skus
Path parameters
|
Name |
Description |
|
campaignId |
Type: integer 广告系列(商店)的ID — 通过API工作时,代表您在Yandex市场系统中的商店的技术标识符。 它与您的商店唯一链接,但仅用于自动交互。 您可以使用查询找到它 GET v2/campaigns 或者在市场上的卖家办公室找到它。 点击您的帐户图标→ 设置 在左边的菜单中,选择 Api和模块:
⚠️ 不要把它与:
Min value: |
Body
application/json
{
"shopSkus": [
"example"
]
}
|
Name |
Description |
|
shopSkus |
Type: string[] 您的Id列表 SKU. Min items: Max items: Unique items: Example
|
Responses
200 OK
产品报告。
Body
application/json
{
"status": "OK",
"result": {
"shopSkus": [
{
"shopSku": "example",
"marketSku": 1,
"name": "example",
"price": 0.5,
"categoryId": 0,
"categoryName": "example",
"weightDimensions": {},
"warehouses": [
null
],
"tariffs": [
null
],
"pictures": [
null
]
}
]
}
}
Type: object
All of 2 types
-
Type: object
status
Type: string
响应的类型。 可能的值:
OK— 没有错误。ERROR— 处理请求时出错。
Enum:
OK,ERROR服务器响应的标准包装器。
Example
{ "status": "OK" } -
Type: object
result
Type: object
shopSkus
Type: object[]
categoryId
Type: integer
市场上的产品类别的标识符。
categoryName
Type: string
市场上的产品类别的名称。
Example:
examplemarketSku
Type: integer
市场上的产品卡的ID。
Min value:
1name
Type: string
产品名称。
Example:
examplepictures
Type: string[] | null
连结(URL)产品图像质量好。
Min items:
1Unique items:
trueExample
[ "example" ]price
Type: number
产品以所设置货币为单位的价格 在市场上的卖方办公室.
shopSku
Type: string
你的 SKU — 系统中的产品ID。
使用规则 SKU:
-
对于每个产品 SKU 一定有一个。
-
已经设置 SKU 它不能被释放并重新用于另一个产品。 每个产品都应该收到一个以前从未在目录中使用过的新标识符。
SKU 产品可以在市场上的卖方帐户中更改。 阅读如何做到这一点。 在市场对卖家的帮助.
重要
值开头和结尾的空格会自动删除。 例如,
" SKU123 "和"SKU123"它们将被视为相同的值。Min length:
1Max length:
255Pattern:
^(?=.*\S.*)[^\x00-\x08\x0A-\x1f\x7f]{1,255}$Example:
exampletariffs
Type: object[]
amount
Type: number
关税的价值。
currency
Type: string
货币代码:
RUR— 俄罗斯卢布。UAH— 乌克兰格里夫纳。BYR— 白俄罗斯卢布。KZT— 哈萨克斯坦坚戈。UZS— 乌兹别克总和。
Enum:
RUR,USD,EUR,UAH,AUD,GBP,BYR,BYN,DKK,ISK,KZT,CAD,CNY,NOK,XDR,SGD,TRY,SEK,CHF,JPY,AZN,ALL,DZD,AOA,ARS,AMD,AFN,BHD,BGN,BOB,BWP,BND,BRL,BIF,HUF,VEF,KPW,VND,GMD,GHS,GNF,HKD,GEL,AED,EGP,ZMK,ILS,INR,IDR,JOD,IQD,IRR,YER,QAR,KES,KGS,COP,CDF,CRC,KWD,CUP,LAK,LVL,SLL,LBP,LYD,SZL,LTL,MUR,MRO,MKD,MWK,MGA,MYR,MAD,MXN,MZN,MDL,MNT,NPR,NGN,NIO,NZD,OMR,PKR,PYG,PEN,PLN,KHR,SAR,RON,SCR,SYP,SKK,SOS,SDG,SRD,TJS,THB,TWD,BDT,TZS,TND,TMM,UGX,UZS,UYU,PHP,DJF,XAF,XOF,HRK,CZK,CLP,LKR,EEK,ETB,RSD,ZAR,KRW,NAD,TL,UEparameters
Type: object[]
name
Type: string
参数的名称。
Example:
examplevalue
Type: string
参数的值。
Example:
example资费计算参数。
Example
[ { "name": "example", "value": "example" } ]type
Type: string
市场服务或安置服务的额外收费:
-
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— 用快递取消订单. -
CROSSBORDER_DELIVERY— 从国外交货。 -
INTAKE_SORTING_BULKY_CARGO— 用市场从卖方仓库中提取的大件物品对订单进行排序。 -
INTAKE_SORTING_SMALL_GOODS— 用市场从卖方仓库中取出的小件物品对订单进行排序。 -
INTAKE_SORTING_DAILY— 组织从卖方仓库收集订单. -
FF_STORAGE_BILLING— 在仓库中储存货物. -
CANCELLED_ORDER_FEE_QI— 取消订单是卖方的过错。 -
LATE_ORDER_EXECUTION_FEE_QI— 延迟装运或交货. -
VOLUME_STORAGE— 在仓库中存储货物的成本 — 以每天一立方米计算。 -
GOODS_ACCEPTANCE— 仓库货物的最终验收. -
CARGO_ACCEPTANCE— 仓库中货物的初始验收。 -
ORDER_PROCESSING— 订单处理。 -
WITHDRAW_EXTERNAL— 运送到外部市场。
阅读更多关于Yandex的信息。市场服务 在市场对卖家的帮助.
Enum:
AGENCY_COMMISSION,PAYMENT_TRANSFER,STORAGE,WITHDRAW,SURPLUS,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,CROSSBORDER_DELIVERY,INTAKE_SORTING_BULKY_CARGO,INTAKE_SORTING_SMALL_GOODS,INTAKE_SORTING_DAILY,FF_STORAGE_BILLING,CANCELLED_ORDER_FEE_QI,LATE_ORDER_EXECUTION_FEE_QI,VOLUME_STORAGE,GOODS_ACCEPTANCE,CARGO_ACCEPTANCE,ORDER_PROCESSING,WITHDRAW_EXTERNALpercent
Type: number
关税价值以百分比表示。
有关您需要为Yandex支付的关税的信息。市场服务。
对于某些服务,可能会返回几个不同的值。 例如,在模型中 FBS 服务的成本
SORTING(订单处理)取决于运输方式 和货件中的订单数量。 阅读更多有关服务收费的资料 在市场对卖家的帮助.Min items:
1Example
[ { "type": "AGENCY_COMMISSION", "percent": 0.5, "amount": 0.5, "currency": "RUR", "parameters": [ { "name": "example", "value": "example" } ] } ]warehouses
Type: object[]
stocks
Type: object[]
count
Type: integer
剩菜的价值。
type
Type: string
仓库中剩余货物的类型:
-
AVAILABLE(对应于市场上卖方办公室"库存余额"报告中的"可供订购"类型) — 可供出售的物品。 -
DEFECT(对应于"婚姻"类型) — 有缺陷的产品。 -
EXPIRED(对应于"逾期"类型) — 过期的产品。 -
FIT(对应于"适合"类型) — 可供出售或已被保留的物品。 -
FREEZE— 为订单保留的产品。 -
QUARANTINE(对应于"隔离"类型) — 暂时不可出售的物料(例如,物料正在从一个仓库移动到另一个仓库)。 -
UTILIZATION— 将被处置的产品。
Enum:
FIT,FREEZE,AVAILABLE,QUARANTINE,UTILIZATION,DEFECT,EXPIRED仓库中剩余货物的信息。
Example
[ { "type": "FIT", "count": 0 } ]id
Type: integer
仓库ID。
name
Type: string
仓库的名称。
Example:
example有关存储货物的仓库的信息。
如果产品不在任何仓库中,则不会收到该参数。
Min items:
1Example
[ { "id": 0, "name": "example", "stocks": [ { "type": "FIT", "count": 0 } ] } ]weightDimensions
Type: object
height
Type: number
产品的高度以厘米为单位。
length
Type: number
产品的长度以厘米为单位。
weight
Type: number
以公斤为单位的产品重量。
width
Type: number
产品的宽度以厘米为单位。
有关产品重量和尺寸的信息。
如果产品已链接到卡(
marketSku),响应将返回市场卡中的尺寸,而不是您提供的尺寸。Example
{ "length": 0.5, "width": 0.5, "height": 0.5, "weight": 0.5 }的产品清单。
Example
[ { "shopSku": "example", "marketSku": 1, "name": "example", "price": 0.5, "categoryId": 0, "categoryName": "example", "weightDimensions": { "length": 0.5, "width": 0.5, "height": 0.5, "weight": 0.5 }, "warehouses": [ { "id": 0, "name": "example", "stocks": [ {} ] } ], "tariffs": [ { "type": "AGENCY_COMMISSION", "percent": 0.5, "amount": 0.5, "currency": "RUR", "parameters": [ {} ] } ], "pictures": [ "example" ] } ]产品报告。
Example
{ "shopSkus": [ { "shopSku": "example", "marketSku": 1, "name": "example", "price": 0.5, "categoryId": 0, "categoryName": "example", "weightDimensions": { "length": 0.5, "width": 0.5, "height": 0.5, "weight": 0.5 }, "warehouses": [ { "id": 0, "name": "example", "stocks": [ null ] } ], "tariffs": [ { "type": "AGENCY_COMMISSION", "percent": 0.5, "amount": 0.5, "currency": "RUR", "parameters": [ null ] } ], "pictures": [ "example" ] } ] }Example
{ "result": { "shopSkus": [ { "shopSku": "example", "marketSku": 1, "name": "example", "price": 0.5, "categoryId": 0, "categoryName": "example", "weightDimensions": { "length": 0.5, "width": 0.5, "height": 0.5, "weight": 0.5 }, "warehouses": [ {} ], "tariffs": [ {} ], "pictures": [ "example" ] } ] } } -
400 Bad Request
请求包含不正确的数据。 有关错误的更多信息
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "example",
"message": "example"
}
]
}
Type: object
All of 1 type
-
Type: object
All of 2 types
-
Type: object
status
Type: string
响应的类型。 可能的值:
OK— 没有错误。ERROR— 处理请求时出错。
Enum:
OK,ERROR服务器响应的标准包装器。
Example
{ "status": "OK" } -
Type: object
errors
Type: object[]
code
Type: string
的错误代码。
Example:
examplemessage
Type: string
错误的描述。
Example:
example错误列表。
Min items:
1Example
[ { "code": "example", "message": "example" } ]Example
{ "errors": [ { "code": "example", "message": "example" } ] }
服务器错误的标准包装器。
Example
{ "status": "OK", "errors": [ { "code": "example", "message": "example" } ] } -
401 Unauthorized
请求中未指定授权数据。 有关错误的更多信息
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "example",
"message": "example"
}
]
}
Type: object
All of 1 type
-
Type: object
All of 2 types
-
Type: object
status
Type: string
响应的类型。 可能的值:
OK— 没有错误。ERROR— 处理请求时出错。
Enum:
OK,ERROR服务器响应的标准包装器。
Example
{ "status": "OK" } -
Type: object
errors
Type: object[]
code
Type: string
的错误代码。
Example:
examplemessage
Type: string
错误的描述。
Example:
example错误列表。
Min items:
1Example
[ { "code": "example", "message": "example" } ]Example
{ "errors": [ { "code": "example", "message": "example" } ] }
服务器错误的标准包装器。
Example
{ "status": "OK", "errors": [ { "code": "example", "message": "example" } ] } -
403 Forbidden
授权数据不正确或禁止访问资源。 有关错误的更多信息
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "example",
"message": "example"
}
]
}
Type: object
All of 1 type
-
Type: object
All of 2 types
-
Type: object
status
Type: string
响应的类型。 可能的值:
OK— 没有错误。ERROR— 处理请求时出错。
Enum:
OK,ERROR服务器响应的标准包装器。
Example
{ "status": "OK" } -
Type: object
errors
Type: object[]
code
Type: string
的错误代码。
Example:
examplemessage
Type: string
错误的描述。
Example:
example错误列表。
Min items:
1Example
[ { "code": "example", "message": "example" } ]Example
{ "errors": [ { "code": "example", "message": "example" } ] }
服务器错误的标准包装器。
Example
{ "status": "OK", "errors": [ { "code": "example", "message": "example" } ] } -
404 Not Found
找不到请求的资源。 有关错误的更多信息
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "example",
"message": "example"
}
]
}
Type: object
All of 1 type
-
Type: object
All of 2 types
-
Type: object
status
Type: string
响应的类型。 可能的值:
OK— 没有错误。ERROR— 处理请求时出错。
Enum:
OK,ERROR服务器响应的标准包装器。
Example
{ "status": "OK" } -
Type: object
errors
Type: object[]
code
Type: string
的错误代码。
Example:
examplemessage
Type: string
错误的描述。
Example:
example错误列表。
Min items:
1Example
[ { "code": "example", "message": "example" } ]Example
{ "errors": [ { "code": "example", "message": "example" } ] }
服务器错误的标准包装器。
Example
{ "status": "OK", "errors": [ { "code": "example", "message": "example" } ] } -
420 Method Failure
已超出资源访问限制。 有关错误的更多信息
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "example",
"message": "example"
}
]
}
Type: object
All of 1 type
-
Type: object
All of 2 types
-
Type: object
status
Type: string
响应的类型。 可能的值:
OK— 没有错误。ERROR— 处理请求时出错。
Enum:
OK,ERROR服务器响应的标准包装器。
Example
{ "status": "OK" } -
Type: object
errors
Type: object[]
code
Type: string
的错误代码。
Example:
examplemessage
Type: string
错误的描述。
Example:
example错误列表。
Min items:
1Example
[ { "code": "example", "message": "example" } ]Example
{ "errors": [ { "code": "example", "message": "example" } ] }
服务器错误的标准包装器。
Example
{ "status": "OK", "errors": [ { "code": "example", "message": "example" } ] } -
500 Internal Server Error
Yandex中的内部错误。 市场。 有关错误的更多信息
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "example",
"message": "example"
}
]
}
Type: object
All of 1 type
-
Type: object
All of 2 types
-
Type: object
status
Type: string
响应的类型。 可能的值:
OK— 没有错误。ERROR— 处理请求时出错。
Enum:
OK,ERROR服务器响应的标准包装器。
Example
{ "status": "OK" } -
Type: object
errors
Type: object[]
code
Type: string
的错误代码。
Example:
examplemessage
Type: string
错误的描述。
Example:
example错误列表。
Min items:
1Example
[ { "code": "example", "message": "example" } ]Example
{ "errors": [ { "code": "example", "message": "example" } ] }
服务器错误的标准包装器。
Example
{ "status": "OK", "errors": [ { "code": "example", "message": "example" } ] } -
No longer supported, please use an alternative and newer version.