**简要描述：** * 调用时机：师傅上门处理完成的时候调用。 **接口参数：** ``` { "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"}} ~~~