SKU查询客户价格接口

提供根据客户ID查询多个SKU在指定国家/地区的客户专属价格的能力，支持批量查询。(仅限ERP账号查询)

适用场景

查询特定客户在不同国家/地区的SKU价格

接口类型

POST

请求频率限制

默认频率：以平台配额为准

请求说明

请求URL

正式环境：https://www.westmonth.com/openapi/skuPrice/customerPrice
测试环境：https://testing.westmonth.com/openapi/skuPrice/customerPrice

请求参数

Header参数

参数名	类型	必填	示例值	说明
Authorization	string	是	authorization	身份验证Token
Content-Type	string	是	application/json	建议固定传此值

Body参数

根字段

参数名	类型	必填	默认值	可选值	说明
skus	array	是	-	-	SKU列表，支持批量查询
region_codes	array	是	-	标准国家二字码，网上可查	国家二字码列表
customer_id	integer	是	-	-	客户ID

响应字段说明

成功响应（HTTP 200）

根字段

字段	类型	说明
code	integer	业务状态码（0表示成功）
msg	string	提示信息（成功时为空）
data	object	业务数据，键为SKU名称，值为该SKU在各区域的价格信息

data对象字段

字段	类型	说明
sku	string	商品SKU
price	array	区域价格列表

price数组字段

字段	类型	说明
delivery_region_id	integer	发货区域ID
delivery_region_name	string	发货区域名称
price	integer	价格

调用示例

URL请求

请求示例

{
    "skus": [
        "DE-I03-0028-01",
        "EEA02-A142-4-YE1",
        "EEA02-A143-20-VT1",
        "cbsft114yy02-一盒12pcs"
    ],
    "region_codes": [
        "CN",
        "TG"
    ],
    "customer_id": 10449
}

成功返回示例

{
    "code": 0,
    "msg": "",
    "data": {
        "DE-I03-0028-01": {
            "sku": "DE-I03-0028-01",
            "price": [
                {
                    "delivery_region_id": 5,
                    "delivery_region_name": "中国",
                    "price": 10
                }
            ]
        },
        "EEA02-A142-4-YE1": {
            "sku": "EEA02-A142-4-YE1",
            "price": [
                {
                    "delivery_region_id": 5,
                    "delivery_region_name": "中国",
                    "price": 8
                }
            ]
        },
        "EEA02-A143-20-VT1": {
            "sku": "EEA02-A143-20-VT1",
            "price": [
                {
                    "delivery_region_id": 5,
                    "delivery_region_name": "中国",
                    "price": 5
                }
            ]
        },
        "cbsft114yy02-一盒12pcs": {
            "sku": "cbsft114yy02-一盒12pcs",
            "price": [
                {
                    "delivery_region_id": 5,
                    "delivery_region_name": "中国",
                    "price": 5
                }
            ]
        }
    }
}

失败返回示例

{
    "code": 3,
    "msg": "授权无效 authorization timestamp error",
    "data": []
}

错误处理

公共错误码

HTTP status code	错误码	错误信息	描述

常见问题

Q1：如果某个SKU在指定的国家/地区没有价格信息，会返回什么？

A：如果某个SKU在指定国家/地区没有价格信息，该SKU可能不会出现在返回结果中，或其price数组为空。

Q2：一次可以查询多少个SKU和国家/地区？

A：目前未明确限制单次查询的SKU和国家/地区数量，但建议合理控制数量以保证接口响应效率。

版本历史

版本	日期	修改说明
v1.0	2025-01-01	初始版本

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "code": 0,
    "msg": "",
    "data": {
        "DE-I03-0028-01": {
            "sku": "DE-I03-0028-01",
            "price": [
                {
                    "delivery_region_id": 5,
                    "delivery_region_name": "中国",
                    "price": 33
                }
            ]
        },
        "EEA02-A142-4-YE1": {
            "sku": "EEA02-A142-4-YE1",
            "price": [
                {
                    "delivery_region_id": 5,
                    "delivery_region_name": "中国",
                    "price": 8
                }
            ]
        },
        "EEA02-A143-20-VT1": {
            "sku": "EEA02-A143-20-VT1",
            "price": [
                {
                    "delivery_region_id": 5,
                    "delivery_region_name": "中国",
                    "price": 8
                }
            ]
        },
        "cbsft114yy02-一盒12pcs": {
            "sku": "cbsft114yy02-一盒12pcs",
            "price": [
                {
                    "delivery_region_id": 5,
                    "delivery_region_name": "中国",
                    "price": 5
                }
            ]
        }
    }
}

SKU查询客户价格

SKU查询客户价格接口#

适用场景#

接口类型#

请求频率限制#

请求说明#

请求参数#

Header参数#

Body参数#

响应字段说明#

调用示例#

URL请求#

请求示例#

成功返回示例#

失败返回示例#

错误处理#

常见问题#

Q1：如果某个SKU在指定的国家/地区没有价格信息，会返回什么？#

Q2：一次可以查询多少个SKU和国家/地区？#

版本历史#

请求参数

请求示例代码

返回响应

SKU查询客户价格接口

适用场景

接口类型

请求频率限制

请求说明

请求参数

Header参数

Body参数

响应字段说明

调用示例

URL请求

请求示例

成功返回示例

失败返回示例

错误处理

常见问题

Q1：如果某个SKU在指定的国家/地区没有价格信息，会返回什么？

Q2：一次可以查询多少个SKU和国家/地区？

版本历史