**簡要描述:**
* 當CTC系統中的工單需要派發給第三方服務商系統處理時,第三方服務商系統可以根據該文檔的定義規范,提供工單接收接口。第三方服務商是指安時達等。此接口的調用方為CTC系統,被調用方為第三方服務商系統。
**接口地址:**
* `由第三方服務商系統提供,接口地址為一個http的url地址。`
**參數示例**
```
{
"key": "……", //CTC系統指定
"data": {
"order_number": "……",
"handle": {
"way": "工單派發",
"operator": "操作人",
"remarks": "備注"
},
"order": {
"type": "安裝",
"sub_type": "報單安裝",
"contacts": "張先生",
"contacts_phone": "13373911111",
"address": "省/市/區/街道",
"address_detail": "詳細地址",
"source": "有品客服",
"payment_object": "其他",
"expected_service_time": "2018-12-26 17:00",
"complain_order_number": "關聯工單編號",
"complain_network_number": "關聯服務網點",
"uniqueid": "15458070101702606",
"send_customer_courier_company": "順豐",
"send_customer_logistics_number": "123456789",
"dcwj": "http://調查問卷URL地址"
},
"customer": {
"level": "至尊VIP"
},
"product": {
"product_name": "產品名稱",
"product_model" : "產品型號",
"product_type" : "產品類別",
"product_big_type" : "產品品類",
"product_69_code": "69碼",
"mi_sn": "000074/00033725",
"mi_purchase_channel": "有品",
"mi_order_number": "",
"mi_purchase_time": "",
"inner_guarantee": ""
},
"kt_product": [{
"product_name": "產品名稱",
"product_model" : "產品型號",
"small_type" : "產品類別",
"big_type" : "產品品類",
"product_69_code": "69碼",
"sn": "000094"
}, {
"product_name": "產品名稱",
"product_model" : "產品型號",
"small_type" : "產品類別",
"big_type" : "產品品類",
"product_69_code": "69碼",
"sn": "000097"
}]
}
}
```
**參數:**
| 名稱 | 是否必須 | 允許為空 | 描述 | 附加說明 |
| --- | --- | --- | --- | --- |
| order\_number | Y | N | 工單編號 | CTC系統的工單編號 |
| handle | Y | N | 辦理方式 | **key值** |
| way | Y | N | 操作方式 | 固定值:工單派發 |
| operator | Y | N | 操作人 | 操作人的姓名,如張三 |
| remarks | Y | Y | 辦理備注信息 | |
| customer | Y | N | 客戶信息 | **key值** |
| level | Y | N | 客戶類別 | 有效值:普通客戶、VIP客戶、大屏VIP、套裝VIP、鉆石VIP、至尊VIP |
| order | Y | N | 工單信息 | **key值** |
| type | Y | N | 工單類型 | 有效值:安裝、維修、鑒定、退貨、換貨 |
| sub\_type | N | Y | 子類別 | 有效值:<br>安裝》報單安裝、上門檢測、上門測量、清洗服務 <br>維修》報單維修、上門檢查 |
| contacts | Y | N | 用戶姓名 | 如:張先生 |
| contacts\_phone | Y | N | 用戶號碼 | 如:13800138000 |
| address | Y | N | 省市區街道 | 省/市/區/街道,可以是四級地址,至少要三級地址,格式不能錯,如:廣東省/深圳市/龍崗區/布吉街道 |
| address\_detail | Y | N | 詳細地址 | 如:XXXX路 XX號 XXX 小區 |
| source | Y | N | 工單來源 | 有效值:佛山400、京東客服、 天貓客服、有品客服、蘇寧客服、深圳400、云米商城微信公眾號、云米商城小程序、云米商城APP、門店、天貓訂單轉單、有品訂單轉單、拼多多訂單轉單、云米商城訂單轉單 、VOIMI生活館轉單 |
| payment\_object | Y | N | 付款對象 | 有效值:合作方、客戶 |
| expected\_service\_time | Y | Y | 客戶期望上門時間 | 2019-01-22 10:00:00 |
| complain\_order\_number | Y | Y | 關聯工單編號 | AZ202004261654 |
| complain\_network\_number | Y | Y | 關聯服務商 | 測試服務商 |
| uniqueid | Y | N | 唯一標識 | 用于去重判斷 |
| send\_customer\_courier\_company | N | Y | 回寄客戶物流公司 | 退換貨流程使用,可以不存在或為空 |
| send\_customer\_logistics\_number | N | Y | 回寄客戶物流單號 | 退換貨流程使用,可以不存在或為空 |
| dcwj | N | Y | 調查問卷url地址 | 門鎖安裝單必填 |
| product | Y | N | 產品信息 | key值 |
| product\_name | Y | N | 產品名稱 | 必填 |
| product\_model | Y | N | 產品型號 | 必填 |
| product\_type | Y | N | 產品類別 | 必填 |
| product\_big\_type | Y | N | 產品品類 | 必填 |
| product\_69\_code | Y | N | 產品69碼 | 必填 |
| mi\_sn | Y | N | SN碼 | 必填 |
| mi\_purchase\_channel | Y | N | 購買渠道 | 有效值:京東、天貓、蘇寧、有品、云米商城、線下門店、 天貓分銷、京東分銷、蘇寧分銷、拼多多、VIOMI生活館、云集 |
| mi\_order\_number | Y | Y | 訂單編號 | |
| mi\_purchase\_time | Y | Y | 購買時間 | |
| inner\_guarantee | Y | Y | 保內保外 | |
| kt\_product | N | N | 空調內機 | key值 當產品為空調類產品時必須 |
| product\_name | N | N | 產品名稱 | |
| product\_model | N | N | 產品型號 | |
| small\_type | N | N | 產品類別 | |
| big\_type | N | N | 產品品類 | |
| product\_69\_code | N | N | 產品69碼 | |
| sn | N | N | SN前綴 | |
**返回示例**
```
{
"res": 0,
"msg": "",
"data": {
"number": "……",
}
}
```
**返回參數說明**
| 名稱 | 描述 | 附加說明 |
| --- | --- | --- |
| res | 0成功,其他值為失敗,當接口調用超時時,再次調用請返回成功值 | 有效值:數字 |
| msg | 消息說明 | 對res不同的值文字說明 |
| data | 返回結果 | key值 |
| number | 第三方服務商系統工單編號 | res值為0時number有值,否則該值為空 |
- 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.回訪審核(主動模式)