更新价格

POST

/v1/product/import/prices

Prices&StocksAPI

允许更改一个或多个商品的价格。每个商品的价格每小时不能更新超过10次。要重置old_price，请将此参数设为0。

如果请求中同时包含参数 offer_id 和 product_id，系统将优先根据 offer_id 应用更改。为避免歧义，建议仅使用一个参数。

请求参数

Header 参数

Client-Id

string

用户识别号。

必需

Api-Key

string

API-密钥。

必需

Body 参数application/json

prices

array[object (object) {11}]

商品价格信息。

可选

<= 1000 items

auto_action_enabled

enum<string>

可选

启用和禁用自动应用活动的属性：

ENABLED — 启用;

DISABLED — 关闭;

UNKNOWN — 不做任何更改，默认赋值。

例如，如果你以前启用了活动的自动应用，并且不想关闭它，请提交UNKNOWN。

如果你在这个参数中提交ENABLED，在min_price参数中设置最低价格。

枚举值:

UNKNOWNENABLEDDISABLED

默认值:

UNKNOWN

currency_code

string

可选

您的价格的货币。提交的数值必须与你个人主页设置中的货币相匹配。默认情况下，会提交 RUB — 俄罗斯卢布。

例如，如果您设置的相互结算的货币是人民币，请提交数值 CNY，否则将返回错误。

可填的数值：

RUB — 俄罗斯卢布。

BYN — 白俄罗斯卢布。

KZT — 坚戈。

`EUR' — 欧元。

USD — 美元。

CNY — 人民币。

min_price

string

可选

应用促销活动后的商品最低价格。

min_price_for_auto_actions_enabled

boolean

可选

true，如果为 Ozon 在添加到促销时会考虑最低价格。如果不传递任何值，价格计算的状态将保持不变。

net_price

string

产品成本价。

可选

offer_id

string

可选

卖家系统中的卖家系统中的商品标识符 — product_id。

old_price

string

可选

折扣前的价格（在商品卡上划掉）价格以卢布表。小数部分用一个点隔开，点后最多两个字符。

如果商品没有折扣，在这个字段中输入 "0"，并将当前价格提交到 "price"栏中。

price

string

可选

商品的价格，包括折扣，都显示在商品详情页上。

若参数old_price值大于0,则price与old_price之间应为具体差额。
差额取决于price值。

`price`值	最小差额
< 400	20 卢布
400–10 000	5%
> 10 000	500 卢布

price_strategy_enabled

enum<string>

可选

用于自动应用价格策略的属性：

ENABLED — 启用;

DISABLED — 关闭;

UNKNOWN — 不做任何更改，默认赋值。

如果您之前已启用价格策略的自动应用，并且不希望关闭，请在后续请求中赋值 UNKNOWN 。

如果你在这个参数中提交ENABLED，在min_price参数中设置最低价格。

如果您在此参数中赋值 DISABLED，商品将从策略中移除。

枚举值:

UNKNOWNENABLEDDISABLED

默认值:

UNKNOWN

product_id

integer <int64>

可选

卖家系统中的商品标识符 — product_id。

vat

string

可选

商品增值税税率：

0 — 免除增值税,

0.05 — 5%,

0.07 — 7%,

0.1 — 10%,

0.2 — 20%。

传递当前有效的出价值。

示例

{
    "prices": [
        {
            "auto_action_enabled": "UNKNOWN",
            "currency_code": "RUB",
            "min_price": "800",
            "min_price_for_auto_actions_enabled": true,
            "net_price": "650",
            "offer_id": "",
            "old_price": "0",
            "price": "1448",
            "price_strategy_enabled": "UNKNOWN",
            "product_id": 1386,
            "vat": "0.1"
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api-seller.ozon.ru/v1/product/import/prices' \
--header 'Client-Id;' \
--header 'Api-Key;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "prices": [
        {
            "auto_action_enabled": "UNKNOWN",
            "currency_code": "RUB",
            "min_price": "800",
            "min_price_for_auto_actions_enabled": true,
            "net_price": "650",
            "offer_id": "",
            "old_price": "0",
            "price": "1448",
            "price_strategy_enabled": "UNKNOWN",
            "product_id": 1386,
            "vat": "0.1"
        }
    ]
}'

返回响应

🟢200成功

application/json

价格更新

Body

result

array[object (object) {4}]

搜索结果。

可选

errors

array[object (object) {2}]

可选

在搜索处理过程中发生的数组错误。

offer_id

string

可选

卖家系统中的商品编号是 — 商品代码。

product_id

integer <int64>

可选

卖家系统中的商品标识符 — product_id。

updated

boolean

可选

如果商品信息已被成功更新 — true。

示例

{
    "result": [
        {
            "product_id": 1386,
            "offer_id": "PH8865",
            "updated": true,
            "errors": []
        }
    ]
}

🟠400请求有误

🟠403禁止访问

🟠404记录不存在

🟠409409

🔴500服务器错误

修改于 2025-06-10 08:30:17

关于卖家库存余额的信息

获取商品价格信息