OpenAPI
  • Quick Start
  • Documentation
    • Instruction
    • Log Update
    • Glossary
  • Integration Instruction
    • Interface Specification
    • Callback Rules
    • Public Parameters
  • Best Practice
    • Integration Procedures
    • Integration Solution
  • Standardized Interface
    • Obtain Platform Access Credentials
    • Obtain Vehicle Health Check Report
    • Create Service Order Callback
    • Release Health Check Report Callback
      • Basic Integration: Embedded URL to H5 Health Check Report
      • Deep Integration: Comprehensive Health Check Result Data
    • Vehicle Condition & Maintenance Plan Callback
  • Customized Interface
    • Synchronize Vehicle Service Item Info
    • Synchronize Work Procedure Info
    • Synchronize Work Report Info
      • Basic Integration: Embedded URL to H5 Work Report
      • Deep Integration: Comprehensive Work Result Data
  • FAQ
    • Code Encryption DEMO
    • HTTPS Settings Instruction
  • ⚙️Translation
    • 简体中文
Powered by GitBook
On this page
  • Business Scenario
  • Main Process
  • Interface Information

Was this helpful?

  1. Standardized Interface

Create Service Order Callback

PreviousObtain Vehicle Health Check ReportNextRelease Health Check Report Callback

Last updated 3 years ago

Was this helpful?

Business Scenario

  1. The staff completes the vehicle check-in process through the AutoX3 Intelligent Technician app and fills in the required information.

  2. Synchronize vehicle information and the service order to the access system.

Main Process

Interface Information

Message Type:

event.autox3.order.receivebase.create

Message Content:

{
  "content": {
      "carInfo": {                            // Vehicle info 车辆信息
        "carBrandName": "BMW",                // Brand 品牌
        "carNum": "JING",                     // License plate车牌号
        "carOwnerFirstName": "xiaohaha",      // Car owner车主名
        "carOwnerGender": "FEMALE",           // Car owner gender 车主性别
        "carOwnerLastName": "Brown",          // Car owner last name 车主姓
        "carOwnerMobile": "",                 // Car owner phone number 车主手机号
        "carProductionDate": 1325347200000,   // Vehicle manufacture date车辆出厂日期
        "carStyleName": "5",                  // Vehicle trim车款信息
        "carVin": "123456"                    // Vehicle VIN number 车辆vin
        },
      "preCheckInfo": {                       // Pre-service inspection information 初检信息
        "lightInfo": [                        // Fault code information 故障灯信息staffInfo
          "20_Engine Malfunction",
          "16_insufficient engine oil",
          "1_Open Window",
          "15_Abnormal fluid Tempreture",
          "19_Air bag Malfunction"
        ],
        "odograph": 67000.0,                    // Odometer reading 进厂里程
        "oilGauge": 100,                        // Oil gauge reading 进厂油量
        "paintsInfo": [                         // Appearance condition 外观情况
          {
            "describe": "Damp",                  // Status description状态情况
            "images": [                         // Images 图片
              "${url}"
            ],
            "position": "sys_feature_0013_01",  // Position description 位置名称
            "positionName": "Front Passenger Door"          // Position位置
          }
        ],
        "personalItemList": [                   // Personal item list物品清单
          "Golf Bag",
          "Bottle",
          "Scrafs"
        ],
        "remark": "Old Customer"                // Remark 备注
      },
      "receiveBaseId": 6482,               // AutoX3 Service order ID AutoX3接车单id
      "staffInfo": {                       // 接车单操作人信息
        "areaCode": "+44",                 // 品牌id
        "brandId": 1,                      // brandId
        "mobile": "15010524574",           // 手机号
        "storeId": 3,                      // 店铺id-
        "userId": 18,                      // 用户id-
        "userName": "yang xing xingxing2"  // 用户名称
      }
    }
  },
  "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
  }
}        

Developer Normal Response Data:

{
	"data":null,
	"errorInfo":"",    // Error info
	"status":0		     // 0 stands for successful callback reception
}
  1. For the deduplication process, msgid is recommended.

  2. When the AutoX3 server does not receive a normal response, it will initiate a retry six times, with intervals of 2s, 4s, 8s, 16s, 32s, and 64s.

  3. Signature rule: sha1(msgId + msgType + staffInfo + createTime + content + appSecret).