**简要描述：** * 第三方系统中的工单流程发生变化时调用该接口，用于同步更新CTC系统中的工单状态，如网点将工单派发给师傅了，师傅和客户预约好了上门安装、师傅上门处理完成等。本节只是针对工单办理的数据格式进行定义，具体参数请查看对应工单类型的章节。工单类型及办理方式对应关系如下： | 工单类型 | 办理方式 | 是否必须 | | --- | --- | --- | | 安装 | 派送师傅 | 是 | | | 预约上门 | 是 | | | 上门打卡 | 是 | | | 处理完成 | 是 | | | 申请完单 | 当“处理完成”节点的node值=安装完成时，必须 | | 维修 | 派送师傅 | 是 | | | 预约上门 | 是 | | | 上门打卡 | 是 | | | 处理完成 | 是 | | | 申请完单 | 当“处理完成”节点的node值=维修完成时，必须 | | 鉴定 | 派送师傅 | 是 | | | 预约上门 | 是 | | | 上门打卡 | 是 | | | 处理完成 | 是 | | | 申请完单 | 当“处理完成”节点的node值=鉴定完成时，必须 | | 送装 | 收货地址 | 是 | | | 工厂发货 | 是 | **接口地址：** * `http://ip/doscall/oa/api/handle_order/` **参数示例** ``` { "key": "77963b7a931377ad4ab5ad6a9cd718aa", "data": { "order_number": "……", "handle": { "way": "派送师傅", "node": "派送师傅", "operator": "操作人", "remarks": "操作备注" }, "data": { …… } } } ``` **参数：** | 名称 | 是否必须 | 允许为空 | 描述 | 附加说明 | | --- | --- | --- | --- | --- | | order\_number | Y | N | 工单编号 | 必须，用于标记当前操作的是哪个工单，由创建工单的接口返回 | | handle | Y | N | 办理方式 | key值 | | way | Y | N | 操作方式 | | | node | Y | N | 流程节点 | | | operator | Y | N | 操作人 | 操作人的姓名，如张三 | | remarks | Y | N | 办理备注信息 | | | data | Y | N | 工单处理的参数 | key值 | | …… | | | 其他参数 | 工单不同的操作方式，参数不同 | **返回示例** ``` { "res": 0, "msg": "", "data": { …… } } ``` **返回参数说明** | 名称 | 描述 | 附加说明 | | --- | --- | --- | | res | 0成功，其他值为失败 | 有效值：0/1/2/3/4/5/6/7 | | msg | 消息说明 | 0：办理成功1：签名无效2：参数有误3：流程错误4：办理方式错误5：办理参数有误6：验收码错误7：SN码有误 | | data | 返回结果 | 固定值：空 |