创建或更新商品

POST

/v3/product/import

ProductAPI

创建商品并更新有关商品信息的方法。

欲知限制，请使用
/v4/product/info/limit。如果商品下载和更新次数
超过限制，则出现错误 item_limit_exceeded。

一次请求最多可转移100种商品。每个商品都是数组中的单独元素 items。请指出
有关商品的所有信息：特征、条形码、图像、尺寸、价格和价格货币。

在更新商品时，请在请求中转达有关商品的所有信息。

指定货币必须与个人中心中设置的币种相匹配。默认情况下显示 RUB — 俄罗斯卢布。
如果您设置了人民币为币种, 请选择 CNY, 否则将返回错误。

如果您填写错误或指定，则不会创建或更新商品:

强制特征: 不同类目的属性有所不同——您可以在卖家知识库中查看，或者通过方法 /v1/description-category/attribute获取。

真实体积和重量特性: depth, width, height, dimension_unit, weight, weight_unit。请勿在请求中跳过这些参数，也不要指定0。

HTML标签可用于某些特征。

更多关于特征的信息可见卖家知识库

审核后，该商品将出现在您的个人中心中，但在您将其出售之前，用户将无法看到该商品。

请求中的每项都是数组的单独元素 items。

为连接两张卡片, 请对每张卡片传递9048 在 attributes中。这些卡片除了大小或颜色外的所有属性都必须匹配。

加载图片

若要上传，请将请求中的图像链接发至公共云存储中。
链接的图像格式为JPG或PNG。

按照网站上所需的顺序将图像放在images 数组中。要加载主图请使用 primary_image参数。如果没有传递 primary_image值, 主图将是
在 images组中的第一张图片。

对于每个商品，您最多可以上传15个图像，包括主图像。
如果传递 primary_image值, 在 images 的最大图像数为——14。
如果参数 primary_image 为空, 那么在images 可以传递最多15张图片。

若要上传招聘360，请使用images360字段, 上传营销名字 — color_image。

如果要更改图像的构图或顺序，请使用
/v3/product/info/list
方法获取信息 —— 里面显示当前订单和
图像组成。请复制 images, images360, color_image字段的数据, 更改和完成列表或者
根据需求订购。

上传视频

上传视频请在请求中上传视频链接。

为此，请在 complex_attributes参数中传递对象。在attributes数组中，请传递两个含complex_id = 100001的对象:

在第一个中，请赋值指定 id = 21841 和在数组 values 中传输含视频链接的对象。

例子:

{
  "complex_id": 100001,
  "id": 21841,
  "values": [
    {
      "value": "https://www.youtube.com/watch?v=ZwM0iBn03dY"
    }
  ]
}

在二个中，请指定值id = 21837 和在 values 数组中传输含视频名称的对象。

例子:

{
  "complex_id": 100001,
  "id": 21837,
  "values": [
    {
      "value": "videoName_1"
    }
  ]
}

如果您想上传视频, 请在不同的values数组对象中为每个视频赋值。

例子:

{
  "complex_id": 100001,
  "id": 21837,
  "values": [
    {
      "value": "videoName_1"
    },
    {
      "value": "videoName_2"
    }
  ]
},
{
  "complex_id": 100001,
  "id": 21841,
  "values": [
    {
      "value": "https://www.youtube.com/watch?v=ZwM0iBn03dY"
    },
    {
      "value": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
    }
  ]
}

上传尺寸表

为添加使用以下方法创建的尺寸图表设计, 请在attributes组传递表格，格式 JSON 如 Rich-内容 id = 13164。

JSON格式的设计
更多关于设计可见卖家知识库

视频封面上传

您可以通过综合属性上传视频封面 complex_attributes。

例子：

"complex_attributes": [
  {
    "attributes": [
      {
        "id": 21845,
        "complex_id": 100002,
        "values": [
          {
          "dictionary_value_id": 0,
          "value": "https://v.ozone.ru/vod/video-10/01GFATWQVCDE7G5B721421P1231Q7/asset_1.mp4"
          }
        ]
      }
    ]
  }
]

请求参数

Header 参数

Client-Id

string

用户识别号。

必需

Api-Key

string

API-密钥。

必需

Body 参数application/json

items

array[object (object) {26}]

数据组。

可选

attributes

array[object (object) {3}]

必需

商品特性组。不同类别的特征不同 — 其可见卖家知识库或通过 API。

barcode

string

商品条码。

可选

description_category_id

integer <int64>

必需

类别ID。可以使用方法 /v1/description-category/tree获取。

new_description_category_id

integer <int64>

可选

新的类目标识符。如果需要更改当前商品类目，请填写该标识符。

color_image

string

可选

营销色彩。

格式：公共云存储中图像链接的URL。链接的图像格式为JPG。

complex_attributes

array[object (object) {1}]

可选

具有嵌套属性的特征组。

currency_code

string

可选

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

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

可能的值：

RUB — 俄罗斯卢布,

BYN — 白俄罗斯卢布,

KZT — 坚戈,

EUR — 欧元,

USD — 美元,

CNY — 元。

depth

integer <int32>

包装厚度。

必需

dimension_unit

string

必需

尺寸测量单位:

mm — 毫米,

cm — 厘米,

in — 英寸。

geo_names

array[string]

可选

地理限制 —— 如有必要，请在个人中心中创建或编辑商品时填写该参数。

该参数为可选项。

height

integer <int32>

包装高度。

必需

images

array[string]

必需

图像组。最多15件。图像以与组中相同的顺序显示在网站上。

如果不传递值 primary_image, 组中的第一个图像将是商品的主图。

如果您传递了值 primary_image，则最多传递14个图像。
如果 primary_image 参数为空，则最多传递15个图像。

格式：公共云存储中图像链接的URL。链接的图像格式为JPG或PNG。

primary_image

string

链接到商品主图。

可选

promotions

array[object (object) {2}]

促销活动。

可选

service_type

string

可选

服务类型。以大写形式传递其中的一个值:

IS_CODE_SERVICE,

IS_NO_CODE_SERVICE。

默认值:

IS_CODE_SERVICE

images360

array[string]

可选

图像组360。至70件。

格式：公共云存储中图像链接的URL。链接的图像格式为JPG。

name

string

必需

商品名称。至500字符。

offer_id

string

必需

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

old_price

string

可选

折扣前的价格（将在产品卡上划掉）。以卢布表示。分数分隔
符号 — 点, 在点之后最多两个字符。

如果您之前传递了 old_price, 那么在更新 price 时也请更新 old_price。

pdf_list

array[object (object) {3}]

PDF-文件清单。

可选

price

string

必需

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

type_id

integer <int64>

必需

商品类型的标识符。
可以通过方法/v1/description-category/tree的响应参数 type_id 获取对应的值。
填写此参数时，可以不在 attibutes 中指定参数 id:8229 的属性，type_id 将优先使用。

vat

string

必需

商品增值税税率：

0 — 免除增值税,

0.05 — 5%,

0.07 — 7%,

0.1 — 10%,

0.2 — 20%。

传递当前有效的出价值。

weight

integer <int32>

必需

含包装的商品重量。限值为1000公斤或其他换算值
计量单位。

weight_unit

string

必需

测重单位：

g — 克,

kg — 公斤,

lb — 磅。

width

integer <int32>

包装宽度。

必需

示例

不上传视频的请求示例视频上传请求示例

{
    "items": [
        {
            "attributes": [
                {
                    "complex_id": 0,
                    "id": 5076,
                    "values": [
                        {
                            "dictionary_value_id": 971082156,
                            "value": "麦克风架"
                        }
                    ]
                },
                {
                    "complex_id": 0,
                    "id": 9048,
                    "values": [
                        {
                            "value": "一套X3NFC保护膜。 深色棉质"
                        }
                    ]
                },
                {
                    "complex_id": 0,
                    "id": 8229,
                    "values": [
                        {
                            "dictionary_value_id": 95911,
                            "value": "一套X3NFC保护膜。深色棉质"
                        }
                    ]
                },
                {
                    "complex_id": 0,
                    "id": 85,
                    "values": [
                        {
                            "dictionary_value_id": 5060050,
                            "value": "Samsung"
                        }
                    ]
                },
                {
                    "complex_id": 0,
                    "id": 10096,
                    "values": [
                        {
                            "dictionary_value_id": 61576,
                            "value": "灰色的"
                        }
                    ]
                }
            ],
            "barcode": "112772873170",
            "description_category_id": 17028922,
            "new_description_category_id": 0,
            "color_image": "",
            "complex_attributes": [],
            "currency_code": "RUB",
            "depth": 10,
            "dimension_unit": "mm",
            "height": 250,
            "images": [],
            "images360": [],
            "name": "一套X3NFC的保护膜。深色棉质",
            "offer_id": "143210608",
            "old_price": "1100",
            "pdf_list": [],
            "price": "1000",
            "primary_image": "",
            "promotions": [
                {
                    "operation": "UNKNOWN",
                    "type": "REVIEWS_PROMO"
                }
            ],
            "type_id": 91565,
            "vat": "0.1",
            "weight": 100,
            "weight_unit": "g",
            "width": 150
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

不上传视频的请求示例视频上传请求示例

curl --location --request POST 'https://api-seller.ozon.ru/v3/product/import' \
--header 'Client-Id;' \
--header 'Api-Key;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "items": [
        {
            "attributes": [
                {
                    "complex_id": 0,
                    "id": 5076,
                    "values": [
                        {
                            "dictionary_value_id": 971082156,
                            "value": "麦克风架"
                        }
                    ]
                },
                {
                    "complex_id": 0,
                    "id": 9048,
                    "values": [
                        {
                            "value": "一套X3NFC保护膜。 深色棉质"
                        }
                    ]
                },
                {
                    "complex_id": 0,
                    "id": 8229,
                    "values": [
                        {
                            "dictionary_value_id": 95911,
                            "value": "一套X3NFC保护膜。深色棉质"
                        }
                    ]
                },
                {
                    "complex_id": 0,
                    "id": 85,
                    "values": [
                        {
                            "dictionary_value_id": 5060050,
                            "value": "Samsung"
                        }
                    ]
                },
                {
                    "complex_id": 0,
                    "id": 10096,
                    "values": [
                        {
                            "dictionary_value_id": 61576,
                            "value": "灰色的"
                        }
                    ]
                }
            ],
            "barcode": "112772873170",
            "description_category_id": 17028922,
            "new_description_category_id": 0,
            "color_image": "",
            "complex_attributes": [],
            "currency_code": "RUB",
            "depth": 10,
            "dimension_unit": "mm",
            "height": 250,
            "images": [],
            "images360": [],
            "name": "一套X3NFC的保护膜。深色棉质",
            "offer_id": "143210608",
            "old_price": "1100",
            "pdf_list": [],
            "price": "1000",
            "primary_image": "",
            "promotions": [
                {
                    "operation": "UNKNOWN",
                    "type": "REVIEWS_PROMO"
                }
            ],
            "type_id": 91565,
            "vat": "0.1",
            "weight": 100,
            "weight_unit": "g",
            "width": 150
        }
    ]
}'

返回响应

🟢200成功

application/json

创建新商品 / 商品信息更新

Body

result

object (object)

查询结果。

可选

task_id

integer <int64>

装卸任务的编号。

可选

示例

{
    "result": {
        "task_id": 172549793
    }
}

🟠400请求有误

🟠403禁止访问

🟠404记录不存在

🟠409409

🔴500服务器错误

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

根据属性的参考值进行搜索

查询商品添加或更新状态

创建或更新商品

加载图片#

上传视频#

上传尺寸表#

视频封面上传#

请求参数

示例代码

返回响应

加载图片

上传视频

上传尺寸表

视频封面上传