跳到主要内容

修改订单商品信息

系统相关界面​

"界面路径:【订单管理】"

请求地址​

环境服务地址(HTTP/HTTPS)
V2正式环境(推荐)https://gw.superboss.cc/router
V2测试环境https://gw3.superboss.cc/router

2022年4月1日以后申请的APP Key,统一使用V2正式环境的请求地址:https://gw.superboss.cc/router

公共参数​

调用任何一个API都必须传入的参数,目前支持的公共参数有:

参数名称参数类型是否必须参数描述
methodstring是API接口名称
appKeystring是分配给应用的AppKey
timestampstring是时间戳,时区为GMT+8,例如:2020-09-21 16:58:00。API服务端允许客户端请求最大时间误差为10分钟
formatstring否响应格式。默认为json格式,可选值:json
versionstring是API协议版本 可选值:1.0
sign_methodstring否签名的摘要算法(默认 hmac),可选值为:hmac,md5,hmac-sha256。
signstring是签名
sessionstring是授权会话信息 (即access_token,由系统分配)

请求头​

全部展开
参数名
类型
描述
必填
Content-Type
string
application/x-www-form-urlencoded;charset=UTF-8
必填

API接口地址​

全部展开
参数名
类型
描述
必填
method
string
erp.trade.item.modify
必填

请求参数​

全部展开
参数名
类型
描述
必填
默认值
sid
long
系统订单号
是
orders
array
订单商品信息JSON数组字符串
是
id
long
订单商品ID
否
outerId
string
商家编码
是
price
string
单价
是
payment
string
成交金额
是
divideOrderFee
string
平台实付(平台分摊之后的实付金额)
否
num
int
数量(必须≥1)
是
orderRemark
string
订单商品备注(不能超过1024个字符)
否

请求示例​

{
"sid": 5058208293858409,
"orders": "[{\"outerId\":\"SKU001\",\"price\":\"10.00\",\"payment\":\"20.00\",\"num\":2,\"orderRemark\":\"备注信息\"}]"
}

响应参数​

全部展开
参数名
类型
描述
必填
success
boolean
是否成功
trace_id
string
链路追踪ID

响应示例​

{
"traceId": "3669319614952014527",
"success": true
}

异常示例​

{
"traceId": "4071991477422416710",
"msg": "系统订单号不能为空",
"code": "33",
"success": false
}