描述：

  • 服务单详情

在定时任务或者消息获取到服务单ID后，调用该接口获取服务单详细信息。
该信息会随着商家和师傅的操作而变更，服务单状态包括：
8.待派单 1.待接单 2.未预约 3.已预约 4.进行中 5.已完成 6.已取消
其中：5和6为服务单最终状态。
（结算相关信息请使用【结算信息】获取，服务单完成后，结算仍然有可能发生变化）

版本：

版本号 制定人 制定日期 更新内容
1 大鱼研发 2020-07-19
2 大鱼研发 2020-08-20 移除结算信息，获取结算信息调用：【结算信息】接口

方法:

  • dayuOrderService.getOrder(Long id,String token)

swagger 地址：

请求参数:

参数名 是否必须 类型 长度 说明
orderId 是 long 20 服务单ID

返回示例:

正确时返回:

{
    "code":0,
    "subCode":null,
    "data":{
        "id":80653,
        "orderNum":"SP20210609164949000002",
        "status":5,
        "subStatus":6,
        "repairType":1,
        "customerType":1,
        "customerName":"1",
        "customerCompany":"1",
        "customerMobile":"1",
        "customerTelphome":"",
        "provinceId":1,
        "provinceName":"北京市",
        "cityId":2,
        "cityName":"北京城区",
        "districtId":33,
        "districtName":"朝阳区",
        "address":"四惠东(地铁站) 1号线;八通线",
        "createId":17,
        "created":"孙路路",
        "createTime":"2021-06-09 16:49:50",
        "appointmentTime":"2021-06-09 19:00:00",
        "comment":"",
        "confirmDoorTime":"2021-06-09 19:00:00",
        "confirmDoorComment":"",
        "customerCheckComment":null,
        "payType":3,
        "doorPrice":0,
        "doorPriceComment":"",
        "servicePrice":0,
        "totalPrice":0,
        "cancelOrderReason":null,
        "siteId":1106,
        "siteName":null,
        "engineerId":2290,
        "engineerName":"李缘圆",
        "needEsignature":2,
        "needSerialNumPic":2,
        "esignatureImg":"",
        "taskDesc":null,
        "orderChannelId":null,
        "orderChannelName":null,
        "customerComment":null,
        "createProviderId":14,
        "createdProvider":"北京dewly大鱼创想科技有限公司",
        "isCheck":2,
        "accessories":[

        ],
        "feedback":{
            "id":2968,
            "orderId":80653,
            "score":4,
            "feedbackItem":null,
            "feedbackComment":"",
            "createTime":"2021-06-09 17:03:35",
            "accountId":17,
            "feedbackItem2":null,
            "feedbackItem3":null,
            "feedbackItem4":null,
            "feedbackItem5":null,
            "feedbackItem6":null,
            "feedbackItem7":null,
            "isDealt":null,
            "status":null
        },
        "spuSettlementPrice": 1.3,
        "shortVideoUrl":null,
        shortVideoUrlList:[],
        "finTime":"2021-06-09 17:03:35",
        "productId":63,
        "productName":"UAT_SLL_产品",
        "record":[
            {
                "createTime":"2021-06-09 16:49:50",
                "operation":"工单创建",
                "operationComment":"孙路路 通过 新建工单 创建了工单,并指定师傅(李缘圆)接单",
                "serviceProgessTimeNum":0,
                "commentName":"工单备注",
                "commentInfo":"",
                "latitude":null,
                "longitude":null
            },
            {
                "createTime":"2021-06-09 16:50:01",
                "operation":"师傅接单",
                "operationComment":"师傅李缘圆  接单",
                "serviceProgessTimeNum":2,
                "commentName":null,
                "commentInfo":null,
                "latitude":null,
                "longitude":null
            },
            {
                "createTime":"2021-06-09 16:50:12",
                "operation":"预约确认",
                "operationComment":"师傅李缘圆进行客户预约",
                "serviceProgessTimeNum":3,
                "commentName":"预约时间及备注",
                "commentInfo":"预约时间:2021-06-09 19:00:00 ",
                "latitude":null,
                "longitude":null
            },
            {
                "createTime":"2021-06-09 16:56:45",
                "operation":"开始服务",
                "operationComment":"师傅李缘圆  开始服务",
                "serviceProgessTimeNum":5,
                "commentName":"查看位置",
                "commentInfo":null,
                "latitude":40.026684,
                "longitude":116.31227
            },
            {
                "createTime":"2021-06-09 16:56:49",
                "operation":"服务记录",
                "operationComment":"师傅李缘圆完成“对接服务项目” 1次",
                "serviceProgessTimeNum":6,
                "commentName":"查看结果",
                "commentInfo":"54979",
                "latitude":null,
                "longitude":null
            },
            {
                "createTime":"2021-06-09 16:56:53",
                "operation":"提交验收",
                "operationComment":"师傅李缘圆  提交验收",
                "serviceProgessTimeNum":7,
                "commentName":"",
                "commentInfo":null,
                "latitude":null,
                "longitude":null
            },
            {
                "createTime":"2021-06-09 16:57:42",
                "operation":"重新返工",
                "operationComment":"验收不通过，重新服务",
                "serviceProgessTimeNum":null,
                "commentName":"",
                "commentInfo":"4455",
                "latitude":null,
                "longitude":null
            },
            {
                "createTime":"2021-06-09 16:59:49",
                "operation":"预约确认",
                "operationComment":"师傅李缘圆进行客户预约",
                "serviceProgessTimeNum":3,
                "commentName":"预约时间及备注",
                "commentInfo":"预约时间:2021-06-09 19:00:00 ",
                "latitude":null,
                "longitude":null
            },
            {
                "createTime":"2021-06-09 17:03:22",
                "operation":"开始服务",
                "operationComment":"师傅李缘圆  开始服务",
                "serviceProgessTimeNum":5,
                "commentName":"查看位置",
                "commentInfo":null,
                "latitude":40.026627,
                "longitude":116.31227
            },
            {
                "createTime":"2021-06-09 17:03:24",
                "operation":"服务记录",
                "operationComment":"师傅李缘圆完成“对接服务项目” 1次",
                "serviceProgessTimeNum":6,
                "commentName":"查看结果",
                "commentInfo":"54979",
                "latitude":null,
                "longitude":null
            },
            {
                "createTime":"2021-06-09 17:03:27",
                "operation":"提交验收",
                "operationComment":"师傅李缘圆  提交验收",
                "serviceProgessTimeNum":7,
                "commentName":"",
                "commentInfo":null,
                "latitude":null,
                "longitude":null
            },
            {
                "createTime":"2021-06-09 17:03:35",
                "operation":"服务商验收",
                "operationComment":"服务商进行了验收服务",
                "serviceProgessTimeNum":8,
                "commentName":null,
                "commentInfo":"",
                "latitude":null,
                "longitude":null
            }
        ],
        "spus":[
            {
                "id":52580,
                "orderId":80653,
                "kaSpuId":551,
                "kaSpuName":"对接服务项目",
                "sopStatus":1,
                "accreditPrice":10,
                "productModel":"",
                "categoryThreeId":898,
                "categoryThreeName":"平板电视",
                "providerTypeId":1,
                "providerTypeName":"安装",
                "serviceType":1,
                "goodNum":1,
                "finNum":2,
                "needSerialNumPic":2,
                "kaSpuLogoUrl":null,
                "kaSpuDoorPrice":null,
                "productId":null,
                "productName":"",
                "faultType":null,
                "faultCode":"",
                "sn":"",
                "hasProductIds":null,
                "labelId":16,
                "labelName":"电视"
            }
        ]
    },
    "msg":"成功"
}

错误时返回:

{
  "code": 1,
  "subCode": "ORDER0001",
  "data": null,
  "msg": "服务单信息有误，无法正常获取"
}

返回字段说明:

可直接查看，SDK实体类：
OrderDetail
OrdersRelationSpu
orderAccessorite
feedback

字段名 类型 长度 说明
id long 20 服务单id
orderNum string 50 工单编号
status int 11 服务单状态:8.待派单 1.待接单 2.未预约 3.已预约 4.进行中 5.已完成 6.已取消（注意，状态和大鱼SPM系统页面不是一一对应的，页面中待服务列表包含：未预约、已预约和进行中；已完成包含：已完成和取消）
subStatus int 11 子状态：当status=4进行中时：6.表示已提交验收申请，status为其它值时暂无其它意义
repairType int 11 保修类型（1保内2保外）
customerType int 11 客户类型（1个人客户2企业客户）
customerName String 50 客户姓名或者企业客户联系人
customerCompany String 100 企业客户名称
customerMobile String 45 联系电话
customerTelphome 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 工程师确认上门备注
shortVideoUrl string 255 完工短视频（保留字段，请使用shortVideoUrlList）
shortVideoUrlList list 完工短视频列表
customerCheckComment string 300 客户验收服务记录内容
isPay int 4 是否付费1未付费2已付费
payType int 4 收款方式：1委托师傅扫码收款 3不用向客户收款 4对公转账结算
doorPrice float 10,2 代收商品货款（元）
doorPriceComment string 100 代费用备注
servicePrice float 10,2 代收服务费（元）
totalPrice float 10,2 总费用
cancelOrderReason string 100 取消订单的理由
siteId long 20 服务站ID
siteName string 50 站点名称
engineerId long 20 工程师ID
engineerName string 50 工程师名称
needEsignature int 1 是否需要电子签名：1：需要 2：不需要
needSerialNumPic int 1 是否需要师傅收集设备序列号：1：需要 2：不需要
esignatureImg string 200 电子签名图片
taskDesc string 1000 任务描述
orderChannelId int 20 渠道ID
orderChannelName string 100 渠道名称
customerComment string 1000 用户备注
createProviderId long 20 派单方ID
createdProvider string 255 派单方名称
isCheck int 2 验收方式：0自动验收 1用户现场验收 2商家远程验收
spus list 服务数量
accessories list 工单对应的附件列表
feedback object 工单评价
record list 工单操作记录
sn string 200 商家填写sn码
engineerSn string 200 师傅填写sn码
spuSettlementPrice float 10,2 派单费用
isMultitask int 1 多任务标识：1.是 2.否
spus 服务项目列表说明
字段名 类型 说明
orderId long 工单ID
kaSpuId long 服务项目ID
kaSpuName string 服务项目名称
goodNum int 数量
spuModels list 服务spu对应的’型号/配置/数量’

orderAccessorites 附件列表说明

参数名 是否必须 类型 长度 说明
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-12-30 09:13   作者：大鱼研发