| 日期 | 版本 | 描述 | 作者 |
| :-: | :-: | --- | :-: |
| 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.回访审核（主动模式）