获取商品价格信息 - Ozon Seller API

请求参数

Header 参数

Client-Id

string

用户识别号。

必需

Api-Key

string

API-密钥。

必需

Body 参数application/json

cursor

string

可选

用于选择数据的指针。

filter

object (object)

商品筛选器。

必需

offer_id

array[string]

可选

基于 offer_id 参数的筛选（最多可传递 1000 个值）。

product_id

array[string <int64>]

可选

基于 product_id 参数的筛选（最多可传递 1000 个值）。

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 — 对买家隐藏的商品。

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_SALEOVERPRICEDCRITICALLY_OVERPRICEDEMPTY_BARCODEBARCODE_EXISTSQUARANTINEARCHIVEDOVERPRICED_WITH_STOCKPARTIAL_APPROVED

默认值:

ALL

limit

integer <int32>

必需

每页显示的数值数量。

>= 1<= 1000

示例

{
    "cursor": "",
    "filter": {
        "offer_id": [
            "356792"
        ],
        "product_id": [
            "243686911"
        ],
        "visibility": "ALL"
    },
    "limit": 100
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

商品价格信息

Body

cursor

string

可选

用于选择数据的指针。

items

array[object (object) {8}]

商品列表。

可选

acquiring

integer <int32>

最高收单手续费。

可选

commissions

object (object)

佣金信息。

可选

marketing_actions

object (object)

卖家营销活动。

可选

offer_id

string

可选

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

price

object (object)

商品价格。

可选

price_indexes

object (object)

商品价格指数。

可选

product_id

integer <int64>

可选

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

volume_weight

number <double>

商品体积重量。

可选

total

integer <int32>

可选

商品列表中的商品数量。

示例

{
    "cursor": "string",
    "items": [
        {
            "acquiring": 0,
            "commissions": {
                "fbo_deliv_to_customer_amount": 14.75,
                "fbo_direct_flow_trans_max_amount": 46.5,
                "fbo_direct_flow_trans_min_amount": 31,
                "fbo_return_flow_amount": 50,
                "fbs_deliv_to_customer_amount": 60,
                "fbs_direct_flow_trans_max_amount": 61.5,
                "fbs_direct_flow_trans_min_amount": 41,
                "fbs_first_mile_max_amount": 25,
                "fbs_first_mile_min_amount": 0,
                "fbs_return_flow_amount": 40,
                "sales_percent_fbo": 15,
                "sales_percent_fbs": 0
            },
            "marketing_actions": {
                "actions": [
                    {
                        "date_from": "2024-12-13T06:49:37.591Z",
                        "date_to": "2024-12-13T06:49:37.591Z",
                        "title": "string",
                        "value": 0
                    }
                ],
                "current_period_from": "2024-12-13T06:49:37.591Z",
                "current_period_to": "2024-12-13T06:49:37.591Z",
                "ozon_actions_exist": true
            },
            "offer_id": "356792",
            "price": {
                "auto_action_enabled": true,
                "currency_code": "RUB",
                "marketing_price": 0,
                "marketing_seller_price": 0,
                "min_price": 0,
                "net_price": 0,
                "old_price": 579,
                "price": 499,
                "retail_price": 0,
                "vat": 0.2
            },
            "price_indexes": {
                "color_index": "WITHOUT_INDEX",
                "external_index_data": {
                    "min_price": 0,
                    "min_price_currency": "string",
                    "price_index_value": 0
                },
                "ozon_index_data": {
                    "min_price": 0,
                    "min_price_currency": "string",
                    "price_index_value": 0
                },
                "self_marketplaces_index_data": {
                    "min_price": 0,
                    "min_price_currency": "string",
                    "price_index_value": 0
                }
            },
            "product_id": 243686911,
            "volume_weight": 0
        }
    ],
    "total": 0
}

🟠400请求有误

🟠403禁止访问

🟠404记录不存在

🟠409409

🔴500服务器错误