新增&编辑订单 - 尘锋SCRM开放平台

编辑订单时，需要传入全量订单数据，暂不支持编辑部分订单信息

导入订单会以“代客下单”类型存在系统中，导入成功后，会根据当前订单状态发送消息通知对应员工

订单核心元素（订单必备内容）

购买人为关联联系人（或企业）、业绩归属员工、业绩归属部门、订单创建人、商品(skuList)

商品说明

一个商品(goods)支持创建多个规格(sku)

商品库支持通过接口维护新增商品

商品库也支持通过尘锋管理后台维护，操作路径为："交易-商品-商品列表"

商品分为虚拟商品和实物商品，虚拟商品无需发货，不需要填写收货地址，实物商品必须填写收货地址省市区code码

不支持导入订单时自动创建商品

业绩归属人、归属部门等，与系统的业绩目标功能有关联查询员工信息

当传入的orderId 或 outOrderNumber 已在系统中存在时，将进行修改操作

如果需要修改某订单所关联的outOrderNumber，请求参数需要同时携带orderId、新的outOrderNumber

订单来源说明

代客下单为自定义来源：请先在尘锋管理后台维护来源库，操作路径为"交易-店铺设置-店铺设置-订单设置-订单来源设置",再通过接口获取枚举值查询订单来源

订单自定义字段说明

如预设字段未能满足您的需求，可使用自定义字段存储个性化信息，请先在尘锋管理后台维护字段数据，操作路径为"交易-店铺-店铺设置-订单设置-订单自定义字段设置",再通过接口获取枚举值查询订单自定义字段ID

`POST https://qw-openapi-tx.dustess.com/java-data-exchange-srv/api/order/v1/create-valet?accessToken=`

Content-Type: application/json

接口限制：每分钟调用600次；单次最多导入50条；

请求参数

请求参数名	类型	说明	是否必须
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
}