工单跟进相关接口：

API列表

编号 API名称 路径 版本
1 根据工单编码查询跟进信息列表【管家app端】【员工PC端】 /v1/workorder/admin/followUp/listFollowUpWorkorderId 1.0
2 新增时回显报单人和管家信息【管家app端】 /v1/workorder/admin/followUp/getByWorkorderOrderNo 1.0
3 新增跟进信息【管家app端】 /v1/workorder/admin/followUp/add 1.0
4 根据工单编码查询工单【管家app端】 /v1/workorder/admin/instance/getByOrderNo 1.0

1.根据工单编码查询跟进信息列表【员工app端】【员工PC端】

返回api列表

接口url：/v1/workorder/admin/followUp/listFollowUpWorkorderId?orderNo=#{orderNo}

请求方式：POST

请求参数：

字段 类型 是否必传 说明
orderNo string 是 工单编码

响应状态:

状态码 说明 schema
200 OK Mono
201 Created
401 Unauthorized
403 Forbidden
404 Not Found

返回参数：

字段 类型 是否必填 说明
id int Y 主键
workorderId int N 工单ID
contactPersonId int N 联系人ID
contactPersonName string N 联系人名
contactPersonPhone string N 联系人电话
followPersonId int N 跟进人ID
followPersonName string N 跟进人名
followTime string N 跟进时间
content string N 内容
createTime date N 创建时间
attachUrl string N 附件，逗号隔开

请求示例：/v1/workorder/user/followUp/listFollowUpWorkorderId?orderNo=GD123456

返回示例：

{
    "message": "Ok",
    "code": 200,
    "data": [
        {
            "id": 1,
            "workorderId": 123,
            "contactPersonId": 123,
            "contactPersonName": "联系人名",
            "contactPersonPhone": null,
            "followPersonId": 123,
            "followPersonName": "跟进人名",
            "followTime": "2021-12-22 15:20",
            "content": "内容",
            "createTime": "2021-12-22T07:44:51.000+00:00",
            "attachUrl": "附件，逗号隔开"
        },
        {
            "id": 2,
            "workorderId": 123,
            "contactPersonId": 124,
            "contactPersonName": "张三",
            "contactPersonPhone": null,
            "followPersonId": 124,
            "followPersonName": "管家1",
            "followTime": "2021-12-22 15:20",
            "content": "跟进内容",
            "createTime": "2021-12-22T07:46:32.000+00:00",
            "attachUrl": "附件，逗号隔开"
        }
    ]
}

2.新增时回显报单人和管家信息【app端】

返回api列表

接口url：/v1/workorder/admin/followUp/getByWorkorderOrderNo?orderNo=#{orderNo}

请求方式：POST

请求参数：

字段 类型 是否必传 工单编码
orderNo string 是 工单编码

响应状态:

状态码 说明 schema
200 OK Mono
201 Created
401 Unauthorized
403 Forbidden
404 Not Found

返回参数：

字段 类型 是否必填 说明
workorderId int Y 工单ID
incidentPersonId int Y 报单人ID
contactPersonName string Y 报单人
contactPersonPhone string Y 报单人电话
followPersonId string Y 跟进人ID
followPersonName string Y 跟进人
followTime string Y 跟进时间

请求示例：/v1/workorder/admin/followUp/getByWorkorderOrderNo?orderNo=GD123456 返回示例：

{
    "message": "Ok",
    "code": 200,
    "data": {
        "incidentPersonId": 123456,
        "followPersonName": "pz0001",
        "workorderId": 123,
        "contactPersonName": "张三",
        "followTime": "2021-12-29 15:20",
        "followPersonId": "88293",
        "contactPersonPhone": "13688889999"
    }
}

3.新增跟进信息【app端】

返回api列表

接口url：/v1/workorder/admin/followUp/add

请求方式：POST

请求参数：FollowUp实体

字段 类型 是否必传 说明
workorderId string 是 工单id
contactPersonId int 是 报单人id
contactPersonName string 是 报单人
contactPersonPhone string 是 报单人电话
followPersonId int 是 跟进人id
followPersonName string 是 跟进人
followTime string 是 跟进时间
content string 是 内容
attachUrl text 否 附件，逗号隔开

响应状态:

状态码 说明 schema
200 OK Mono
201 Created
401 Unauthorized
403 Forbidden
404 Not Found

返回参数：

字段 类型 是否必填 说明
id string Y 主键ID

请求示例：/v1/workorder/admin/followUp/add

{
  "workorderId":126,
  "contactPersonId":124,
  "contactPersonName":"张三",
  "followPersonId":124,
  "followPersonName":"李四",
  "followTime":"2021-12-29 15:20",
  "content":"内容",
  "attachUrl":"附件，逗号隔开"
}

返回示例：

{
    "message": "Ok",
    "code": 200,
    "message":null,
    "data": {
        "id": "8"
    }
}

4.根据工单编码查询工单【app端】

返回api列表

接口url：/v1/workorder/admin/instance/getByOrderNo?orderNo=#{orderNo}

请求方式：POST

请求参数：

字段 类型 是否必传 说明
orderNo string 是 工单编码

响应状态:

状态码 说明 schema
200 OK Mono
201 Created
401 Unauthorized
403 Forbidden
404 Not Found

返回参数：

字段 类型 是否必填 说明
id int Y 主键ID
version int N 版本
isDeleted string N 逻辑删除
createBy string N 创建人
createTime date N 创建时间
updateBy string N 修改人
updateTime date N 修改时间
title string N 工单标题
description string N 工单描述
workorderTemplateId int N 工单模板ID
bpmDefinitionId string N 流程定义ID
bpmInstanceId string N 流程实例ID
orderNo string Y 单据号
status string N 工单状态
spaceId int N 空间ID
spaceName string N 空间名称
address string N 详细地址
roomNo string N 房号
sendOrderPersonType string N 派单人类型：1员工；2客户
sendOrderPerson string N 派单人
sendOrderPersonId int N 派单人ID
incidentPerson string N 报事人
incidentPersonId int N 报事人ID
incidentContent string N 报事内容
doneTime date N 完成时间
scopeType string N 报事分类：1客户报事；2员工报事
contactPhone string Y 联系电话
submitSrc string N 报事来源：1来电；2来访；3业主；app；4员工app；5外部
workorderType string N 工单类别：1特点流程；2通用流程
submitTime date N 报事时间
orderCategoryName string N 工单类别名称
orderCategoryId int N 工单类别ID
currentPersonId int N 当前处理人ID
currentPerson string N 当前处理人
custId long N 客户ID
custName string N 客户名称
custPhone string N 客户手机号
isAnonymous string N 是否匿名: 1否 ; 2是
remark string N 备注
urgentLevel string N 报事级别
appointTime string N 预约时间

请求示例：/v1/workorder/admin/instance/getByOrderNo?orderNo=GD123456

返回示例：

{
    "message": "Ok",
    "code": 200,
    "data": {
        "version": 0,
        "isDeleted": null,
        "createBy": null,
        "createTime": null,
        "updateBy": null,
        "updateTime": null,
        "id": 123,
        "title": "标题",
        "description": "工单描述",
        "workorderTemplateId": null,
        "bpmDefinitionId": null,
        "bpmInstanceId": null,
        "orderNo": "GD123456",
        "status": "待接单",
        "spaceId": null,
        "spaceName": "",
        "address": "三期/10栋/1单元/2002",
        "roomNo": "2002",
        "sendOrderPersonType": "1",
        "sendOrderPerson": "派单人",
        "sendOrderPersonId": null,
        "incidentPerson": "张三",
        "incidentPersonId": 123456,
        "incidentContent": null,
        "doneTime": "2021-12-23T03:31:39.000+00:00",
        "scopeType": null,
        "contactPhone": "13888888000",
        "submitSrc": null,
        "workorderType": null,
        "submitTime": null,
        "orderCategoryName": "室内维修",
        "orderCategoryId": null,
        "currentPersonId": null,
        "currentPerson": null,
        "custId": null,
        "custName": "李四",
        "custPhone": "13411112222",
        "isAnonymous": null,
        "remark": null,
        "urgentLevel": null,
        "appointTime": null
    }
}

results matching ""

    No results matching ""