描述:
通过【散客单列表】接口获得单ID后,调用该接口获取单详细信息。
该信息会随着师傅的操作而变更,单状态包括:
8.待派单 1.待接单 2.未预约 3.已预约 4.进行中 5.已完成 6.已取消
其中:5和6为服务单最终状态。
版本:
版本号 |
制定人 |
制定日期 |
更新内容 |
1 |
大鱼研发 |
2020-10-10 |
|
请求URL:
- GET:
{dayu.server.domain}/scatter/scatterOrder/{orderId}
swagger 地址:
方法:
dayuScatterOrderService.getOrder(Long id,String token)
请求参数:
参数名 |
是否必须 |
类型 |
长度 |
说明 |
orderId |
是 |
long |
20 |
散客服务单ID |
返回示例:
正确时返回:
{
"code": 0,
"subCode": null,
"data": {
"id": 85232,
"orderNum": "XC20221014094720000002",
"status": 5,
"subStatus": 6,
"customerName": "李缘圆",
"customerMobile": "18554558755",
"provinceId": 1,
"provinceName": "北京市",
"cityId": 2,
"cityName": "北京城区",
"districtId": 3,
"districtName": "东城区",
"address": "回龙观",
"createId": 32,
"created": "李缘圆",
"createTime": "2022-10-14 09:47:21",
"appointmentTime": "2022-10-14 12:30:00",
"comment": "这是客户小程序留言1",
"confirmDoorTime": "2022-10-14 14:00:00",
"confirmDoorComment": "",
"customerCheckComment": null,
"cancelOrderReason": null,
"engineerId": 17,
"engineerName": "孙路路",
"esignatureImg": "https://dl.kf.ai/test/sp/mobile/ios/business/checkApply/05afc88649b66d11d87117b89693c136.JPG",
"createProviderId": 575,
"createdProvider": "三六零数字安全科技集团有限公司",
"isCheck": 2,
"accessories": [
{
"id": 128489,
"orderId": 85232,
"name": "0",
"url": "http://dl.kf.ai/dev/wechat/applet/partsImgs/7dc7d7fcb2a6840bbfa1bcfb9fd67bf0.jpg"
},
{
"id": 128490,
"orderId": 85232,
"name": "1",
"url": "http://dl.kf.ai/dev/wechat/applet/partsImgs/4354e669db3613be0d54fc36a75418dc.jpg"
}
],
"feedback": {
"id": 3437,
"orderId": 85232,
"score": 5,
"feedbackItem": null,
"feedbackComment": "维修后好用了",
"createTime": "2022-10-14 09:54:10",
"accountId": null,
"accountName": null,
"feedbackItem2": null,
"feedbackItem3": null,
"feedbackItem4": null,
"feedbackItem5": null,
"feedbackItem6": null,
"feedbackItem7": null,
"isDealt": null,
"status": null
},
"spuSettlementPrice": 0,
"shortVideoUrlList": [
"https://dl.kf.ai/test/video/01c336e287fada4aa1305c214a6c7515.mp4"
],
"finTime": "2022-10-14 09:54:10",
"serviceFinTime": "2022-10-14 09:51:45",
"record": [
{
"createTime": "2022-10-14 09:47:21",
"operation": "工单创建",
"operationComment": "李缘圆 通过 新建工单 创建了工单,并智能分派师傅抢单",
"serviceProgessTime": "T0",
"serviceProgessTimeNum": 0,
"commentName": "工单备注",
"commentInfo": "这是客户小程序留言1",
"latitude": null,
"longitude": null
},
{
"createTime": "2022-10-14 09:48:08",
"operation": "师傅接单",
"operationComment": "师傅孙路路 接单",
"serviceProgessTime": "T2",
"serviceProgessTimeNum": 2,
"commentName": null,
"commentInfo": null,
"latitude": null,
"longitude": null
},
{
"createTime": "2022-10-14 09:48:22",
"operation": "预约确认",
"operationComment": "师傅孙路路进行客户预约",
"serviceProgessTime": "T3",
"serviceProgessTimeNum": 3,
"commentName": "预约时间及备注",
"commentInfo": "预约时间:2022-10-14 14:00:00 ",
"latitude": null,
"longitude": null
},
{
"createTime": "2022-10-14 09:49:58",
"operation": "开始服务",
"operationComment": "师傅孙路路 开始服务",
"serviceProgessTime": "T5",
"serviceProgessTimeNum": 5,
"commentName": "查看位置",
"commentInfo": null,
"latitude": 40.026424,
"longitude": 116.31221
},
{
"createTime": "2022-10-14 09:51:26",
"operation": "服务记录",
"operationComment": "师傅孙路路完成“打印复印机上门服务” 1次",
"serviceProgessTime": "T6",
"serviceProgessTimeNum": 6,
"commentName": "服务记录",
"commentInfo": "59634",
"latitude": null,
"longitude": null
},
{
"createTime": "2022-10-14 09:51:45",
"operation": "提交验收",
"operationComment": "师傅孙路路 提交验收",
"serviceProgessTime": "T7",
"serviceProgessTimeNum": 7,
"commentName": "",
"commentInfo": null,
"latitude": null,
"longitude": null
},
{
"createTime": "2022-10-14 09:54:10",
"operation": "商家验收",
"operationComment": "系统 进行了验收服务",
"serviceProgessTime": "T8",
"serviceProgessTimeNum": 8,
"commentName": null,
"commentInfo": "维修后好用了",
"latitude": null,
"longitude": null
}
],
"spu": {
"id": 57161,
"orderId": 85232,
"kaSpuId": 602,
"kaSpuName": "打印复印机上门服务"
},
"sn": null,
"engineerSn": "Hp666673377888222118 ",
"ext":"abcde123"
},
"msg": "成功"
}
错误时返回:
{
"code": 1,
"subCode": "ORDER0001",
"data": null,
"msg": "服务单信息有误,无法正常获取"
}
返回字段说明:
可直接查看,SDK实体类:
scatterOrderDetail
spu
accessories
feedback
字段名 |
类型 |
长度 |
说明 |
id |
long |
20 |
服务单id |
orderNum |
string |
50 |
工单编号 |
status |
int |
11 |
服务单状态:8.待派单 1.待接单 2.未预约 3.已预约 4.进行中 5.已完成 6.已取消 |
subStatus |
int |
11 |
子状态:当status=4进行中时:6.表示已提交验收申请,status为其它值时暂无其它意义 |
customerName |
String |
50 |
客户姓名 |
customerMobile |
String |
45 |
联系电话 |
provinceId |
Long |
20 |
省id |
provinceName |
String |
20 |
省名称 |
cityId |
Long |
20 |
城市id |
cityName |
String |
20 |
城市名称 |
districtId |
Long |
20 |
区\县id |
districtName |
String |
20 |
区\县 |
address |
string |
200 |
详细地址 |
createId |
Long |
20 |
创建人id |
created |
String |
50 |
创建人 |
createTime |
date |
|
创建时间 |
finTime |
date |
|
完工时间 |
serviceFinTime |
date |
|
提交验收时间 |
appointmentTime |
date |
|
客户预约的时间 |
comment |
string |
1000 |
客户留言 |
confirmDoorTime |
date |
|
工程师确认上门时间 |
confirmDoorComment |
string |
100 |
工程师确认上门备注 |
shortVideoUrlList |
list |
|
完工短视频列表 |
customerCheckComment |
string |
300 |
客户验收服务记录内容 |
cancelOrderReason |
string |
100 |
取消订单的理由 |
engineerId |
long |
20 |
工程师ID |
engineerName |
string |
50 |
工程师名称 |
esignatureImg |
string |
200 |
电子签名图片 |
createProviderId |
long |
20 |
派单方ID |
createdProvider |
string |
255 |
派单方名称 |
isCheck |
int |
2 |
验收方式:0自动验收 1用户现场验收 2商家远程验收 |
spu |
object |
|
服务项目 |
accessories |
list |
|
附件列表 |
feedback |
object |
|
评价 |
record |
list |
|
操作记录 |
sn |
string |
|
商家填写sn码 |
engineerSn |
string |
|
师傅填写sn码 |
ext |
string |
|
扩展信息(扫码传入的信息原样返回) |
spu 服务项目说明
字段名 |
类型 |
说明 |
orderId |
long |
工单ID |
kaSpuId |
long |
服务项目ID |
kaSpuName |
string |
服务项目名称 |
accessories 附件列表说明
参数名 |
是否必须 |
类型 |
长度 |
说明 |
name |
是 |
string |
200 |
附件名 |
URL |
是 |
int |
20 |
附件URL |
record 流程记录说明
参数名 |
是否必须 |
类型 |
长度 |
说明 |
createTime |
是 |
string |
20 |
创建时间 |
operation |
是 |
string |
50 |
操作 |
operationComment |
否 |
string |
100 |
操作内容 |
serviceProgessTimeNum |
是 |
int |
11 |
服务进程时刻点数(0-10) |
commentName |
否 |
string |
20 |
备注名称 |
commentInfo |
否 |
string |
1000 |
备注详细信息 |
latitude |
否 |
string |
10,6 |
纬度 |
longitude |
否 |
string |
10,6 |
经度 |
feedback 评价说明
参数名 |
是否必须 |
类型 |
长度 |
说明 |
orderId |
是 |
long |
20 |
工单ID |
createTime |
是 |
string |
20 |
创建时间 |
score |
是 |
int |
11 |
分数(1-5) |
feedbackItem |
否 |
string |
20 |
评价项1 |
… |
|
|
|
|
文档更新时间: 2022-10-18 16:02 作者:大鱼研发