**简要描述：**
* 第三方系统中的工单流程发生变化时调用该接口，用于同步更新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 | 返回结果 | 固定值：空 |
- 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.回访审核（主动模式）