**简要描述：** * 第三方系统如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" // 建单成功的工单编号 } } } } ```