编辑自主下单
自主下单
的订单信息只需要变更
的参数,不变更的参数请不要传递POST https://qw-openapi-tx.dustess.com/order/open-api/v1/batchUpdateIndependentOrder?accessToken=
Content-Type: application/json
参数名 | 类型 | 说明 | 是否必须 |
---|---|---|---|
orderList | Object[] | true | |
orderId | String | 订单id,和订单编号二选一传递。示例:bbd6f6a9-8e81-45fc-9b5d-9bbfab8daf46 | true |
orderNumber | String | 订单编号,和订单id二选一传递。示例:467117959325523968 | true |
followUserId | String | 订单业绩归属员工id,指尘锋员工uid | false |
followDepId | String | 订单业绩归属部门id,指组织架构部门id | false |
businessRemark | String | 卖家备注信息,最大支持200个字符 | false |
customFields | Object[] | 订单自定义字段信息,请传递字段id+对应字段类型的key | false |
customFields.id | String | 字段id | true |
customFields.numVal | Int | 数字类型的字段使用此key传递 | false |
customFields.strVal | String | 用于date、 dateTime、single、multi、radio、select、attachment,这些类型下该值必填 | false |
customFields.valType | String | 字段类型枚举值 | true |
customFields.aryVal | String[] | 用于checkbox | false |
customFields.cascadingValue | Object | 多级下拉框 | false |
customFields.cascadingValue.key | String | 下拉框字段的id,多级以"/"分割,示例:一级id/二级id/三级id | true |
customFields.cascadingValue.value | String | 下拉框字段的名称,多级以"/"分割,和id对应,示例:一级字段名称/二级字段名称/三级字段名称 | true |
json
- Request-Example:{
"orderList": [
{
"customFields": [
{
"id": "7de3ddd7-f3b1-11ec-8717-ba99a39320bd",
"numVal": 0,
"strVal": "2023-09-28 00:00:04",
"valType": "dateTime",
"aryVal": [],
"cascadingValue": {}
},
{
"id": "dd2ad990-32e7-4584-9043-7b0b5ad79fd5",
"numVal": 0,
"strVal": "2023-09-28",
"valType": "date",
"aryVal": [],
"cascadingValue": {}
},
{
"id": "2f2431f8-1e94-4ea5-981c-a103de6231ef",
"numVal": 0,
"strVal": "",
"valType": "checkbox",
"aryVal": [
"多云"
],
"cascadingValue": null
},
{
"id": "5add5339-603e-4874-9c9a-11c6562777dc",
"numVal": 12,
"strVal": "",
"valType": "number",
"aryVal": [],
"cascadingValue": null
},
{
"id": "f12429a6-4cbc-41e9-91ca-ee0583fda7d2",
"numVal": 0,
"strVal": "123456",
"valType": "multi",
"aryVal": [],
"cascadingValue": {}
},
{
"id": "4a0abb4a-20f4-4d6b-8158-2a0c1038558a",
"numVal": 0,
"strVal": "外语",
"valType": "radio",
"aryVal": [],
"cascadingValue": {}
},
{
"id": "da84696f-802b-4881-a719-f6ea57204aa9",
"numVal": 0,
"strVal": "",
"valType": "cascade",
"aryVal": [],
"cascadingValue": {
"key": "f2968792-bf83-4ac3-8012-689bbe125556/527b938e-a383-4f11-b459-bfbf6932e146/1893f011-a637-4c77-94d4-d07125212e03/e442bc32-ca09-419e-b2f1-879d55e6c665/c141858d-f213-4a06-99ea-4b385d016d65",
"value": "成都/锦江区/锦华路/晨辉社区/金象"
}
},
{
"id": "614c203e-e09d-4664-bf28-464f1bd337c2",
"numVal": 1234,
"strVal": "",
"valType": "number",
"aryVal": [],
"cascadingValue": null
},
{
"id": "8bb5f6c8-f539-419b-82b5-f20cc1d2c51e",
"numVal": 0,
"strVal": "",
"valType": "checkbox",
"aryVal": [
"aaa"
],
"cascadingValue": null
},
{
"id": "c838a1c3-52ff-4af6-b8d4-29787860f010",
"numVal": 0,
"strVal": "2023-09-20",
"valType": "date",
"aryVal": [],
"cascadingValue": {}
}
],
"orderNumber": "467117959325523968",
"businessRemark": "这里是卖家备注123",
"orderId": "bbd6f6a9-8e81-45fc-9b5d-9bbfab8daf46"
},
{
"customFields": [
{
"id": "7de3ddd7-f3b1-113ec-87127-ba99a39320bd",
"numVal": 0,
"strVal": "2023-09-28 00:00:04",
"valType": "dateTime",
"aryVal": [],
"cascadingValue": {}
},
{
"id": "dd2ad990-32e7-4584-9043-7b0b5ad79fd5",
"numVal": 0,
"strVal": "2023-09-28",
"valType": "date",
"aryVal": [],
"cascadingValue": {}
},
{
"id": "2f2431f8-1e94-4ea5-981c-a103de6231ef",
"numVal": 0,
"strVal": "",
"valType": "checkbox",
"aryVal": [
"多云"
],
"cascadingValue": null
},
{
"id": "5add5339-603e-4874-9c9a-11c6562777dc",
"numVal": 12,
"strVal": "",
"valType": "number",
"aryVal": [],
"cascadingValue": null
},
{
"id": "f12429a6-4cbc-41e9-91ca-ee0583fda7d2",
"numVal": 0,
"strVal": "123456",
"valType": "multi",
"aryVal": [],
"cascadingValue": {}
},
{
"id": "4a0abb4a-20f4-4d6b-8158-2a0c1038558a",
"numVal": 0,
"strVal": "外语",
"valType": "radio",
"aryVal": [],
"cascadingValue": {}
},
{
"id": "da84696f-802b-4881-a719-f6ea57204aa9",
"numVal": 0,
"strVal": "",
"valType": "cascade",
"aryVal": [],
"cascadingValue": {
"key": "f2968792-bf83-4ac3-8012-689bbe125556/527b938e-a383-4f11-b459-bfbf6932e146/1893f011-a637-4c77-94d4-d07125212e03/e442bc32-ca09-419e-b2f1-879d55e6c665/c141858d-f213-4a06-99ea-4b385d016d65",
"value": "成都/锦江区/锦华路/晨辉社区/金象"
}
},
{
"id": "614c203e-e09d-4664-bf28-464f1bd337c2",
"numVal": 1234,
"strVal": "",
"valType": "number",
"aryVal": [],
"cascadingValue": null
},
{
"id": "8bb5f6c8-f539-419b-82b5-f20cc1d2c51e",
"numVal": 0,
"strVal": "",
"valType": "checkbox",
"aryVal": [
"aaa"
],
"cascadingValue": null
},
{
"id": "c838a1c3-52ff-4af6-b8d4-29787860f010",
"numVal": 0,
"strVal": "2023-09-20",
"valType": "date",
"aryVal": [],
"cascadingValue": {}
}
],
"orderNumber": "4671179592298068480",
"businessRemark": "这里是卖家备注123",
"followUserId": "706",
"followDepId": "278",
"orderId": ""
}
]
}
参数名 | 类型 | 说明 |
---|---|---|
success | Bool | 请求成功失败标识 |
code | Int | 响应码 |
msg | String | 响应信息 |
trace_id | String | 上下文链路id |
data | Object | 数据信息 |
data.success | Object[] | 处理成功的订单列表 |
data.success.code | Int | 业务响应码 |
data.success.index | Int | 数据角标,与传入的顺序一致,起始值为0 |
data.success.msg | String | 业务响应信息 |
data.success.orderId | String | 订单id |
data.success.orderNumber | String | 订单编号 |
data.fail | Object[] | 处理失败的订单列表 |
data.fail.code | Int | 业务响应码 |
data.fail.index | Int | 数据角标,与传入的顺序一致,起始值为0 |
data.fail.msg | String | 业务响应信息 |
data.fail.orderId | String | 订单id |
data.fail.orderNumber | String | 订单编号 |
json
- Response-Example:{
"code": 0,
"data": {
"fail": [
{
"code": 50013175,
"index": 1,
"msg": "50013175|订单类型校验不通过,非自主下单",
"orderId": "56afcb34-758f-4de6-8245-6491f1c67674",
"orderNumber": "1704202393014423552"
}
],
"success": [
{
"code": 500200,
"index": 0,
"msg": "ok",
"orderId": "bbd6f6a9-8e81-45fc-9b5d-9bbfab8daf46",
"orderNumber": "467117959325523968"
}
]
},
"msg": "OK",
"success": true,
"traceId": "e09da74c-406a-950b-8747-e06cc19d0f54"
}
修改于 2024-09-20 10:09:47