修改订单

方向:青云聚信系统→配送商系统

用途:修改订单。请求参数只会传输发生修改的字段,未修改字段传输为空。

请求参数:

字段 描述 是否必填 类型 示例值 规则
orderId 青云聚信平台订单号 string 长度为18-45个字符。
可作为唯一识别单号,建议配送商作为商家订单号使用。
recipientName 收件人姓名 string
recipientPhone 收件人电话 string 最长不超过64个字符;
recipientAddress 收件人地址 string 最长不超过512个字符
recipientLng 收件人经度 int 火星坐标,坐标 * (10的六次方),如 116398419
recipientLat 收件人纬度 int 火星坐标,坐标 * (10的六次方),如 39985005
expectedDeliveryTime 收件人期望送达时间,建议将该时间展示给骑手 long 时间戳,格式为long,时区为GMT+8,即距离Epoch(1970年1月1日) 以秒计算的时间(unix-timestamp)。
orderRemark 订单备注,建议将该备注展示给骑手 string 最长不超过300个字符
shopRemark 商户备注,建议将该备注展示给骑手 string 最长不超过300个字符

返回参数:

字段 描述 是否必填 类型 示例值 规则
code 结果code int 0 0:成功。
非0:失败,详情查看message字段
详细枚举见 附录-接口返回结果Code
message 失败的描述信息 string 成功
data 结果 map {
 "orderId":"mtmp_1690263855201021483",
 "modifyFee":0,
 "predictDeliveryTime":1690265698,
 "deliveryDistance":1239
}
如果成功则需要传入

修改结果

字段 描述 是否必填 类型 示例值 规则
orderId 青云聚信平台订单号 string
modifyFee 修改补交金额 double 单位:元
若无需补交,可回传0。
predictDeliveryTime 预计送达时间 long 当修改收件地址、期望送达时间时,必填
时间戳,格式为long,时区为GMT+8,即距离Epoch(1970年1月1日) 以秒计算的时间(unix-timestamp)
deliveryDistance 配送距离 int 当修改收件地址时,必填
单位:米