销售订单相关

1、分页获取销售订单列表

**接口地址:/api/saleOrder/getSaleOrderListPage

content-type：application/json
method：post

传入参数

属性	类型	默认值	必填	说明
code	string		是	iot管理平台中获取到的code值
pageNum	string	1	否	当前页码值 默认为1
pageSize	string	10	否	一页多少条数据 默认为10
params	object		否	查询条件object

params内可以传入的查询参数:

属性	类型	说明
orderId	string	金蝶销售订单号
name	string	名称
phone	string	电话号码
startTime	date	创建时间 起始 格式：yyyy-MM-dd HH:mm:ss 起始时间和终止时间需要一起传入才会生效
endTime	date	创建时间 终止 格式：yyyy-MM-dd HH:mm:ss 起始时间和终止时间需要一起传入才会生效
status	int	审核状态 0：未审核 ，1：审核通过, 2:审核拒绝

请求示例

{
	"pageNum": 0,
	"pageSize": 0,
	"params": {
	},
	"code":""
}

返回值

属性	类型	说明
code	int	返回状态码
msg	string	返回消息
data	object	返回的数据

data内object数据

属性	类型	说明
total	int	总数据条数
data	list	返回的数据

data内list数据

属性	类型	说明
address	string	详细地址
city	string	市
createTime	date	创建时间
district	string	区
failReason	string	金蝶推送失败原因
id	string	订单id（本系统）
expressNumber	string	快递单号
kingdeeStatus	int	推送金蝶状态，0：同步成功 ，1：同步失败
name	string	客户姓名
orderId	string	订单ID(金蝶系统)
phone	string	手机号
province	string	省
reviewFailReason	string	审核失败原因
saleOrderDetails	list	订单详情
status	int	订单状态，0：未审核 ，1：审核通过, 2:审核拒绝
userId	string	订单所属用户id
provinceId	string	省id
cityId	string	市id
districtI	string	区id

saleOrderDetails内list数据

属性	类型	说明
qty	int	商品数量
productId	string	商品id
name	string	商品name
price	string	商品单价

响应示例

{
	"code": 0,
	"data": {
		"data": [
			{
				"address": "",
				"city": "",
				"cityId": "",
				"createTime": "",
				"district": "",
				"districtId": "",
				"expressNumber": "",
				"failReason": "",
				"id": "",
				"kingdeeStatus": 0,
				"merchantName": "",
				"name": "",
				"orderId": "",
				"phone": "",
				"province": "",
				"provinceId": "",
				"reviewFailReason": "",
				"saleOrderDetails": 
					{
						"name": "",
						"price": 0,
						"productId": "",
						"qty": 0
					}
				],
				"status": 0,
				"userId": ""
			}
		],
		"total": 0
	},
	"msg": ""
}

2、获取销售订单详情

**接口地址:/api/saleOrder/getSaleOrderInfo

content-type：application/json
method：post

传入参数

属性	类型	默认值	必填	说明
code	string		是	iot管理平台中获取到的code值
id	string		是	订单id（本系统）

请求示例

{
	"id": "",
	"code":""
}

返回值

属性	类型	说明
code	int	返回状态码
msg	string	返回消息
data	object	返回的数据

data内info数据

属性	类型	说明
address	string	详细地址
city	string	市
createTime	date	创建时间
district	string	区
failReason	string	金蝶推送失败原因
id	string	订单id（本系统）
kingdeeStatus	int	推送金蝶状态，0：同步成功 ，1：同步失败
name	string	客户姓名
expressNumber	string	快递单号
orderId	string	订单ID(金蝶系统)
phone	string	手机号
province	string	省
reviewFailReason	string	审核失败原因
saleOrderDetails	list	订单详情
status	int	订单状态，0：未审核 ，1：审核通过, 2:审核拒绝
userId	string	订单所属用户id
provinceId	string	省id
cityId	string	市id
districtI	string	区id

saleOrderDetails内list数据

属性	类型	说明
qty	int	商品数量
productId	string	商品id
deviceSnList	list	sn集合
name	string	商品name
price	string	商品单价

deviceSnList内List数据

属性	类型	说明
deviceSn	string	设备sn

响应示例

{
	"code": 0,
	"data": {
		
		"address": "",
		"city": "",
		"cityId": "",
		"createTime": "",
		"district": "",
		"districtId": "",
		"expressNumber": "",
		"failReason": "",
		"id": "",
		"kingdeeStatus": 0,
		"merchantName": "",
		"name": "",
		"orderId": "",
		"phone": "",
		"province": "",
		"provinceId": "",
		"reviewFailReason": "",
		"saleOrderDetails": [
			{
				"deviceSnList": [
					{
						"deviceSn": ""
					}
				],
				"name": "",
				"price": 0,
				"productId": "",
				"qty": 0
			}
		],
		"status": 0,
		"userId": ""
	},
	"msg": ""
}

3、添加销售订单

**接口地址:/api/saleOrder/addSaleOrder

content-type：application/json
method：post

传入参数

属性	类型	默认值	必填	说明
code	string		是	iot管理平台中获取到的code值
address	string		是	详细地址
city	string		是	市
cityId	string		是	市ID json中获取到的市id
district	string		是	区
districtId	string		是	区ID json中获取到的区id
name	string		是	客户姓名
phone	string		是	手机号
province	string		是	省
provinceId	string		是	省ID json中获取到的省id
saleOrderDetails	list		是	订单详情

saleOrderDetails内list数据

属性	类型	说明
qty	int	商品数量
productId	string	商品id

请求示例

{
	"address": "",
	"city": "",
	"cityId": "",
	"district": "",
	"districtId": "",
	"name": "",
	"phone": "",
	"province": "",
	"provinceId": "",
	"saleOrderDetails": [
		{
			"productId": "",
			"qty": 0
		}
	],
	"code": ""
}

返回值

属性	类型	说明
code	int	返回状态码
msg	string	返回消息
data	object	返回的数据

4、更新销售订单

**接口地址:/api/saleOrder/updateSaleOrder

**审核通过后不允许更新

content-type：application/json
method：post

传入参数

属性	类型	默认值	必填	说明
code	string		是	iot管理平台中获取到的code值
address	string		是	详细地址
city	string		是	市
cityId	string		是	市ID json中获取到的市id
district	string		是	区
districtId	string		是	区ID json中获取到的区id
name	string		是	客户姓名
id	long		是	订单id（本系统）
phone	string		是	手机号
province	string		是	省
provinceId	string		是	省ID json中获取到的省id
saleOrderDetails	list		是	订单详情

saleOrderDetails内list数据

属性	类型	说明
qty	int	商品数量
productId	string	商品id

请求示例

{
	"address": "",
	"city": "",
	"cityId": "",
	"district": "",
	"districtId": "",
	"name": "",
        "id": 0,
	"phone": "",
	"province": "",
	"provinceId": "",
	"saleOrderDetails": [
		{
			"productId": "",
			"qty": 0
		}
	],
	"code": ""
}

返回值

属性	类型	说明
code	int	返回状态码
msg	string	返回消息
data	object	返回的数据

5、删除销售订单

**接口地址:/api/saleOrder/deleteSaleOrder

**审核通过后不允许删除

content-type：application/json
method：post

传入参数

属性	类型	默认值	必填	说明
code	string		是	iot管理平台中获取到的code值
id	long		是	订单id（本系统）

请求示例

{
        "id": 0,
	"code": ""
}

返回值

属性	类型	说明
code	int	返回状态码
msg	string	返回消息
data	object	返回的数据

6、获取商品信息列表

**接口地址:/api/saleOrder/getMaterialList

content-type：application/json
method：post

传入参数

属性	类型	默认值	必填	说明
code	string		是	iot管理平台中获取到的code值

请求示例

{
	"code":""
}

返回值

属性	类型	说明
code	int	返回状态码
msg	string	返回消息
data	list	返回的数据

data内list数据

属性	类型	说明
productId	string	商品id
name	string	商品name
price	string	商品单价

响应示例

{
	"code": 0,
	"data": [
		{
			"name": "",
			"price": 0,
			"productId": ""
		}
	],
	"msg": ""
}