| 日期 | 版本 | 描述 | 作者 |
| :-: | :-: | --- | :-: |
| 2018-12-28 | 1.0.1 | \- 版本初始化 | |
| 2019-01-17 | 1.0.2 | \- 創建工單接口調整為一次性可以創建多個產品的工單，入參和出參有調整 | |
| 2019-01-18 | 1.0.3 | \- 增加操作人參數operator | |
| 2019-01-18 | 1.0.4 | \- 各接口功能參數細化 | |
| 2019-01-22 | 1.0.5 | \- 創建工單以產品69碼為識別產品的唯一標識<br/>\- 增加CTC向第三方服務商派單的接口說明 | |
| 2019-02-12 | 1.0.6 | \- 工單來源增加有效值限定<br/>\- 購買渠道增加有效值限定 | |
| 2019-02-21 | 1.0.7 | \- 工單辦結時增加了一些字段<br/>\- 增加獲取故障類型接口 | |
| 2019-03-18 | 1.0.8 | \- CTC系統增加工單撤銷發起接口<br/>\- 增加鑒定接口<br/>\- 工單派發增加子類別sub\_type | |
| 2019-03-30 | 1.0.9 | \- 創建工單接口修改成異步（延時）創建，增加回調機制<br/>\- 增加SN數據錄入接口 | |
| 2019-04-04 | 1.1.0 | \- 更新SN數據錄入接口 | |
| 2019-04-10 | 1.1.1 | \- 更新工單接鑒定接口 | |
| 2019-04-29 | 1.1.2 | \- 創建工單接口增加24小時內除重機制，即24小時內uniqueid相同的請求只受理一次。 | |
| 2019-05-21 | 1.1.3 | 創建工單接口優化為產品69碼或產品SN其中任意必填<br/>工單撤銷新增字段撤銷原因<br/>增加根據用戶電話查詢工單列表接口<br/>增加根據用戶電話、工單編號查詢工單詳細接口<br/>增加工單評價接口 | |
| 2019-05-22 | 2.0.1 | \- 文檔結構調整 | |
| 2019-06-05 | 2.0.2 | \- 更新了退換貨流程<br/>\- 增加申請完單驗證操作<br/>\- 優化參數說明，該參數是否必須、允許為空 | |
| 2019-06-11 | 2.0.3 | \- 增加第三方發送完單驗收碼短信功能 | |
| 2019-06-20 | 2.0.4 | \- 獲取工單詳情接口增加問題描述、服務態度、服務技能、滿意度四個字段<br/>\- 工單評價接口增加服務態度、服務技能兩個字段 | |
| 2019-06-27 | 2.0.5 | 短信鏈接評價接口（主動模式）<br/>維修單增加上傳圖片字段 | |
| 2019-07-02 | 2.0.6 | \- 增加服務商轉派師傅功能節點<br/>\- 增加無法維修需轉鑒定節點 | |
| 2019-07-12 | 2.0.7 | \- 正對來單號碼來修正工單創建、工單列表、工單詳情和工單評價接口<br/>\- 工單列表接口多增加判斷手機號類型字段 | |
| 2019-08-20 | 2.0.8 | \- 增加工單催辦接口（主動模式）<br/>\- 增加維修單轉技術鑒定信息回傳接口（主動模式） | |
| 2019-09-07 | 2.0.9 | \- 工單辦理接口上門打卡節點填寫SN碼更換到處理完成<br/>\- 工單創建接口增加產品型號參數，產品69碼、SN碼、產品型號任意一個報單<br/>\- 增加空調類特殊產品，當工單產品為空調類時：mi\_sn為空調外機SN碼，需回傳空調內機SN碼（kt\_sn） | |
| 2019-09-11 | 2.1.0 | \- 工單派發接口增加產品新參數<br/>\- 工單辦理接口增加空調產品參數 | |
| 2019-10-07 | 2.1.1 | \- 工單辦理接口空調產品參數調整<br>\- 接口說明優化 | |
| 2020-03-10 | 2.1.2 | \- 增加工單投訴接口 | |
| 2020-03-19 | 2.1.3 | \- 增加工單備注接口 | |
| 2020-04-20 | 2.1.4 | \- 投訴辦理回傳接口增加附件上傳 | |
| 2020-04-24 | 2.1.5 | \- 安裝工單增加處理完成時轉鑒定<br>\- 安裝工單技術鑒定結果回傳 | |
| 2020-04-26 | 2.1.6 | \- 派送工單增加關聯服務商，關聯工單編號字段 | |
| 2020-04-29 | 2.1.7 | \- 安裝工單預約上門增加“暫停工單”<br>\- 處理完成回傳圖片調整圖片的base64字符串 | |
| 2020-05-07 | 2.1.8 | \- 獲取故障類別接口三級故障增加服務措施，服務級別 | |
| 2020-05-08 | 2.1.9 | \- 新增等級品SN碼查詢<br>\- 新增產品配件查詢 | |
| 2020-05-27 | 2.2.0 | \- 維修完成增加配件回傳 | |
| 2020-06-02 | 2.2.1 | \- 增加查詢配件出入庫信息及明細接口 | |
| 2020-06-17 | 2.2.2 | \- 增加換貨子流程->送裝流程【業務對接待定】<br>\-維修單，上門檢測“服務措施”必填 | |
| 2020-07-21 | 2.2.3 | \- 建單接口增加回調參數示例說明<br>\- 辦理完成支持url地址圖片 | |
| 2020-07-28 | 2.2.4 | \- 4.3.4.預約上門=>暫停工單節點增加必填參數：暫停原因 | |
| 2020-08-06 | 2.2.5 | \- 新增換貨（送拆裝機）流程<br>\- 新增退貨（拆機）流程 | |
| 2020-08-06 | 2.2.6 | \- 維修流程處理完成需轉鑒定節點新增必填參數“網點信息” | |
| 2020-08-27 | 2.2.7 | \- 安裝流程處理完成需轉鑒定節點新增必填參數“網點信息” | |
| 2020-09-01 | 2.2.8 | \- 出入庫信息及明細查詢返回示例說明優化 | |
| 2020-09-10 | 2.2.9 | \- 優化工單派發參數描述 | |
| 2020-09-29 | 2.3.0 | \- 調整換貨師傅預約上門節點<br>\- 調整退換貨流程師傅送拆裝辦理方式 | |
| 2020-10-24 | 2.3.1 | \- 辦理備注、工單備注命名區分<br>\- 增加拆機流程 | |
| 2020-10-28 | 2.3.2 | \- 維修單撤銷開放，須校驗撤銷申請驗證碼<br>\- 發送短信接口增加發送撤銷申請驗證碼code | |
| 2020-11-24 | 2.3.3 | \- 派送退換貨單子時，如果該退換貨單由安維單轉鑒定時創建，則將原來的師傅名稱回傳 | |
| 2020-12-03 | 2.3.4 | \- 維修單去掉是否故障，故障信息設為必填<br>\- 增加限制：重新預約操作時間不能晚于上一次與客戶預約的上門時間<br>\- SN碼規范校驗，前綴是6位字符、后綴是8位字符 | |
| 2020-12-10 | 2.3.5 | \- 換貨單退回工單增加辦理結果回傳接口 | |
| 2020-12-28 | 2.3.6 | \- 增加客戶信息->客戶類別<br>\- 凈水類產品安裝完成時增加tds校驗規則 | |
| 2020-12-29 | 2.3.7 | \- 退換貨流程處理完成網點自寄接口暫時停用<br>\- 退換貨處理完成所有產品類別轉拉機 | |
| 2021-01-05 | 2.3.8 | \- 增加基于維修流程生成配件申請工單的配件申請流程 | |
| 2021-01-05 | 2.3.9 | \- 增加配件退款流程 | |
| 2021-01-14 | 2.4.0 | \- 增加維修換修流程 | |
| 2021-01-26 | 2.4.1 | \- 退換貨流程增加轉派師傅，重新預約操作節點 | |
| 2021-02-02 | 2.4.2 | \- 退換貨流程增加逆向處置審核就地報廢工單環節 | |
| 2021-02-08 | 2.4.3 | \- 安裝流程增加清洗服務訴求類別，處理完成以清洗完成完單 | |
| 2021-02-23 | 2.4.4 | \- 安裝流程、維修流程停用工單回訪節點<br>\- 維修流程、維修換修流程服務措施必填字段優化 | |
| 2021-03-02 | 2.4.5 | \- 維修流程中申請配件增加收貨信息字段 | |
| 2021-03-26 | 2.4.6 | \- 安裝、維修、拆機、測量、清洗流程增加回訪審核<br>\- 增加獨立的清洗流程接口文檔 | |
| 2021-04-27 | 2.4.7 | \- 維修流程“處理完成”接口，申請配件傳參增加收件地址國標碼 | |
| 2021-05-21 | 2.4.8 | \- 增加師傅邀請碼查詢接口（4.2.18）<br>\- 安裝流程處理完成節點，需轉鑒定增加必填參數故障類別，非必填參數服務措施 | |
| 2021-05-22 | 2.4.9 | \- 門鎖安裝單增加調查問卷URL地址 | |
| 2021-06-10 | 2.5.0 | \- 維修完成“申請配件”attachment參數必填<br>\- 申請配件說明優化 | |
| 2021-06-15 | 2.5.1 | \- 維修流程“預約上門”、“上門打卡”新增“申請配件”流程節點 | |
- 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.回訪審核（主動模式）