**簡要描述：**
* 調用時機：師傅上門處理完成的時候調用此接口。
**接口參數：**
```
{
"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.回訪審核（主動模式）