订单工单查询
API列表
编号 | API名称 | 路径 | 版本 |
---|---|---|---|
1.1 | 工单列表(分页、模糊搜索) | /activiti/bizPlatform/txOrder/list | 1.0 |
1.2 | 工单流程记录 | /activiti/bizPlatform/txOrder/record/{orderNo} | 1.0 |
1.3 | 工单状态信息 | /activiti/bizPlatform/txOrder/stateInfo/{orderNo} | 1.0 |
1.4 | 查看工单详情 | /activiti/bizPlatform/txOrder/get/{orderNo} | 1.0 |
1.5 | 业务单列表(分页、模糊搜索) | /activiti/bizPlatform/txOrder/business/list | 1.0 |
API调用
1、工单查询
1.1: 工单列表(分页、模糊搜索)
请求信息
HTTP协议:HTTP,HTTPS
uri:/activiti/bizPlatform/txOrder/list
HTTP头: bizToken
方法:POST/JSON
请求参数
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
pageNo | Integer | 是 | 页码 |
pageSize | Integer | 是 | 每页的条数 |
condition | Object | 是 | 查询条件封装 |
condition.txOrderId | String | 否 | 天选商城订单id |
condition.keyWord | String | 否 | 工单编码/业主姓名/手机号码 |
请求示例
{
"pageNo": 1,
"pageSize": 10,
"condition": {
"txOrderId": "1"
}
}
返回参数类型
JSON
返回参数
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
id | Long | 是 | 主键ID |
businessNo | String | 是 | 业务单编码 |
orderNo | String | 是 | 工单编码 |
expressNo | String | 是 | 快递/物流单号 |
assignStatus | String | 是 | 指派状态 |
ownerNo | String | 是 | 业主编码 |
ownerName | String | 是 | 业主姓名 |
mobile | String | 是 | 手机号码 |
address | String | 是 | 地址 |
merName | String | 是 | 地址组合名(匹配服务商地址) |
regionCode | String | 是 | 最后一级区域编码 |
processInstanceId | String | 是 | 流程实例ID |
processKey | String | 是 | 流程定义KEY |
statusId | Integer | 是 | 工单状态id |
orderStatus | String | 是 | 工单状态 |
serviceCode | String | 是 | 服务编码 |
serviceProductName | String | 是 | 服务产品名称 |
standardsName | String | 是 | 产品规格 |
serviceType | String | 是 | 服务类型 |
requiredFinishNum | String | 是 | 应完工数量 |
actualFinishNum | String | 是 | 实际完工数量 |
adjustFee | BigDecimal | 是 | 调节金额 |
finalFee | BigDecimal | 是 | 最终结算金额 |
adjustReason | String | 是 | 调节原因 |
sideAcount | String | 是 | 承接网点账号 |
sideName | String | 是 | 承接网点名称 |
engineerAcount | String | 是 | 承接工程师账号 |
engineerName | String | 是 | 承接工程师名称 |
releaseTime | Date | 是 | 发布时间 |
expectedServiceTime | Date | 是 | 期望上门时间 |
appointmentTime | String | 是 | 预约时间 |
finishTime | Date | 是 | 工单完成时间 |
time | String | 是 | 时间段 |
remark | String | 是 | 备注 |
pauseReason | String | 是 | 挂起原因 |
cancelReason | String | 是 | 取消理由 |
cancelDetail | String | 是 | 取消详细说明 |
ownerMsg | String | 是 | 业主留言 |
isDelete | Integer | 是 | 是否删除(0-是;1-否) |
isIntact | Integer | 是 | 外观是否完好(0-受损;1-完好) |
creater | String | 是 | 创建人 |
createTime | Date | 是 | 创建时间 |
updater | String | 是 | 更新人 |
updateTime | Date | 是 | 更新时间 |
turnSiteTime | Date | 是 | 转派网点时间 |
turnEngTime | Date | 是 | 转派工程师时间 |
isAbnormal | Integer | 是 | 是否异常(1-正常;0-异常) |
exceptionInfo | String | 是 | 异常信息 |
taskId | String | 是 | 任务ID |
orderFlag | Boolean | 是 | 工单标识(1-补单;0-非补单) |
返回结果示例
{
"code": 200,
"data": {
"currPage": 1,
"list": [
{
"actualFinishNum": 0,
"address": "天津市和平区劝业场街道上升",
"adjustReason": "",
"appointmentTime": "",
"assignStatus": "",
"businessNo": "YWD20230428000004",
"cancelDetail": "",
"cancelReason": "",
"createTime": "2023-05-08 14:08:15",
"creater": "admin",
"engineerAcount": "ENG-13006644681",
"engineerName": "工程师1",
"exceptionInfo": "",
"expressNo": "",
"id": 1,
"isDelete": 1,
"merName": "",
"mobile": "13150000001",
"orderFlag": false,
"orderNo": "GD20230428000004",
"orderStatus": "已取消",
"ownerMsg": "",
"ownerName": "上升",
"ownerNo": "YZ20230428000004",
"pauseReason": "",
"processInstanceId": "10381975-e58b-11ed-ae9f-8e5bafb9eed0",
"processKey": "",
"regionCode": "",
"remark": "",
"requiredFinishNum": 1,
"serviceCode": "5693f04c-b4c3-4ba1-8f46-189bf4468b25",
"serviceProductName": "427导入服务产品",
"serviceType": "427服务类型",
"sideAcount": "FWS-13145231417",
"sideName": "服务商-ljx",
"standardsName": "",
"statusId": 99,
"taskId": "",
"time": "",
"updateTime": "2023-05-11 09:46:39",
"updater": "admin"
}
],
"pageSize": 10,
"totalCount": 1,
"totalPage": 1
},
"msg": "请求成功"
}
1.2: 工单流程记录
请求信息
HTTP协议:HTTP,HTTPS
uri:/activiti/bizPlatform/txOrder/record/{orderNo}
HTTP头:bizToken
方法:GET
请求参数
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
orderNo | String | 是 | 工单编码 |
请求Body描述
GET http://id:port/bizPlatform/txOrder/record/GD20230428000004
返回参数类型
JSON
返回参数
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
id | Long | 是 | 主键ID |
orderNo | String | 是 | 工单编码 |
orderStatus | String | 是 | 业务单状态 |
des | String | 是 | 描述信息 |
creater | String | 是 | 创建人 |
createTime | Date | 是 | 创建时间 |
statusId | Long | 是 | 状态id |
返回结果示例
{
"code": 200,
"data": [
{
"createTime": "2023-05-11 09:46:39",
"creater": "admin",
"des": "【admin】取消了工单\r\n【取消说明】sdf",
"id": 11,
"orderNo": "GD20230428000004",
"orderStatus": "已取消",
"statusId": 99
},
{
"createTime": "2023-04-28 14:08:15",
"creater": "admin",
"des": "【系统】把工单指派给平台端",
"id": 2,
"orderNo": "GD20230428000004",
"orderStatus": "待指派",
"statusId": 1
},
{
"createTime": "2023-04-28 14:08:15",
"creater": "admin",
"des": "【系统】创建了工单",
"id": 1,
"orderNo": "GD20230428000004",
"orderStatus": "待指派",
"statusId": 1
}
],
"msg": "请求成功"
}
1.3: 工单状态信息
请求信息
HTTP协议:HTTP,HTTPS
uri:/activiti/bizPlatform/txOrder/stateInfo/{orderNo}
HTTP头:bizToken
方法:GET
请求参数
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
orderNo | String | 是 | 工单编码 |
请求Body描述
GET http://id:port/bizPlatform/txOrder/stateInfo/GD20230428000004
返回参数类型
JSON
返回参数
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
allStatusList | List |
是 | 所有节点 |
curStatusList | List |
是 | 高亮节点 |
返回结果示例
{
"code": 200,
"data": {
"allStatusList": [
"已取消"
],
"curStatusList": [
"已取消"
]
},
"msg": "请求成功"
}
1.4: 查看工单详情
请求信息
HTTP协议:HTTP,HTTPS
uri:/activiti/bizPlatform/txOrder/get/{orderNo}
HTTP头:bizToken
方法:GET
GET http://id:port/bizPlatform/txOrder/get/GD20230428000004
返回参数类型
JSON
返回参数
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
id | Long | 是 | 主键ID |
businessNo | String | 是 | 业务单编码 |
managerName | String | 是 | 项目经理 |
managerMobile | List |
是 | 项目经理手机号 |
orderNo | String | 是 | 工单编码 |
ownerName | String | 是 | 业主姓名 |
mobile | String | 是 | 手机号码 |
address | String | 是 | 地址 |
merName | String | 是 | 地址组合名(匹配服务商地址) |
processInstanceId | String | 是 | 流程实例ID |
statusId | Integer | 是 | 工单状态id |
orderStatus | String | 是 | 工单状态 |
serviceCode | String | 是 | 服务编码 |
serviceProductName | String | 是 | 服务产品名称 |
standardsName | String | 是 | 产品规格 |
serviceType | String | 是 | 服务类型 |
serviceTypeName | String | 是 | 服务类型名称 |
suspensionState | Integer | 是 | 挂起状态(1-正常;2-挂起) |
requiredFinishNum | Integer | 是 | 应完工数量 |
actualFinishNum | Integer | 是 | 实际完工数量 |
adjustFee | BigDecimal | 是 | 调节金额 |
finalFee | BigDecimal | 是 | 最终结算金额 |
adjustReason | String | 是 | 调节原因 |
sideAcount | String | 是 | 承接网点账号 |
sideName | String | 是 | 承接网点名称 |
engineerAcount | String | 是 | 承接工程师账号 |
engineerName | String | 是 | 承接工程师名称 |
releaseTime | Date | 是 | 发布时间 |
expectedServiceTime | Date | 是 | 期望上门时间 |
appointmentTime | Date | 是 | 预约时间 |
remark | String | 是 | 备注 |
ownerMsg | String | 是 | 业主留言 |
isDelete | Integer | 是 | 是否删除(0-是;1-否) |
creater | String | 是 | 创建人 |
createTime | Date | 是 | 创建时间 |
updater | String | 是 | 更新人 |
turnSiteTime | Date | 是 | 转派网点时间 |
turnEngTime | Date | 是 | 转派工程师时间 |
productList | List | 是 | 产品信息 |
productId | Integer | 是 | 产品id |
productName | String | 是 | 产品名称 |
productCode | String | 是 | 产品编码 |
productModel | String | 是 | 产品型号 |
brandId | Long | 是 | 品牌ID |
brandName | String | 是 | 品牌名称 |
classifyId | Long | 是 | 一级分类id |
classifyName | String | 是 | 一级分类 |
subClassifyId | Long | 是 | 二级分类id |
subClassifyName | String | 是 | 二级分类 |
thirdClassifyId | Long | 是 | 三级分类id |
thirdClassifyName | String | 是 | 三级分类 |
productNums | Integer | 是 | 产品数量 |
labelName | String | 是 | 套餐名称 |
dealerFee | BigDecimal | 是 | 品牌商服务费用 |
toDoorFee | BigDecimal | 是 | 上门费用 |
servicerFee | BigDecimal | 是 | 服务费用 |
totalFee | BigDecimal | 是 | 应完工费用总计 |
standardsId | String | 是 | 服务规格ID |
standardsName | String | 是 | 服务规格名称 |
dealerToDoorFee | BigDecimal | 是 | 品牌商上门服务费 |
nodeId | String | 是 | 节点Id |
返回结果示例
{
"msg": "请求成功",
"code": 200,
"data": {
"actualFinishNum": 0,
"address": "中国广东省佛山市顺德区北滘镇",
"adjustReason": "",
"appointmentTime": "",
"businessNo": "YWD20230605000004",
"createTime": "2023-06-05 07:56:23",
"creater": "天选订单",
"engineerAcount": "ENG-13160000525",
"engineerName": "525工程师",
"finalFee": 0.15,
"id": 157,
"isDelete": 1,
"managerMobile": [null],
"managerName": "",
"merName": "中国,广东省,佛山市,顺德区,北滘镇",
"mobile": "15625059654",
"nodeId": "584",
"orderNo": "GD20230605000006",
"orderStatus": "待接单",
"ownerMsg": "",
"ownerName": "桂芳",
"ownerNo": "YZ20230603000074",
"processInstanceId": "66be3176-0333-11ee-b810-70a6ccdb3eef",
"productList": [{
"brandId": 8,
"brandName": "美的",
"classifyId": 3430,
"classifyName": "",
"labelName": "",
"productCode": "5120040500002-1",
"productId": 207,
"productModel": "A3Z-DK-02",
"productName": "二路开关面板",
"subClassifyId": 3471,
"subClassifyName": "",
"thirdClassifyId": 3486,
"thirdClassifyName": ""
}
],
"remark": "",
"requiredFinishNum": 2,
"service": {
"brandId": 4,
"brandName": "",
"businessNo": "YWD20230605000004",
"classifyId": 584,
"classifyName": "",
"createTime": "2023-06-05 07:56:20",
"creater": "天选订单",
"dealerFee": 10.0,
"dealerToDoorFee": 15.0,
"finalFee": 0.15,
"id": 159,
"name": "工程调试bzz",
"orderNo": "GD20230605000006",
"productNums": 2,
"repairType": "",
"serviceCode": "2519b10a-885a-438d-8a51-96211d27a365",
"serviceId": 545,
"serviceType": 102,
"serviceTypeName": "",
"servicerFee": 0.05,
"standardsId": 101,
"standardsName": "",
"subClassifyId": 585,
"subClassifyName": "",
"thirdClassifyId": 586,
"thirdClassifyName": "",
"toDoorFee": 0.05,
"updateTime": "2023-06-05 07:56:20",
"updater": ""
},
"serviceCode": "2519b10a-885a-438d-8a51-96211d27a365",
"serviceProductName": "工程调试bzz",
"serviceType": "",
"serviceTypeName": "",
"sideAcount": "FWS-13160000525",
"sideName": "525服务商",
"standardsName": "",
"statusId": 2,
"suspensionState": 1,
"taskId": "66be588b-0333-11ee-b810-70a6ccdb3eef",
"taskName": "待接单-515",
"turnEngTime": "2023-06-05 08:06:27",
"turnSiteTime": "2023-06-05 08:04:18",
"updateTime": "2023-06-05 08:02:32",
"updater": ""
}
}
1.5: 业务单列表(分页、模糊搜索)
请求信息
HTTP协议:HTTP,HTTPS
uri:/activiti/bizPlatform/txOrder/business/list
HTTP头:bizToken
方法:POST/JSON
请求参数
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
pageNo | Integer | 是 | 页码 |
pageSize | Integer | 是 | 每页的条数 |
condition | Object | 是 | 查询条件封装 |
condition.keyWord | String | 否 | 业务单编码/项目经理姓名/项目经理手机号/客户姓名/客户手机号码 |
请求Body描述
{
"pageNo": 1,
"pageSize": 1,
"condition": {
"keyword": "13150000001"
}
}
返回参数类型
JSON
返回参数
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
id | Long | 是 | 主键ID |
ownerNo | String | 是 | 业主编码 |
txOrderId | Long | 是 | 天选订单Id |
businessNo | String | 是 | 业务单编码 |
ownerName | String | 是 | 业主姓名 |
mobile | String | 是 | 手机号码 |
address | String | 是 | 地址 |
merName | String | 是 | 地址组合名(匹配服务商地址) |
regionCode | String | 是 | 最后一级区域编码 |
brandSideId | Long | 是 | 品牌方ID |
brandSideName | String | 是 | 品牌方名称(冗余) |
sourceId | Long | 是 | 业务单来源ID |
sourceName | String | 是 | 业务单来源名称(冗余) |
expectedServiceTime | Date | 是 | 期望上门时间 |
appointmentTime | String | 是 | 预约时间 |
releaseTime | Date | 是 | 发布时间 |
dealTime | Date | 是 | 处理时间 |
finishTime | Date | 是 | 完工时间 |
accounTime | Date | 是 | 对账时间 |
settlementTime | Date | 是 | 结算时间 |
isAbnormal | Integer | 是 | 是否异常(1-正常;0-异常) |
status | String | 是 | 业务单状态(0-已取消;1-待处理;2-处理中;3-待对账;4-对账中;5-待结算;6-已结算;7-已完成) |
exceptionInfo | String | 是 | 异常说明信息 |
ownerMsg | String | 是 | 用户留言 |
cancelInfo | String | 是 | 取消说明信息 |
remark | String | 是 | 备注 |
isDelete | Integer | 是 | 是否删除(0-是;1-否) |
creater | String | 是 | 创建人 |
createTime | Date | 是 | 创建时间 |
updater | String | 是 | 更新人 |
publishStatus | Integer | 是 | 发布状态(10-已发布;20-草稿) |
customType | Integer | 是 | 客户类型(10-个人;20-公司) |
managerName | String | 是 | 项目经理 |
statusCount | Integer | 是 | 业务单状态数量 |
返回结果示例
{
"code": 200,
"data": {
"currPage": 1,
"list": [
{
"address": "天津市和平区劝业场街道上升",
"appointmentTime": "",
"brandSideId": 17233,
"brandSideName": "517品牌方",
"businessNo": "YWD20230522000015",
"cancelInfo": "",
"createTime": "2023-05-22 17:59:56",
"creater": "admin",
"customType": 10,
"exceptionInfo": "",
"id": 116,
"isAbnormal": 1,
"isDelete": 1,
"managerMobile": [],
"managerName": "",
"merName": "中国,天津,天津市,和平区,劝业场街道,上升",
"mobile": "13150000001",
"ownerMsg": "sdfasdf",
"ownerName": "上升",
"ownerNo": "YZ20230428000004",
"publishStatus": 10,
"regionCode": "",
"releaseTime": "2023-05-22 17:59:57",
"remark": "所放电",
"sourceId": 4,
"sourceName": "517来源",
"status": "1",
"statusCount": 0,
"updateTime": "2023-05-22 17:59:56",
"updater": ""
}
],
"pageSize": 1,
"totalCount": 21,
"totalPage": 21
},
"msg": "请求成功"
}