描述:

  • 散客服务单详情

通过【散客单列表】接口获得单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   作者:大鱼研发