**簡要描述：**
* 第三方系統中的工單流程發生變化時調用該接口，用于同步更新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.回訪審核（主動模式）