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

这有帮助吗?

  1. 标准接口

车况&保养计划回调

event.autox3.order.detection.finish.maintenance

上一页深度接入:完整检测结果数据下一页获取检测报告详情

最后更新于3年前

这有帮助吗?

业务场景

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

  2. 车况问题清单与保养计划通过JSON形式同步给接入方系统。

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

主流程

当技师通过AutoX3 IT App 完成检测单后。

消息类型

event.autox3.order.detection.finish.maintenance

消息内容

{
  "content": {
    "carMaintenancePlanList": [        // 保养计划列表
      {
        "currentMiles": 1242,          // 当前里程
        "expiredDays": 25,             // 过期天数(大于零:已过期x天;小于零:还有x天过期)
        "expiredMiles": 388,           // 过期里程(大于零:已超过x里程/小于零:还有x里程过期)
        "finish": true,                      // 是否已编辑完成
        "forecastPrice": 10000.0,            // 预测服务项目价格
        "id": 1700,                          // 保养计划id
        "mgtModified": 1622013059000,        // 最近修改时间
        "nextReplaceCycleKm": 854,           // 下次保养里程
        "operator": "yang xingxingxing2",    // 操作人
        "payProbability": 0.0,               // 成交概率
        "perMiles": 15.5342798,              // 平均里程
        "recommend": true,                   // 是否推荐立即保养
        "reductionType": "TIME",             // 维保计划计算类型
        "serviceBaseName": "wash car",       // 服务项目SN
        "serviceBaseSn": "00107040513",      // 服务项目SN Name  
        "warningDate": "2021-05"             // 计划报警日期 
      }
    ],
    "carNum": "KAKA100",                     // 车牌号
    "workProcedureQuestionList": [           // 车况问题列表 
      {
        "optionDescription": "51",           // 检测点问题答案
        "questionBaseDescription": "error-indirect",  // 检测点描述
        "questionBaseId": 5911,              // 检测点ID
        "workProcedureQuestionId": 9133      // 检测记录ID
      }
    ]
  },
  "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
  }
}        

开发者正常响应数据

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

请注意:

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

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

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