# 修改订单价格
# 接口说明
可通过该接口修改订单价格。
# 注意事项
- 目前只支持改低价格, 暂时不支持改高价格;
- 每次修改价格时以每种商品(同一sku_id)为单位,定义该种商品的最新总价,如果某种商品在请求中不输入,则默认该商品的价格不修改;
- 订单在付款前可以进行最多不超过50次的修改价格操作,同一订单每次新的改价操作执行成功后之前所有的改价操作都将失效。
# 接口调用请求说明
POST https://api.weixin.qq.com/channels/ec/order/price/update?access_token=ACCESS_TOKEN
# 请求参数说明
参数 | 类型 | 是否必填 | 描述 |
---|---|---|---|
order_id | string | 是 | 订单id,可通过获取订单列表接口获取 |
change_express | bool | 是 | 是否修改运费 |
express_fee | number | 否 | 修改后的运费价格(change_express=true时必填),以分为单位 |
change_order_infos | array ChangeOrderInfo | 是 | 改价列表,具体可见结构体ChangeOrderInfo |
# 请求参数示例
{
"order_id": "123456",
"change_express": true,
"express_fee": 0,
"change_order_infos": [
{
"product_id": "1234",
"sku_id": "5678",
"change_price": 300
}
]
}
# 返回参数说明
参数 | 类型 | 描述 |
---|---|---|
errcode | number | 错误码 |
errmsg | string | 错误信息 |
# 返回参数示例
{
"errcode": 0,
"errmsg": "ok"
}
# 错误码
错误码 | 错误描述 |
---|---|
公共错误码 | - |
47001 | 请求体格式不正确,请检查请求体中各个参数的类型是否正确 |
40097 | 请求体参数不正确,请检查各个参数是否按规范填写,具体原因请查看errmsg |
101100 | 订单不是未付款订单,不能改价 |
108022 | 该订单改价次数已经超过50次 |
108021 | 某种商品或者运费修改后的价格超出原价 |
108023 | 修改后订单价格为0 |
100003 | 订单更新过于频繁,更新订单失败,请重试 |
# 结构体
# ChangeOrderInfo
改价列表
参数 | 类型 | 是否必填 | 描述 |
---|---|---|---|
product_id | string | 是 | 商品id |
sku_id | string | 是 | 商品sku |
change_price | number | 是 | 订单中该商品修改后的总价,以分为单位 |