**简要描述:**
* 当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.回访审核(主动模式)