根据标识符获取商品信息

用于根据商品标识符获取商品信息的方法。

请求体应包含同类型标识符的数组，响应中将返回 items 数组。

单个请求最多可通过 offer_id、product_id 和 sku 传递总计不超过 1000个商品标识符。

请求参数

Header 参数

Client-Id

string

用户识别号。

必需

Api-Key

string

API-密钥。

必需

Body 参数application/json

offer_id

array[string]

可选

商品在卖家系统中的标识符 — 货号。

product_id

array[string <int64>]

商品标识符。

可选

sku

array[string <int64>]

可选

商品在 Ozon 系统中的标识符 — SKU。

示例

{
    "offer_id": [
        "string"
    ],
    "product_id": [
        "string"
    ],
    "sku": [
        "string"
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

商品列表

Body

items

array[object (object) {35}]

数据数组。

可选

barcodes

array[string]

商品的所有条形码。

可选

color_image

array[string]

商品颜色图片。

可选

commissions

array[object (object) {5}]

佣金信息。

可选

created_at

string <date-time>

可选

商品的创建日期和时间。

currency_code

string

货币单位。

可选

description_category_id

integer <int64>

可选

类目标识符。
可与 /v1/description-category/attribute 和 /v1/description-category/attribute/values 方法配合使用。

discounted_fbo_stocks

integer <int32>

可选

Ozon 仓库中减价商品的库存。

errors

array[object (object) {6}]

可选

创建或验证商品时的错误信息。

has_discounted_fbo_item

boolean

可选

商品在 Ozon 仓库中是否有减价版的同款商品。

integer <int64>

商品标识符。

可选

images

array[string]

可选

图片链接数组。图片在数组中的顺序与网站上的展示顺序一致。如果
primary_image 参数未指定，则数组中的第一张图片为商品主图。

images360

array[string]

可选

360° 商品图片数组。

is_archived

boolean

可选

如果商品是手动归档的，则为 true。

is_autoarchived

boolean

可选

如果商品是自动归档的，则为 true。

is_discounted

boolean

可选

商品是否为减价商品：

如果商品是由卖家作为减价商品创建的，则为 true。

如果商品不是减价商品或是由Ozon减价的，则为 false。

is_kgt

boolean

超大货物标识。

可选

is_prepayment_allowed

boolean

可选

如果支持预付款，则为 true。

is_super

boolean

可选

超级商品标识。

有关超级商品的详细信息，请参考卖家知识库

marketing_price

string

可选

商品在 Ozon 橱窗中的最终价格，包含所有促销折扣，但不含Ozon 卡优惠。

min_price

string

可选

应用促销后的最低价格。

model_info

object (object)

商品型号信息。

可选

name

string

名称。

可选

offer_id

string

可选

商品在卖家系统中的标识符 — 货号。

old_price

string

可选

不含折扣价格。在商品卡片上显示为划线价。

price

string

可选

商品的含折扣价格。该值将在商品卡片上显示。

price_indexes

object (object)

商品价格指数。

可选

primary_image

array[string]

商品的主图。

可选

sources

array[object (object) {5}]

商品创建来源信息。

可选

statuses

object (object)

商品状态信息。

可选

stocks

object (object)

商品库存信息。

可选

type_id

integer <int64>

商品类型标识符。

可选

updated_at

string <date-time>

可选

商品的最后更新时间。

vat

string

商品的增值税税率。

可选

visibility_details

object (object)

商品的可见性设置。

可选

volume_weight

number <double>

商品的体积重量。

可选

示例

{
    "items": [
        {
            "barcodes": [
                "string"
            ],
            "color_image": [
                "string"
            ],
            "commissions": [
                {
                    "delivery_amount": 0,
                    "percent": 0,
                    "return_amount": 0,
                    "sale_schema": "string",
                    "value": 0
                }
            ],
            "created_at": "2019-08-24T14:15:22Z",
            "currency_code": "string",
            "description_category_id": 0,
            "discounted_fbo_stocks": 0,
            "errors": [
                {
                    "attribute_id": 0,
                    "code": "string",
                    "field": "string",
                    "level": "ERROR_LEVEL_UNSPECIFIED",
                    "state": "string",
                    "texts": {
                        "attribute_name": "string",
                        "description": "string",
                        "hint_code": "string",
                        "message": "string",
                        "params": [
                            {
                                "name": "string",
                                "value": "string"
                            }
                        ],
                        "short_description": "string"
                    }
                }
            ],
            "has_discounted_fbo_item": true,
            "id": 0,
            "images": [
                "string"
            ],
            "images360": [
                "string"
            ],
            "is_archived": true,
            "is_autoarchived": true,
            "is_discounted": true,
            "is_kgt": true,
            "is_prepayment_allowed": true,
            "is_super": true,
            "marketing_price": "string",
            "min_price": "string",
            "model_info": {
                "count": 0,
                "model_id": 0
            },
            "name": "string",
            "offer_id": "string",
            "old_price": "string",
            "price": "string",
            "price_indexes": {
                "color_index": "COLOR_INDEX_UNSPECIFIED",
                "external_index_data": {
                    "minimal_price": "string",
                    "minimal_price_currency": "string",
                    "price_index_value": 0
                },
                "ozon_index_data": {
                    "minimal_price": "string",
                    "minimal_price_currency": "string",
                    "price_index_value": 0
                },
                "self_marketplaces_index_data": {
                    "minimal_price": "string",
                    "minimal_price_currency": "string",
                    "price_index_value": 0
                }
            },
            "primary_image": [
                "string"
            ],
            "sources": [
                {
                    "created_at": "2019-08-24T14:15:22Z",
                    "quant_code": "string",
                    "shipment_type": "SHIPMENT_TYPE_UNSPECIFIED",
                    "sku": 0,
                    "source": "string"
                }
            ],
            "statuses": {
                "is_created": true,
                "moderate_status": "string",
                "status": "string",
                "status_description": "string",
                "status_failed": "string",
                "status_name": "string",
                "status_tooltip": "string",
                "status_updated_at": "2019-08-24T14:15:22Z",
                "validation_status": "string"
            },
            "stocks": {
                "has_stock": true,
                "stocks": [
                    {
                        "present": 0,
                        "reserved": 0,
                        "sku": 0,
                        "source": "string"
                    }
                ]
            },
            "type_id": 0,
            "updated_at": "2019-08-24T14:15:22Z",
            "vat": "string",
            "visibility_details": {
                "has_price": true,
                "has_stock": true
            },
            "volume_weight": 0
        }
    ]
}

🟠400请求有误

🟠403禁止访问

🟠404记录不存在

🟠409409

🔴500服务器错误