新增&编辑订单
`POST https://qw-openapi-tx.dustess.com/java-data-exchange-srv/api/order/v1/create-valet?accessToken=`
Content-Type: application/json
请求参数名 | 类型 | 说明 | 是否必须 |
---|---|---|---|
orderList | Object[] | 订单列表(最大50条数据) | true |
orderList.address | Object | 订单收货地址信息,购买虚拟商品不需要传,购买实物商品可以传 | false |
orderList.address.address | String | 详细地址 | false |
orderList.address.area | String | 区code省市区code码 | false |
orderList.address.areaName | String | 区名称 | false |
orderList.address.city | String | 市code | false |
orderList.address.cityName | String | 市名称 | false |
orderList.address.consignee | String | 收货人 | false |
orderList.address.mobile | String | 收货人手机号 | false |
orderList.address.province | String | 省code | false |
orderList.address.provinceName | String | 省名称 | false |
orderList.cname | String | 客户名称 | false |
orderList.creator | String | 订单创建人Id(代客下单->创建人=创建员工id) | true |
orderList.customFields | Object[] | 自定义字段数组 查询订单自定义字段ID | false |
orderList.customFields.id | String | 自定义字段Id | true |
orderList.customFields.aryVal | String[] | 数组类型值,默认值为:[] | false |
orderList.customFields.numVal | Int | 数字类型值,支持2位小数。默认值为:0 | true |
orderList.customFields.strVal | String | 字符串类型值,默认值为:空字符串"" | false |
orderList.customFields.valType | String | 自定义字段类型,valType=file自定义附件时,对应的资源id,放入aryVal | true |
orderList.customerId | String | 联系人Id (联系人Id、外部系统联系人Id、企业Id至少必传一)查询联系人 | false |
orderList.externalCustomerId | String | 外部系统联系人Id (联系人Id、外部系统联系人Id、企业Id至少必传一) | false |
orderList.corpId | String | 企业Id (联系人Id、外部系统联系人Id、企业Id至少必传一)查询企业列表 | false |
orderList.dealTime | String | 订单的下单时间,不能晚于当前时间,格式 yyyy-MM-dd HH:mm:ss | true |
orderList.depId | String | 业绩归属部门Id,即该订单业绩归属于哪个部门,部门id | true |
orderList.followUserId | String | 业绩归属人Id,即该订单业绩归属于哪个员工,员工id 查询员工信息 | true |
orderList.goods | Object[] | 商品数据 查询商品列表 | true |
orderList.goods.skuId | String | 商品SKU ID | true |
orderList.goods.number | Int | 商品数量 | true |
orderList.goods.amount | String | 该商品实付价格(总价,单位:元),最多两位小数,"1.01"元 | true |
orderList.isPay | Bool | 是否已经支付 | false |
orderList.isVerify | Bool | 是否校验起购数量:false 不校验,true 校验 | false |
orderList.note | String | 备注信息 | false |
orderList.orderId | String | 尘锋订单id(和外部订单id至少必传一个) | false |
orderList.outOrderNumber | String | 外部系统订单号(和尘锋订单id至少必传一个),如需修改订单的外部订单号,参考文档头部说明 | false |
orderList.payType | Int | 付款方式:1 线上付款;2 线下付款 | true |
orderList.source | Object | 订单来源 查询订单来源 | false |
orderList.source.shopName | String | 店铺名称 | false |
orderList.sourceCode | Int | 来源Code | false |
orderList.status | Int | 订单状态:10 待支付、 20 待发货、 40 待收货、 50 已完成、 70 已取消 | true |
orderList.vouch | Object[] | 订单凭证信息;已付款需上传凭证(最多10个) | false |
orderList.vouch.name | String | 资源名称 | false |
orderList.vouch.urlId | String | 资源通过接口上传后获取的Id 商品图片/视频上传 | false |
orderList.auditTime | String | 审核时间:格式 yyyy-MM-dd HH:mm:ss | false |
orderList.confirmReceiptTime | String | 确认收货时间:格式 yyyy-MM-dd HH:mm:ss | false |
orderList.deliveryTime | String | 发货时间:格式 yyyy-MM-dd HH:mm:ss | false |
orderList.payTime | String | 支付时间:格式 yyyy-MM-dd HH:mm:ss | false |
orderList.refundTime | String | 退款时间:格式 yyyy-MM-dd HH:mm:ss | false |
orderList.withoutShip | String | 是否需要发货 true 无需发货,false 需要 | false |
orderList.deliveryFee | String | 订单运费金额 (单位:元),最多2位小数,"1.01"元 | false |
{
"orderList": [{
"address": {
"address": "四川省成都市高新区天府二街",
"area": "50001",
"areaName": "成都",
"city": "111",
"cityName": "成都",
"consignee": "张嘿嘿",
"mobile": "18888888888",
"province": "028",
"provinceName": "四川省"
},
"auditTime": "2021-09-22 11:00:00",
"cname": "",
"confirmReceiptTime": "",
"creator": "1",
"customFields": [{
"aryVal": [],
"id": "field0",
"numVal": 0,
"strVal": "单选项值",
"valType": "radio"
},
{
"aryVal": [],
"id": "field2",
"numVal": 0,
"strVal": "多行文本",
"valType": "multi"
},
{
"aryVal": [],
"id": "field3",
"numVal": 0,
"strVal": "2023-05-15 14:49:39",
"valType": "dateTime"
},
{
"aryVal": [],
"id": "87417f2d-9de2-11ec-a395-3257353df390",
"numVal": 0,
"strVal": "单行文本",
"valType": "single"
},
{
"aryVal": [],
"id": "732d8347-b85a-491e-93aa-6f535591b91a",
"numVal": 2,
"strVal": "",
"valType": "number"
},
{
"aryVal": [],
"id": "a6caf6f0-cec0-409f-9214-3ac90251dd7c",
"numVal": 0,
"strVal": "2023-05-15",
"valType": "date"
},
{
"aryVal": [
"{\"key\":\"bbb270d5-bddc-4b19-b6ca-5f20a0b9a094/4ce816bc-e70a-464f-8ef3-21c8efe49ce8/ca874035-44c4-429a-ae76-42dd1d7b812a\",\"value\":\"电商渠道/京东商城/学生专区\"}"
],
"id": "12192654-fa89-4884-9735-6ee950a5135a",
"numVal": 0,
"strVal": "电商渠道/京东商城/学生专区",
"valType": "cascade"
}
],
"customerId": "xx",
"externalCustomerId": "xxx",
"corpId": "jj",
"dealTime": "",
"deliveryTime": "",
"depId": "12",
"followUserId": "1",
"goods": [{
"amount": "15.09",
"number": 3,
"skuId": "dsadas"
}],
"isPay": true,
"isVerify": true,
"note": "dasdas",
"orderId": "",
"outOrderNumber": "test001",
"payTime": "",
"payType": 1,
"refundTime": "",
"sourceCode": 1,
"status": 10,
"vouch": [],
"withoutShip": true,
"deliveryFee": ""
}]
}
响应参数名 | 类型 | 描述 |
---|---|---|
logMessageId | String | 调用链日志id |
msg | String | 消息 |
success | Bool | 是否成功 |
code | Int | 状态码,500200成功请求 |
data | Object | 数据 |
data
字段类型说明响应参数名 | 类型 | 描述 |
---|---|---|
failed | Object[] | 保存失败的记录 |
failed.code | Int | 请求失败时 状态码 |
failed.index | Int | 该记录在原数组的索引 |
failed.msg | String | 失败时:错误信息 |
failed.orderNumber | String | 失败时为空字符串 |
success | Object[] | 请求成功的记录 |
success.code | Int | 请求成功时 状态码500200 |
success.index | Int | 该记录在原数组的索引 |
success.msg | String | 成功时msg为"ok" |
success.orderNumber | String | 请求成功时,创建订单的OrderNumber(非外部订单号) |
{
"code": 500200,
"data": {
"failed": [],
"success": [
{
"code": 500200,
"index": 0,
"msg": "ok",
"orderNumber": "284273429434073088"
}
]
},
"logMessageId": "bb8cec1c-86ed-9407-9f57-1e2804062169",
"msg": "成功",
"reqid": "bb8cec1c-86ed-9407-9f57-1e2804062169",
"success": true
}
修改于 2024-12-17 01:34:34