AutoX3 API
  • 快速开始
  • 文档说明
    • 阅读说明
    • 更新日志
    • 名词解释
  • 对接说明
    • 接口规范
    • 回调规则
    • 公共参数
  • 最佳实践
    • 对接流程
    • 方案介绍
    • APP对接
  • 标准接口
    • 获取平台访问凭证
    • 获取车辆检测报告
    • 创建接车订单回调
    • 检测报告发布回调
      • 轻度接入:h5检测报告内嵌url
      • 深度接入:完整检测结果数据
    • 车况&保养计划回调
    • 保养计划回调V2
  • 定制接口
    • 同步车辆服务项目信息
    • 同步施工工艺模板信息
    • 同步施工报告结果信息
      • 轻度接入:h5施工报告内嵌url
      • 深度接入:完整施工结果数据
  • APP接口
    • 获取检测项目列表
    • 创建开放平台检测单
    • 获取检测模块列表
    • 获取检测项列表
    • 更新检测模块
    • 发布检测报告
    • 文件上传
    • 字典-获取检测模块字典
  • 常见问题
    • 加密代码DEMO
    • HTTPS设置说明
  • 多语言
    • English
Powered by GitBook
On this page
  • 业务场景
  • 主流程

Was this helpful?

  1. 标准接口

保养计划回调V2

Previous车况&保养计划回调Next同步车辆服务项目信息

Last updated 3 years ago

Was this helpful?

业务场景

  1. 工作人员通过AutoX3技师APP(Intelligent Technician)完成检测。

  2. 保养计划通过JSON形式同步给接入方系统。

  3. 接入方的开发者对完整车况问题清单与保养计划结果数据进行二次开发。

主流程

当技师通过AutoX3 IT App 完成检测单时,以及后续的新增、修改、履行、删除保养计划操作。

消息类型

event.autox3.order.detection.finish.maintenance.v2

消息内容

{
  "content": "JSON 字符串",                            // 见下方content JOSN字符串内容 
  "createTime": 1616502610117,                        // 推送时间戳
  "msgType": "event.autox3.order.detection.finish",   // 推送消息类型
  "msgSignature": "${hashCode}",                      // 消息签名
  "msgId": "e6ddea1d-0b8b-24e7-cb26-91c3aa0969db",    // 推送消息 id
  "staffInfo": {                       // 员工信息
    "areaCode": "+44",                 // 所属国家区号
    "brandId": 114,                    // 品牌id
    "mobile": "17666166190",           // 手机号
    "staffId": 380,                    // 员工id
    "staffName": "A梦 哆啦",            // 员工名称
    "storeId": 84                      // 店铺id
  }
}        

content JSON 字符串内容

{
  "carMaintenancePlanList": [      // 保养计划列表
    {
      "action": "MODIFY",	   // 变更动作,ADD (新增)、MODIFY(修改)、FINISH(履行)、DELETE(删除)
      "checkpointList": [	   // 检测点列表,如果不为空,表示从检测点生成
        {
          "checkpointId": 7337,    // 检测点 id	
          "conditionId": 18674     // 检测点答案 id
        }
      ],
      "currentMiles": 6669,	   // 当前里程
      "id": 3267,		   // 保养计划 id
      "inspectionOrderId": 5637,   // 检测单id (如果从检测单生成)
      "nextReplaceCycleKm": 6891,  // 下次保养里程 (KM)
      "perMiles": 2.0,		   // 日均行驶里程 (KM)
      "reductionType": "TIME",     // 保养计划类型:MILE (按行驶里程)、TIME(按行驶时间)
      "reductionTypeDesc": "按行驶时间",
      "serviceBaseName": "service not having technology", // 保养计划待履行项目名称
      "serviceBaseSn": "service 0010704051301",	          // 保养计划待履行项目 sn
      "warningDate": "2022-06"				  // 预计保养时间
    }
  ],
  "carNum": "MZ65137"	          // 车牌号		
}

开发者正常响应数据

{
	"data":null,
	"errorInfo":"",              // 错误信息
	"status":0		     // 0表示正常接收
}

请注意:

  1. 关于重试的消息排重,推荐使用msgId排重。

  2. AutoX3服务器未收到正常响应时,会发起重试,总共重试六次,间隔时间为60s。

  3. 签名规则 sha1(msgId + msgType + staffInfo + createTime + content + appSecret)。