1. 商品
西之月开放接口(openapi)
  • 西之月开放平台介绍
  • 西之月接入流程
  • 西之月开放API
  • 西之月订阅通知
  • 公共错误码
  • 货盘页面接入说明
  • openapi
    • 商品
      • 📖商品能力
      • SKU
        • SKU列表
        • SKU信息
        • SKU信息及价格
        • SKU查询客户价格
        • SKU查询英代欧代美代协议
        • SKU一体化标签
        • SKU一体化标签平台
        • SKU证书
        • SKU六面图
        • SKU商品图包
        • SKU视频
        • SKU商品标签【国内】
        • SKU产品文案
        • SKU实拍图附带一体化标签
        • SKU图包资料
      • 库存
        • 商品总库存列表
        • 商品分仓库存列表
        • 指定商品分仓库存
        • 圈货、备货库存查询
        • SKU实时库存【国内】
      • 商品列表
        GET
      • 商品详情
        GET
      • 商品价格
        POST
      • 个性化商品价格列表
        POST
      • 商品所有档位价格
        POST
      • 商品分类
        GET
      • 商品分类-获取子分类
        GET
      • 商品品牌
        GET
      • 商品证书
        GET
      • 商品使用说明书
        GET
    • 订单
      • 📖订单能力
      • 交接单
        • 交接单列表
        • 验证订单允许上传交接单
        • 上传交接单文件
        • 保存交接单
      • 创建订单
      • 订单预计算
      • 订单列表
      • 订单详情
      • 订单详情列表
      • 订单取消
      • 订单状态
      • 订单支付状态
      • 订单物流轨迹
    • 支付
      • 📖支付能力
      • 订单支付页面
      • 发起支付
      • 获取支付方式
      • 获取订单支付信息
    • 售后
      • 📖售后能力
      • 获取发起售后配置数据
      • 订单发起售后
      • 撤销售后
    • 账期
      • 📖账期能力
      • 已结清账期-账单列表
      • 未结清账期-账单列表
      • 未结清账单-销售订单列表
      • 未结清账单-售后订单列表
    • 品牌授权
      • 📖品牌授权能力
      • 获取授权平台列表
      • 获取模板类型列表
      • 获取授权品牌列表
      • 获取执照列表信息
      • 品牌授权申请
      • 品牌授权记录
      • 品牌授权作废
    • 其他
      • 📖其它能力
      • 仓库
        • 仓库列表信息
        • 发货区域列表
      • 物流
        • 物流公司列表
        • 获取运费接口
      • 平台
        • 获取授权码
        • 平台列表信息-新
        • 平台列表信息
      • 用户
        • 根据token获取用户信息
    • 订阅通知
      • 商品信息变更
      • 商品上下架状态变更
      • 商品库存变更
      • 商品价格变更
      • 商品删除
  1. 商品

个性化商品价格列表

外部-测试环境
https://testing.westmonth.com
外部-测试环境
https://testing.westmonth.com
POST
/openapi/product/priceListProvide

个性化商品价格列表接口#

提供个性化获取商品价格列表的能力,支持为不同商品指定各自的发货区域和数量,从而精准查询对应的价格信息,包括各类价格、币种、折扣等内容。

适用场景#

针对不同商品需指定不同发货区域和数量时,查询其价格列表

接口类型#

POST

请求频率限制#

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

请求说明#

请求URL
正式环境:https://www.westmonth.com/openapi/product/priceListProvide
测试环境:https://testing.westmonth.com/openapi/product/priceListProvide

请求参数#

Header参数#

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

Body参数#

根 字段
参数名类型必填默认值可选值说明
skusarray是--商品信息集合,包含各商品的发货区域、SKU和数量
uIDstring否--客户UID(ERP必填)
skus数组 字段
参数名类型必填默认值可选值说明
delivery_region_idinteger是--发货区域id
product_skustring是--商品SKU
quantityinteger是--商品数量

响应字段说明#

成功响应(HTTP 200)
根 字段
字段类型说明
codeinteger业务状态码(0表示成功,1表示失败等)
msgstring提示信息(成功时为空)
dataarray业务数据,数组元素为不同发货区域的商品价格信息集合
data数组 字段
字段类型说明
delivery_region_idinteger发货区域id
skusarray该发货区域下的商品信息集合
skus数组 字段
字段类型说明
sku_codestring商品SKU
sku_infoarray商品价格详细信息集合
sku_info数组 字段
字段类型说明
service_typeinteger价格类型(1=包邮价,2=不包邮价)
quantityinteger商品数量
price_discountstring折扣比例(0~1)
original_price_cnystring商品原价(人民币)
price_cnystring商品单价(人民币)
price_total_cnystring商品总价(人民币)
original_pricestring商品原价(区域币种)
pricestring商品单价(区域币种)
price_totalstring商品总价(区域币种)
price_currencystring区域币种
currency_symbolstring币种符号

调用示例#

URL请求#

请求示例#

{
    "skus": [
        {
            "delivery_region_id": 5,
            "product_sku": "DE-B10-0081-01",
            "quantity": 1
        },
        {
            "delivery_region_id": 3,
            "product_sku": "OEM-005389",
            "quantity": 10
        }
    ],
    "uID": "WM202405271201537338"
}

成功返回示例#

{
    "code": 0,
    "msg": "",
    "data": [
        {
            "delivery_region_id": 5,
            "skus": [
                {
                    "sku_code": "DE-B10-0081-01",
                    "sku_info": [
                        {
                            "service_type": 1,
                            "quantity": 1,
                            "price_discount": 1,
                            "original_price_cny": "15.00",
                            "price_cny": "15.00",
                            "price_total_cny": "15.00",
                            "original_price": "15.00",
                            "price": "15.00",
                            "price_total": "15.00",
                            "price_currency": "CNY",
                            "currency_symbol": "¥"
                        },
                        {
                            "service_type": 2,
                            "quantity": 1,
                            "price_discount": 1,
                            "original_price_cny": "15.00",
                            "price_cny": "15.00",
                            "price_total_cny": "15.00",
                            "original_price": "15.00",
                            "price": "15.00",
                            "price_total": "15.00",
                            "price_currency": "CNY",
                            "currency_symbol": "¥"
                        }
                    ]
                }
            ]
        },
        {
            "delivery_region_id": 3,
            "skus": [
                {
                    "sku_code": "OEM-005389",
                    "sku_info": []
                }
            ]
        }
    ]
}

失败返回示例#

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

错误处理#

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

常见问题#

版本历史#

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

请求参数

Header 参数

Body 参数application/json

示例
{
	"skus":[
		{
			"delivery_region_id":5,
			"product_sku":"DE-B10-0081-01",
			"quantity":1
		},
		{
			"delivery_region_id":3,
			"product_sku":"OEM-005389",
			"quantity":10
		}
	],
	"uID":"WM202405271201537338"
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://testing.westmonth.com/openapi/product/priceListProvide' \
--header 'Authorization: {{token}}' \
--header 'Cookie: {{cookie}};{{cookie}}' \
--header 'Content-Type: application/json' \
--data '{
	"skus":[
		{
			"delivery_region_id":5,
			"product_sku":"DE-B10-0081-01",
			"quantity":1
		},
		{
			"delivery_region_id":3,
			"product_sku":"OEM-005389",
			"quantity":10
		}
	],
	"uID":"WM202405271201537338"
}'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{
    "code": 0,
    "msg": "",
    "data": [
        {
            "delivery_region_id": 5,
            "skus": [
                {
                    "sku_code": "DE-B10-0081-01",
                    "sku_info": [
                        {
                            "service_type": 1,
                            "quantity": 1,
                            "price_discount": "0.97",
                            "original_price_cny": "21.57",
                            "price_cny": "20.93",
                            "price_total_cny": "20.93",
                            "original_price": "3.00",
                            "price": "2.91",
                            "price_total": "2.91",
                            "price_currency": "USD",
                            "currency_symbol": "$"
                        },
                        {
                            "service_type": 2,
                            "quantity": 1,
                            "price_discount": "0.97",
                            "original_price_cny": "21.57",
                            "price_cny": "20.93",
                            "price_total_cny": "20.93",
                            "original_price": "3.00",
                            "price": "2.91",
                            "price_total": "2.91",
                            "price_currency": "USD",
                            "currency_symbol": "$"
                        }
                    ]
                },
                {
                    "sku_code": "OEM-005389",
                    "sku_info": [
                        {
                            "service_type": 1,
                            "quantity": 1,
                            "price_discount": "0.97",
                            "original_price_cny": "21.57",
                            "price_cny": "20.93",
                            "price_total_cny": "20.93",
                            "original_price": "3.00",
                            "price": "2.91",
                            "price_total": "2.91",
                            "price_currency": "USD",
                            "currency_symbol": "$"
                        },
                        {
                            "service_type": 2,
                            "quantity": 1,
                            "price_discount": "0.97",
                            "original_price_cny": "21.57",
                            "price_cny": "20.93",
                            "price_total_cny": "20.93",
                            "original_price": "3.00",
                            "price": "2.91",
                            "price_total": "2.91",
                            "price_currency": "USD",
                            "currency_symbol": "$"
                        }
                    ]
                }
            ]
        },
        {
            "delivery_region_id": 3,
            "skus": [
                {
                    "sku_code": "DE-B10-0081-01",
                    "sku_info": [
                        {
                            "service_type": 1,
                            "quantity": 1,
                            "price_discount": "0.97",
                            "original_price_cny": "21.57",
                            "price_cny": "20.93",
                            "price_total_cny": "20.93",
                            "original_price": "3.00",
                            "price": "2.91",
                            "price_total": "2.91",
                            "price_currency": "USD",
                            "currency_symbol": "$"
                        },
                        {
                            "service_type": 2,
                            "quantity": 1,
                            "price_discount": "0.97",
                            "original_price_cny": "21.57",
                            "price_cny": "20.93",
                            "price_total_cny": "20.93",
                            "original_price": "3.00",
                            "price": "2.91",
                            "price_total": "2.91",
                            "price_currency": "USD",
                            "currency_symbol": "$"
                        }
                    ]
                },
                {
                    "sku_code": "OEM-005389",
                    "sku_info": [
                        {
                            "service_type": 1,
                            "quantity": 1,
                            "price_discount": "0.97",
                            "original_price_cny": "21.57",
                            "price_cny": "20.93",
                            "price_total_cny": "20.93",
                            "original_price": "3.00",
                            "price": "2.91",
                            "price_total": "2.91",
                            "price_currency": "USD",
                            "currency_symbol": "$"
                        },
                        {
                            "service_type": 2,
                            "quantity": 1,
                            "price_discount": "0.97",
                            "original_price_cny": "21.57",
                            "price_cny": "20.93",
                            "price_total_cny": "20.93",
                            "original_price": "3.00",
                            "price": "2.91",
                            "price_total": "2.91",
                            "price_currency": "USD",
                            "currency_symbol": "$"
                        }
                    ]
                }
            ]
        }
    ]
}
修改于 2026-02-24 03:17:57
上一页
商品价格
下一页
商品所有档位价格
Built with