**簡要描述：** * 第三方系統如APP、網站、小程序等可以使用該接口在CTC系統中創建工單，目前支持創建安裝單和維修單。當前系統工單增加了延時創建的功能，即CTC接收到第三方系統創建工單的請求時并沒有立即執行創建工單的操作，而是在指定時間后再進行工單創建，所以創建工單的接口只返回請求是否執行成功，當系統執行工單創建的時候再將工單創建的結果通過回調的方式通知到第三方系統。 **創建工單接口地址：** * `http://IP/doscall/oa/api/add_order/` **回傳創建結果接口地址：** * `callback 參數值（需第三方系統提供）` **參數示例** ``` { "key": "……", "data": { "handle": { "way": "安裝/維修", "operator": "操作人", "remarks": "備注" }, "callback": "http://www.abc.com", "order": { "contacts": "張先生", "contacts_phone": "13373911111", "address": "省/市/區/街道", "address_detail": "詳細地址", "type": "安裝", "source": "有品在線", "payment_object": "其他", "expected_service_time": "2018-12-26 17:00:00", "uniqueid": "15458070101702606" }, "product":[{ //產品一 "product_69_code": "69碼", "mi_sn": "000074/00033725", "product_model": "MR414", "mi_purchase_channel": "小米有品", "mi_order_number": "", "mi_purchase_time": "", "inner_guarantee": "" }, { //產品二 "product_69_code": "69碼", "mi_sn": "000074/00033726", "product_model": "MR414", "mi_purchase_channel": "小米有品", "mi_order_number": "", "mi_purchase_time": "", " inner_guarantee": "保外" }, ……], "pictures":["圖片base64字符串1","圖片base64字符串2",...] } } ``` **參數：** | 名稱 | 是否必須 | 允許為空 | 描述 | 附加說明 | | --- | --- | --- | --- | --- | | handle | Y | N | 辦理方式 | key值 | | way | Y | N | 操作方式 | 有效值：安裝/維修<br/>"安裝"為創建安裝單<br/>"維修"為創建維修單 | | operator | Y | N | 操作人 | 操作人的姓名，如張三 | | remarks | Y | Y | 辦理備注信息 | | | callback | Y | N | 回調地址 | 當工單執行創建的操作時，系統將工單的創建結果通知到該回調地址，如果地址為空則不進行回調 | | order | Y | N | 工單信息 | key值 | | contacts | Y | N | 用戶姓名 | | | contacts\_phone | Y | N | 用戶號碼 | | | call\_phone | Y | N | 用戶來電號碼或是app端注冊號碼等 | 非其它要求可填寫與上面字contacts\_phone一樣的號碼即可 | | address | Y | N | 省市區街道 | 省/市/區/街道，可以是四級地址，至少要三級地址，格式不能錯，如：廣東省/深圳市/龍崗區/布吉街道 | | address\_code | Y | N | 省市區街道國標碼 | address必填一個 | | address\_detail | Y | N | 詳細地址 | | | type | Y | N | 工單類型 | 有效值：安裝、維修 | | source | Y | N | 工單來源 | 有效值：佛山400、京東客服、 天貓客服、有品客服、蘇寧客服、深圳400、云米商城微信公眾號、云米商城小程序、云米商城APP、門店、天貓訂單轉單、有品訂單轉單、拼多多訂單轉單、云米商城訂單轉單 、VOIMI生活館轉單 | | payment\_object | Y | N | 付款對象 | 有效值：合作方、客戶 | | expected\_service\_time | Y | Y | 客戶期望上門時間 | 如2018-12-20 10:00:00 | | uniqueid | Y | N | 唯一標識 | 用于去重判斷，系統會自動忽略24小時內uniqueid相同的請求。 | | product | Y | N | 產品信息 | key值，是一個數組，可以傳遞多個產品 | | product\_69\_code | Y | N | 產品69碼 | 必填，SN碼、產品69碼、產品型號其中一個必填 | | mi\_sn | Y | N | SN碼 | 必填，SN碼、產品69碼、產品型號其中一個必填 | | product\_model | Y | N | 產品型號 | 必填，SN碼、產品69碼、產品型號其中一個必填 | | mi\_purchase\_channel | Y | N | 購買渠道 | 有效值：京東、天貓、蘇寧、有品、云米商城、線下門店、 天貓分銷、京東分銷、蘇寧分銷、拼多多、VIOMI生活館、云集 | | mi\_order\_number | Y | Y | 訂單編號 | | | mi\_purchase\_time | Y | N | 購買時間 | 如：2018-12-14 10:21:45 | | inner\_guarantee | Y | N | 保內保外 | 有效值：保內/保外 | | pictures | Y | Y | 維修圖片 | key值，是一個數組，數組里面圖片傳遞形式是base64字符串,沒有圖片，就傳空數組,安裝單需傳空數組 | **返回示例** ``` { "res": 0, "msg": "", "data": [{ //產品一 "res": "返回碼", "msg": "返回碼說明" }, { //產品二 "res": "返回碼", "msg": "返回碼說明" }, ……] } ``` **返回參數說明** | 名稱 | 描述 | 附加說明 | | --- | --- | --- | | res | 0成功，其他值為失敗 | 只表明接口調用成功，不表示工單創建成功 | | msg | 消息說明 | | | data | 返回結果 | key值 | **備注** | 名稱 | 描述 | 附加說明 | | --- | --- | --- | | res | 返回碼，0、1、2、3、4 | 0：成功，1：產品無法識別，2：該產品不提供上門安裝服務，3：缺少產品69碼，4：重復請求 | | msg | 返回碼說明 | 0：成功，1：產品無法識別，2：該產品不提供上門安裝服務，3：缺少產品69碼，4：該工單已存在 | **回傳建單結果參數示例** ``` { "key":"xxxxxxxxxx", "data":{ "uniqueid":"202006080000005171", // 建單時傳的uniqueid "product":{ "1":{ "res":0, // 0為成功 其他失敗 "msg":"創建成功", // 結果說明 "order_number":"AZ2007216229287" // 建單成功的工單編號 } } } } ```