**簡要描述：** * 調用時機：師傅上門處理完成的時候調用。 **接口參數：** ``` { "key": "77963b7a931377ad4ab5ad6a9cd718aa", "data": { "order_number": "……", "handle": { "way": "處理完成", "node": "維修完成",//僅維修完成需要驗證碼 "operator": "操作人", "remarks": "操作備注", "parts": [{"yunmi_code":"01:02123:0:", "count": 10}] // 空調外機|普通產品 申請配件、維修耗用配件使用 }, "data": { "mi_sn":"000005/123456", "mi_purchase_time":"2018-08-08 12:08:08", "service_measures":"", "fault_type":"", "kt_sn": [{ "mi_sn":"", "service_measures":"", "fault_type":"", "parts": [{"yunmi_code":"01:02123:0:", "count": 10}] // 空調內機申請配件、維修耗用配件使用 },{ "mi_sn":"", "service_measures":"", "fault_type":"", "parts": [{"yunmi_code":"01:02123:0:", "count": 10}] // 空調內機申請配件、維修耗用配件使用 }], "attachment":["url","url","url","url"] } } } ``` **參數說明：** | 名稱 | 是否必須 | 允許為空 | 描述 | 附加說明 | | --- | --- | --- | --- | --- | | handle | Y | N | 辦理方式 | key值 | | way | Y | N | 操作方式 | 固定值：處理完成 | | node | Y | N | 流程節點 | 有效值：維修完成/上門檢測/重新預約/需轉鑒定/轉派師傅/**申請配件** | | operator | Y | N | 操作人 | 操作人的姓名，如張三 | | remarks | Y | N | 辦理備注信息 | key值 | | parts | N | N | 配件信息 | 維修完成/**申請配件**時，師傅如使用了配件需要將使用的配件信息進行回傳，以便后續核銷 | | yunmi\_code | Y | N | 云米配件編碼 | **申請配件**必填<br>師傅維修完成使用了配件也要回傳 | | count | Y | N | 配件使用數量 | **申請配件**必填<br>師傅維修完成使用了配件也要回傳 | | data | Y | N | 工單處理參數 | key值 | | mi\_sn | Y | N | 產品SN碼<br><br>當產品為空調時該參數為空調室外機SN | 維修完成/上門檢測/需轉鑒定/**申請配件**必填，如：000006/00000034 | | djfwsgdbh | N | N | 配件申請工單單號或唯一申請標識 | 申請配件必填 | | kt\_sn | Y | N | 空調內機產品信息<br><br>工單產品為空調時室內機SN與室外機必填一個，其參數請參考同類參數 | 維修完成/上門檢測/需轉鑒定，如：\[{"mi\_sn":"000006/00000034","service\_measures":"","fault\_type":"","parts":\[... (等同于handle.parts)\]},{"mi\_sn":"000006/00000035","service\_measures":"","fault\_type":""}\]，mi\_sn為空調外機SN碼，kt\_sn為空調內機產品SN碼/服務措施/故障類別 | | mi\_purchase\_time | Y | N | 購買日期 | 維修完成/上門檢測/需轉鑒定必填 格式為：2018-12-27 15:30:00 | | service\_measures | Y | N | 服務措施 | 維修完成/上門檢測必填，其他辦理方式（node）值非必填 | | fault\_type | Y | N | 故障類型 | 維修完成/上門檢測/需轉鑒定必填 故障類型有三級，格式為： 一級故障/二級故障/三級故障 不同的產品有不同的故障，請使用"故障類型"接口獲取故障類型的數據 至少3級 | | attachment | Y | N | 維修完成/上門檢測/申請配件時的圖片，必須4張（一組）；<br>當工單中的產品品類為空調類時，每個空調內外機都需對應一組4張照片； | 維修完成/上門檢測/需轉鑒定必填 如：\["...","","","..."\]圖片的url地址 | | time\_of\_appointment | Y | N | 和客戶預約上門的時間 | 重新預約必填，格式為：2018-12-27 15:30:00 | | worker\_error\_desc | Y | N | 故障記錄 | 需轉鑒定必填 故障的文字性說明 | | check\_validate\_result | Y | N | 檢驗鑒定結果 | 需轉鑒定必填，有效值：性能故障、外觀瑕疵、物流破損、無；可以多選，多個值之間使用英文逗號分隔 | | check\_validate\_detail | Y | N | 檢驗鑒定結果詳情 | 需轉鑒定必填，鑒定結果詳情的文字性說明 | | pack\_validate | Y | N | 包裝鑒定 | 需轉鑒定必填，有效值：紙箱缺損、泡沫缺損、說明書缺損、相關配件缺損、無缺損。可以多選，多個值之間使用英文逗號分隔 | | pack\_validate\_detail | Y | N | 包裝鑒定詳情 | 需轉鑒定必填，包裝鑒定詳情的文字性說明 | | 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 | 客戶好評截圖 | \["url","...","..."\]，圖片url | | receive\_parts\_user | N | Y | 收件人 | 配件使用 | | receive\_parts\_phone | N | Y | 收件電話 | **申請配件**使用，必填 | | receive\_parts\_address | N | Y | 收件省市區（中文） | **申請配件**使用；格式:省/市/區；收件省市區(中文）和（國標碼）須任傳其一，優先使用（國標碼） | | spjdqssqjd | N | Y | 收件省市區（國標碼） | **申請配件**使用；12位國標碼數字。收件省市區(中文）和（國標碼）須任傳其一，優先使用（國標碼） | | receive\_parts\_address\_detail | N | Y | 收件詳細地址 | **申請配件**使用，必填 | * 不同流程節點辦理說明：維修完成—下一節點待“申請完工”；上門檢測—下一節點待“工單回訪”；重新預約—**重新預約操作時間不能晚于上一次與客戶上門的時間** 下一節點待“上門打卡”；轉派師傅—下一節點待“預約上門”。 * 需轉鑒定—下一節點待“技術鑒定”，無需申請完工。 * 圖片說明： 【維修完成】【上門檢測】上傳4張照片，分別為：3張必填（機器故障部位圖片1、整機SN照片、維修單），1張選填：機器故障部位圖片。 【需轉鑒定】上傳4張照片，分別為機器故障部位圖片（7天無理由退貨類無故障的，可傳產品其他相關照片）、整機SN照片、退換貨鑒定單、產品包裝照片。 \*\*\*\* 當工單中的產品品類為空調類時：\*\* \*\* SN碼回傳：按實際維修的空調外機或內機回傳相應的SN碼，至少回傳一個。 若回傳2個會2個以上SN碼，則每個SN碼對應產品的服務措施、故障類別都需回傳并且至少3級。 **返回參數：** 見[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)的返回參數說明 當辦理方式為“申請配件”時，辦理成功返回“配件申請工單編號”，示例如下： ~~~ {"res":0,"msg":"辦理成功","data":{"order_number":"PJ2101046718771"}} ~~~