修改代客下单
描述
修改已创建的代客下单,可用于调整金额、结算信息或场景采集数据。
路径
/optimus/module/open/preOrder/modifyPreOrder
入参说明(JSON 格式)
入参整体结构
| 参数 | 参数名称 | 类型 | 是否必传 | 描述 | 示例 |
|---|---|---|---|---|---|
| appid | 应用id | String | Y | 固定值 | 见测试参数 |
| mallID | 商城信息 | Object | Y | 固定值 | 见测试参数 |
| seller | 用户信息 | Object | Y | 固定值 | 见测试参数 |
| preOrderId | 预下单id | String | Y | 创建代客下单 时返回 | |
| amount | 金额信息 | Object | Y | ||
| checkout | 结算信息 | Object | Y | ||
| scenes | 场景信息 | Object | N | 结构见 创建代客下单 |
入参字段结构
mallID 字段明细
| 参数 | 参数名称 | 类型 | 是否必传 | 描述 | 示例 |
|---|---|---|---|---|---|
| mallSn | 商城ID | String | Y | 固定值 | 见测试参数 |
| signature | 商城签名 | String | Y | 固定值 | 见测试参数 |
seller 字段明细
| 参数 | 参数名称 | 类型 | 是否必传 | 描述 | 示例 |
|---|---|---|---|---|---|
| merchantId | 商户Id | String | Y | 固定值 | 见测试参数 |
| merchantUserId | 商户userId | String | Y | 固定值 | 见测试参数 |
| role | 角色 | String | Y | 固定值 | 见测试参数 |
amount 字段明细
| 参数 | 参数名称 | 类型 | 是否必传 | 描述 | 示例 |
|---|---|---|---|---|---|
| oriAmount | 原金额 | Long | Y | 10 | |
| discAmount | 实际金额 | Long | N | 5 |
checkout 字段明细
| 参数 | 参数名称 | 类型 | 是否必传 | 描述 | 示例 |
|---|---|---|---|---|---|
| type | 结算类型 | Byte | Y | 1 商品;2 金额 | |
| items | 结算商品信息 | List\ | N |
checkout.items 字段明细
| 参数 | 参数名称 | 类型 | 是否必传 | 描述 | 示例 |
|---|---|---|---|---|---|
| spuId | 商品spu | String | Y | ||
| skuId | 商品sku | String | Y | ||
| unit | 商品单位 | String | N | 件 | |
| quantity | 商品数量 | String | Y | ||
| type | 商品类型 | Byte | N | 自定义商品类型为:1 | 1 |
| title | 商品名称 | String | N | 自定义商品标题 | 自定义商品 |
| price | 商品价格 | Long | N | 自定义商品价格,单位:分 | 100 |
| image | 商品图片 | String | N | 自定义商品图片地址 |
出参说明(JSON 格式)
出参整体结构
| 参数 | 参数名称 | 类型 | 描述 | 示例 |
|---|---|---|---|---|
| success | 请求状态 | Boolean | true:成功;false:失败 | TRUE |
| code | 状态码 | String | 0000:成功;其他为异常码 | "0000" |
| msg | 状态描述 | String | 请求结果的描述信息 | "处理成功" |
| data | 订单数据 | Void | 结果数据 |
示例
{
"appid": "2025082700005615",
"seller": {
"merchantId": "2fb8469f-6d28-4bc8-8201-ff57dff86e3f",
"merchantUserId": "6155adc6-68b5-4bad-b95b-2b44521171ea",
"role": "super_admin"
},
"mallID": {
"mallSn": "2025111310042834933",
"signature": "xCLJhkXbL6o2WGPAkT6n"
},
"source": 2,
"amount": {
"oriAmount": 1
},
"checkout": {
"type": 2
},
"preOrderId": "m9DiFixXKOnIFOcMxR846a-UyxzGdBBpRNtYWRc5Crs="
}