**简要描述：**
* 调用时机：师傅上门处理完成的时候调用此接口。
**接口参数：**
```
{
"key": "77963b7a931377ad4ab5ad6a9cd718aa",
"data": {
"order_number": "……",
"handle": {
"way": "处理完成",
"node": "安装完成", //仅安装完成需要验证码
"operator": "操作人",
"remarks": "操作备注"
},
"data": {
"mi_sn":"000005/123456",
"kt_sn": [{"mi_sn":""},{"mi_sn":""}],
"mi_purchase_time":"2018-08-08 12:08:08",
"attachment":["base64","base64","base64","base64"]
}
}
}
```
**参数说明：**
| 名称 | 是否必须 | 允许为空 | 描述 | 附加说明 |
| --- | --- | --- | --- | --- |
| handle | Y | N | 办理方式 | key值 |
| way | Y | N | 操作方式 | 固定值：处理完成 |
| node | Y | N | 流程节点 | 有效值：安装完成/清洗完成/上门检测/重新预约/转派师傅/需转鉴定 |
| operator | Y | N | 操作人 | 操作人的姓名，如张三 |
| remarks | Y | N | 办理备注信息 | |
| data | Y | N | 工单处理参数 | key值 |
| mi\_purchase\_time | Y | N | 购买日期 | 安装完成/上门检测/需转鉴定必填 格式为：2018-12-27 15:30:00 |
| mi\_sn | Y | N | 产品SN码 | 安装完成/清洗完成/上门检测/需转鉴定必填，如：000006/00000034 |
| kt\_sn | Y | N | 空调内机产品信息 | 安装完成/清洗完成/上门检测/需转鉴定并且产品为空调类时必填，至少一个，其参数与工单产品相同，如：\[{"mi\_sn":"000006/00000034","service\_measures":"","fault\_type":""},{"mi\_sn":"000006/00000035","service\_measures":"","fault\_type":""}\]当产品为空调时必须，不可为空，mi\_sn为空调外机SN码，kt\_sn为空调内机SN码 |
| attachment | Y | N | 安装完成/上门检测/需转鉴定时的图片，必须4张（一组）；<br>当工单中的产品品类为空调类时，每个空调内外机都需对应一组4张照片； | 安装完成/清洗完成/上门检测必填 如：\["base64","...","..."\]，图片base64字符串<br>或url地址 |
| worker\_error\_desc | Y | N | 故障记录 | 需转鉴定必填 故障的文字性说明 |
| check\_validate\_result | Y | N | 检验鉴定结果 | 需转鉴定必填，有效值：性能故障、外观瑕疵、物流破损、无；可以多选，多个值之间使用英文逗号分隔 |
| check\_validate\_detail | Y | N | 检验鉴定结果详情 | 需转鉴定必填，鉴定结果详情的文字性说明 |
| pack\_validate | Y | N | 包装鉴定 | 需转鉴定必填，有效值：纸箱缺损、泡沫缺损、说明书缺损、相关配件缺损 可以多选，多个值之间使用英文逗号分隔 |
| pack\_validate\_detail | Y | N | 包装鉴定详情 | 需转鉴定必填，包装鉴定详情的文字性说明 |
| time\_of\_appointment | Y | N | 和客户预约上门的时间 | 重新预约必填，格式为：2018-12-27 15:30:00 |
| network\_info | Y | N | 网点信息<br>注：为了后面业务拓展，请在该字段中带上网点的信息 | 需转鉴定必填，格式：<br>网点名称：XXX，<br>网点地址：XXX，<br>网点联系方式：XXX |
| engineer\_name | Y | N | 师傅姓名 | 转派师傅必填 需转鉴定非必填 |
| engineer\_phone | Y | N | 师傅电话 | 转派师傅必填 需转鉴定非必填 |
| praise\_success | N | Y | 是否邀好评成功 | 有效值 是/否 |
| praise\_screenshot | N | Y | 客户好评截图 | \["base64","...","..."\]，图片base64字符串 |
| water\_test\_immediately | N | Y | 用户要求立即通水测试 | 有效值：是、否<br>净水类产品安装完成必填 |
| tap\_water\_tds | N | Y | 纯水tds值 | 净水类产品安装完成且立即通水测试为是必填 |
| wastewater\_tds | N | Y | 废水tds值 | 净水类产品安装完成且立即通水测试为是必填 |
| inletwater\_tds | N | Y | 进水tds值 | 净水类产品安装完成且立即通水测试为是必填 |
| water\_test\_instructions | N | Y | 未通水测试说明 | 净水类产品安装完成且立即通水测试为否<br>必填 |
| service\_measures | N | Y | 服务措施 | 需转鉴定非必填 |
| fault\_type | Y | N | 故障类型 | 需转鉴定必填 故障类型有三级，格式为： 一级故障/二级故障/三级故障 不同的产品有不同的故障，请使用"故障类型"接口获取故障类型的数据 至少3级 |
不同流程节点办理说明：
* 安装完成—下一节点待“申请完工”；
* 上门检测—下一节点待“工单回访”，无需申请完单；
* 重新预约—重新预约操作时间不能晚于上一次与客户上门的时间，下一节点待“上门打卡”；
* 转派师傅—下一节点待“预约上门”。
* 清洗完成—下一节点待“工单回访”，无需申请完单；
* 需转鉴定—下一节点待“技术鉴定”，无需申请完工。
* 图片说明：上传4张照片，分别为：3张必填（整机安装效果图、整机SN照片、安装服务记录单（必须有用户签字））,1张选填：APP连接图片或好评截图；
**返回参数：**
见[4.2.3工单办理](4.2.3.%E5%B7%A5%E5%8D%95%E5%8A%9E%E7%90%86%EF%BC%88%E8%A2%AB%E5%8A%A8%E6%A8%A1%E5%BC%8F%EF%BC%89.md)的返回参数说明
- 1.修订记录
- 2.接口概述
- 3.通讯协议
- 4.CTC接口说明
- 4.1.接口类型
- 4.2.通用接口
- 4.2.1.工单创建（被动模式）
- 4.2.2.工单派发（主动模式）
- 4.2.3.工单办理（被动模式）
- 4.2.4.工单撤销（主动模式）
- 4.2.5.工单催办（主动模式）
- 4.2.6.获取故障类别（被动模式）
- 4.2.7.产品SN码维护（被动模式）
- 4.2.8.获取工单列表（被动模式）
- 4.2.9.获取工单详细（被动模式）
- 4.2.10.工单评价（被动模式）
- 4.2.11.短信接口（被动模式）
- 4.2.12.短信链接评价接口（主动模式）
- 4.2.13.工单备注（主动模式）
- 4.2.14.工单备注（被动模式）
- 4.2.15 等级品SN码（被动模式）
- 4.2.16 产品配件（被动模式）
- 4.2.17.出入库信息及明细（被动模式）
- 4.2.18.师傅邀请码（被动模式）
- 4.3.安装流程
- 4.3.1.流程说明
- 4.3.2.工单派发（主动模式）
- 4.3.3.派送师傅（被动模式）
- 4.3.4.预约上门（被动模式）
- 4.3.5.上门打卡（被动模式）
- 4.3.6.处理完成（被动模式）
- 4.3.7.申请完单（被动模式）
- 4.3.8.工单回访（暂停使用）
- 4.3.9.工单撤销（被动模式）
- 4.3.10.工单转派（被动模式）
- 4.3.11.技术鉴定（主动模式）
- 4.3.12.回访审核（主动模式）
- 4.4.维修流程
- 4.4.1.流程说明
- 4.4.2.工单派发（主动模式）
- 4.4.3.派送师傅（被动模式）
- 4.4.4.预约上门（被动模式）
- 4.4.5.上门打卡（被动模式）
- 4.4.6.处理完成（被动模式）
- 4.4.7.技术鉴定（主动模式）
- 4.4.8.申请完单（被动模式）
- 4.4.9.工单回访（暂停使用）
- 4.4.10.工单撤销（被动模式）
- 4.4.11.工单转派（被动模式）
- 4.4.12.回访审核（主动模式）
- 4.5.鉴定流程（暂停使用）
- 4.5.1.流程说明（暂停使用此流程）
- 4.5.2.工单派发（主动模式）
- 4.5.3.派送师傅（被动模式）
- 4.5.4.预约上门（被动模式）
- 4.5.5.上门打卡（被动模式）
- 4.5.6.处理完成（被动模式）
- 4.5.7.申请完单（被动模式）
- 4.5.8.工单撤销（被动模式）
- 4.5.9.工单转派（被动模式）
- 4.6.投诉流程
- 4.6.1.流程说明
- 4.6.2.工单派发（主动模式）
- 4.6.3.处理完成（被动模式）
- 4.7.换货流程
- 4.7.1. 流程说明
- 4.7.2. 工单派发（主动模式）
- 4.7.3. 网点确认收新品（被动模式）
- 4.7.4. 网点处理送装（被动模式）
- 4.7.5. 师傅预约上门（被动模式）
- 4.7.6. 师傅送拆装（被动模式）
- 4.7.7. 网点自寄（暂时停用-被动模式）
- 4.7.8. 客服审核（主动模式）
- 4.7.9. 逆向处置审核（主动模式）
- 4.8.退货流程
- 4.8.1. 流程说明
- 4.8.2. 工单派发（主动模式）
- 4.8.3. 网点预约上门（被动模式）
- 4.8.4. 师傅预约上门（被动模式）
- 4.8.5. 师傅上门拆件（被动模式）
- 4.8.6. 网点自寄（暂时停用-被动模式）
- 4.8.7. 逆向处置审核（主动模式）
- 4.9.拆机流程
- 4.9.1.流程说明
- 4.9.2.工单派发（主动模式）
- 4.9.3.派送师傅（被动模式）
- 4.9.4.预约上门（被动模式）
- 4.9.5.上门打卡（被动模式）
- 4.9.6.处理完成（被动模式）
- 4.9.7.回访审核（主动模式）
- 4.10.测量流程
- 4.10.1. 流程说明
- 4.10.2.工单派发（主动模式）
- 4.10.3.派送师傅（被动模式）
- 4.10.4.预约上门（被动模式）
- 4.10.5.上门打卡（被动模式）
- 4.10.6.处理完成（被动模式）
- 4.10.7.回访审核（主动模式）
- 4.11.配件申请流程
- 4.11.1. 流程说明
- 4.11.2. 创建工单（被动模式）
- 4.11.3. 配件审核（主动模式）
- 4.11.4. 处理退回（被动模式）
- 4.11.5. 仓库发货（主动模式）
- 4.11.6. 网点收货（被动模式）
- 4.12.配件退款流程
- 4.12.1. 退款成功通知（主动模式）
- 4.13. 维修换修流程
- 4.13.1. 流程说明
- 4.13.2. 工单派发（主动模式）
- 4.13.3. 派送师傅（被动模式）
- 4.13.4. 预约上门（被动模式）
- 4.13.5. 上门打卡（被动模式）
- 4.13.6. 处理完成（被动模式）
- 4.13.7. 寄修收货（被动模式）
- 4.13.8. 工单撤销（被动模式）
- 4.14.清洗流程
- 4.14.1.流程说明
- 4.14.2.工单派发（主动模式）
- 4.14.3.派送师傅（被动模式）
- 4.14.4.预约上门（被动模式）
- 4.14.5.上门打卡（被动模式）
- 4.14.6.处理完成（被动模式）
- 4.14.7.回访审核（主动模式）