- CategoryAPI
- ProductAPI
- Prices&StocksAPI
- Promos
- PricingStrategyAPI
- WarehouseAPI
- PolygonAPI
- FBS&rFBSMarks
- FBS
- ReturnsAPI
- CancellationAPI
- ChatAPI
- ReportAPI
- AnalyticsAPI
- FinanceAPI
- DeliveryFBS
- DeliveryrFBS
- Pass
- RFBSReturnsAPI
- BetaMethod
- Examples
- ReviewAPI
关于商品数量的信息
POST
/v4/product/info/stocks
Prices&StocksAPI
请求参数
Header 参数
Client-Id
string
用户识别号。
Api-Key
string
API-密钥。
Body 参数application/json
cursor
string
可选
filter
object (v4GetProductInfoStocksRequestFilter)
商品筛选器。
offer_id
array[string]
可选
offer_id
的过滤。 可以提交数值列表。product_id
array[string <int64>]
可选
product_id
的过滤。 可以提交数值列表。visibility
enum<string>
可选
ALL
—— 所有的商品。VISIBLE
—— 买家可见的商品。INVISIBLE
—— 买家看不到的商品。EMPTY_STOCK
—— 没有现货的商品。NOT_MODERATED
—— 未通过审核的商品。MODERATED
—— 通过审核的商品。DISABLED
—— 买家可以看到但不能购买的商品。STATE_FAILED
—— 商品创建失败。READY_TO_SUPPLY
—— 已准备好交货的商品。VALIDATION_STATE_PENDING
—— 正在被验证人预审核的商品。VALIDATION_STATE_FAIL
—— 验证人预审核未通过的商品。VALIDATION_STATE_SUCCESS
—— 验证人预审核通过的商品。TO_SUPPLY
—— 准备出售的商品。IN_SALE
—— 正在销售的商品。REMOVED_FROM_SALE
—— 对买家隐藏的商品。BANNED
—— 商品被封禁。OVERPRICED
—— 价格虚高的商品。CRITICALLY_OVERPRICED
—— 商品价格过高。EMPTY_BARCODE
—— 没有条形码的商品。BARCODE_EXISTS
—— 有条形码的商品。QUARANTINE
—— 价格变化超过50%后商品被隔离。ARCHIVED
—— 归档的商品。OVERPRICED_WITH_STOCK
—— 销售的商品价格高于竞争对手的价格。PARTIAL_APPROVED
—— 销售的商品描述为空或不完整。枚举值:
ALLVISIBLEINVISIBLEEMPTY_STOCKNOT_MODERATEDMODERATEDDISABLEDSTATE_FAILEDREADY_TO_SUPPLYVALIDATION_STATE_PENDINGVALIDATION_STATE_FAILVALIDATION_STATE_SUCCESSTO_SUPPLYIN_SALEREMOVED_FROM_SALEBANNEDOVERPRICEDCRITICALLY_OVERPRICEDEMPTY_BARCODEBARCODE_EXISTSQUARANTINEARCHIVEDOVERPRICED_WITH_STOCKPARTIAL_APPROVED
默认值:
ALL
with_quant
object (FilterWithQuant)
“经济”费率商品。
limit
integer <int32>
必需
示例
{
"cursor": "string",
"filter": {
"offer_id": [
"string"
],
"product_id": [
"string"
],
"visibility": "ALL",
"with_quant": {
"created": true,
"exists": true
}
},
"limit": 0
}
示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api-seller.ozon.ru/v4/product/info/stocks' \
--header 'Client-Id;' \
--header 'Api-Key;' \
--header 'Content-Type: application/json' \
--data-raw '{
"cursor": "string",
"filter": {
"offer_id": [
"string"
],
"product_id": [
"string"
],
"visibility": "ALL",
"with_quant": {
"created": true,
"exists": true
}
},
"limit": 0
}'
返回响应
🟢200成功
application/json
Body
cursor
string
可选
items
array[object (v4GetProductInfoStocksResponseItem) {3}]
商品信息。
offer_id
string
可选
product_id
integer <int64>
商品识别符。
stocks
array[object (GetProductInfoStocksResponseStock) {5}]
库存信息。
total
integer <int32>
可选
示例
{
"cursor": "string",
"items": [
{
"offer_id": "string",
"product_id": 0,
"stocks": [
{
"present": 0,
"reserved": 0,
"shipment_type": "SHIPMENT_TYPE_GENERAL",
"sku": 0,
"type": "string"
}
]
}
],
"total": 0
}
🔴500服务器错误
修改于 2025-06-10 08:30:31