方向:青云聚信系统→配送商系统
用途:修改订单。请求参数只会传输发生修改的字段,未修改字段传输为空。
请求参数:
字段 | 描述 | 是否必填 | 类型 | 示例值 | 规则 |
---|---|---|---|---|---|
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 |
当修改收件地址时,必填 单位:米 |