Ozon Seller API

通过SKU创建商品

POST

/v1/product/import-by-sku

ProductAPI

该方法会创建指定SKU的商品卡片副本。
如果卖家禁止复制，
将无法创建卡片副本。

无法通过SKU更新商品。

请求参数

Header 参数

Client-Id

string

用户识别号。

必需

Api-Key

string

API-密钥。

必需

Body 参数application/json

items

array[object (object) {7}]

商品信息。

可选

<= 1000 items

name

string

可选

商品名称。小于500字符。

offer_id

string

可选

在卖家系统中的商品ID — 货号。至50字符。

old_price

string

可选

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

price

string

可选

含折扣的商品价格显示在商品卡片上。如果商品没有折扣，请在此参数中指定值old_price。

sku

integer <int64>

必需

在Ozon系统中的商品ID — SKU。

vat

string

可选

商品增值税税率：

0 — 免除增值税,

0.05 — 5%,

0.07 — 7%,

0.1 — 10%,

0.2 — 20%。

传递当前有效的出价值。

currency_code

string

可选

价格显示的货币。传输值必须与个人中心设置中所设置的货币相匹配。默认情况下，显示RUB — 俄罗斯卢布。

例如，如果您设人民币为结算货币，请赋值CNY，否则将返回错误。

可能的值：

RUB — 俄罗斯卢布,

BYN — 白俄罗斯卢布,

KZT — 坚戈,

EUR — 欧元,

USD — 美元,

CNY — 元。

示例

{
    "items": [
        {
            "sku": 298789742,
            "name": "string",
            "offer_id": "91132",
            "currency_code": "RUB",
            "old_price": "2590",
            "price": "2300",
            "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-by-sku' \
--header 'Client-Id;' \
--header 'Api-Key;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "items": [
        {
            "sku": 298789742,
            "name": "string",
            "offer_id": "91132",
            "currency_code": "RUB",
            "old_price": "2590",
            "price": "2300",
            "vat": "0.1"
        }
    ]
}'

返回响应

🟢200成功

application/json

该商品已创建

Body

result

object (object)

可选

task_id

integer <int64>

进口货物任务代码。

可选

unmatched_sku_list

array[integer <int64>]

商品Id列表。

可选

示例

{
    "result": {
        "task_id": 176594213,
        "unmatched_sku_list": []
    }
}

🟠400请求有误

🟠403禁止访问

🟠404记录不存在

🟠409409

🔴500服务器错误

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

查询商品添加或更新状态

更新商品特征