你当前位置-首页-行业公告

汽车维修电子健康档案对接接口说明文档

  • 发布时间:2019-11-20 10:30:28
  • 浏览次数:116
  • 来源:深圳市汽车维修行业协会


汽车维修电子健康档案对接接口说明文档

一、 概述

a) 本文档为规范维修企业ERP在与市级汽车维修行业协会服务系统(以下简称“市平台”)进行数据对接,定义企业ERP上传汽车维修电子健康档案数据至“市平台”的开发接口。

b) 根据汽车维修电子健康档案系统建设标准(JT/T1132-2017)、《交通运输部办公厅关于开展汽车维修电子健康档案系统建设工作的通知》(交办运〔201769号)文件通知,维修企业应实时、全部、自动上传维修记录数据的要求,由“市平台”提供数据接口,供维修企业ERP系统进行调用完成数据上报。

c) 本文档所定义接口适用于市维修企业ERP上传数据接口调用开发。

二、 数据接口规范

第一章 

第二章 

接口调用方法

POST

接口请求内容格式

JSON

返回结果码定义(适用所有接口返回)

返回码

意义

000

操作成功

100

请求方式错误(只支持POST方式请求)

101

参数不正确(格式不正确或必填参数为空)

102

城市区域代码错误

103

尚未登录或者登录已过期

104

相关区域下无对应企业机构

105

企业机构已注销

106

企业机构已注册,请勿重复注册

107

用户名或密码错误

108

用户已注销

109

相关区域下无对应用户

110

送修日期不能超出结算日期!

111

日期格式异常!

201

数据不符合业务处理要求

500

系统异常,请联系接口提供方

接口说明

接口1:获取企业登陆凭证

接口调用触发条件:

本接口为身份验证接口,在调用本说明的其它接口时,均需要先调用本接口进行身份验证,获取登录凭证。

接口调用地址

http://gdsz.qxjgxt.com/api/restapi/upload/login

传入参数表

参    数

参数说明

数据类型

是否必填

长度

代码表

描述

username

维修企业数据上传账号

String

20


企业在“市平台”备案成功后,由“市平台”使用部门分配

password

维修企业数据上传密码

String

20


企业在“市平台”备案成功后,由“市平台”使用部门分配

返回参数

字段名

参数说明

数据类型

描述及要求

code

结果状态码

string

参考返回结果码定义

status

返回描述

string

参考返回结果码定义

access_token

接口调用凭证

string

接口调用凭证,有效期2小时

接口参数示例

{

"username":"test" ,

"password":"123456",

}

接口返回示例

{

"code":"000",

"status":"操作成功",

"access_token":"3303ce5b02bdb08447f086fcdc5920f9"

}

接口2:维修数据上传

接口调用触发条件

维修竣工、出厂时调用本接口完成维修数据上传。

接口调用地址

http://gdsz.qxjgxt.com/api/restapi/upload/fixinfo

传入参数表

参    数

中文描述

数据类型

是否必填

长度

描述

access_token

接口调用凭证

String

100

取自接口1返回参数。

basicinfo

维修基础信息

Json对象


点击查看具体结构

vehiclepartslist

维修配件列表

Json数组


点击查看具体结构

repairprojectlist

维修项目列表

Json数组


 

点击查看具体结构

维修基础信息结构(basicinfo

 

参数

中文描述

数据类型

是否必填

长度

描述

vehicleplatenumber

车牌号码

字符型

12

格式参考:“蒙A12345”

brand

车辆品牌

字符型

50

(与机动车登记证一致的汽车生产制造企业名称),如奥迪、宝马

series

车系

字符型

50

如奥迪A6、宝马X

brandmodel

车型

字符型

200

(与机动车行驶证一致的汽车品牌及型号总称)

companyname

维修企业名称

字符型

200


vin

车辆识别代码

字符型

17


repairdate

送修日期(YYYYMMDD)

数字型

YYYYMMDD

格式:20100808

repairmileage

送修里程

数字型

8


settledate

结算日期 (YYYYMMDD)

日期型

YYYYMMDD

格式:20100808

faultdescription

故障描述

字符型

200


costlistcode

结算清单编号

字符型

50


color

车牌颜色

字符型

10


name

车主姓名

字符型

50


telephone

车主联系电话

数字型

11


servicecategory

维修类别

字符型

50

参考3.4维修类别代码表

fueltype

燃油类别代码

字符型

50

参考3.1燃油类别代码表

nature

车辆使用性质代码

字符型

50

参考3.3车辆使用性质代码表

vehicletype

车辆类别

字符型

50

参考3.2车辆类型代码表

engineno

汽车的发动机号码

字符型

50


img

车辆的外观照片(file类型)

Base64图片码

Jpeg

将图片文件转成Base64编码

registdate

机动车行驶证登记日期(YYYYMMDD)

日期型

YYYYMMDD

格式:20100808

productiondate

机动车行驶证发证日期(YYYYMMDD)

日期型

YYYYMMDD

格式:20100808

vehicleRepairCertificateNumber

竣工合格证编号

字符型

50


vehicleRepairRegistrar

登记人员

字符型

20


 

维修配件列表结构(vehiclepartslist

参数

中文描述

数据类型

是否必填

长度

描述

fittingmodel

配件型号规格

字符型

50


partsname

配件名称

字符型

50


partscode

配件编码

字符型

50


partsquantity

配件数量

数字型

12


维修项目列表结构(repairprojectlist

参数

中文描述

数据类型

是否必填

长度

描述

repairproject

维修项目

字符型

1000


workinghours

维修工时

数字型



 

 

返回参数表

字段名

参数说明

数据类型

描述及要求

code

结果状态码

string

参考返回结果码定义

status

返回描述

string

参考返回结果码定义

接口参数示例

{

"access_token": "eyJhbGciOiJIUzI1NiJ9.eyJlbnRpZCI6IjU3IiwiZXhwIjoxNTM4MjEwNTkzLCJpYXQiOjE1MzgyMDMzOTMsImp0aSI6InRva2VuSWQiLCJ1c2VybmFtZSI6IjE0MDEwOTAwMDAxOTIxMiJ9.q95SHZxcfLJLxJCe2OaFCCn0EbRK1bTqe7whvyWRgso",

 

"basicinfo": {

"vehicleplatenumber": "520U4",

"brand": "奥迪",

"series": "Q5",

"brandmodel": "2.0TFSI豪华型2010",

"companyname": "中鑫之宝汽车销售服务有限公司",

"vin": "3de69a7dc137mlml9",

"repairdate": "20180928",

"repairmileage": "7",

"settledate": "20180928",

"faultdescription": "后车车灯损坏",

"costlistcode": "S55622"

},

"vehiclepartslist": [{"partscode":"233","partsquantity":"2","partsname":"大灯"},{"partscode":"233","partsquantity":"2","partsname":"大灯"}],

"repairprojectlist": [{"repairproject":"测试","workinghours":"20.5"}]

}

接口返回示例

{

"code": "000",

"status": "操作成功"

}


代码表

第三章 

三.1 燃料类型

 

代码值

中文描述

A

汽油

B

柴油

C

电(以电能驱动的汽车)

D

混合油

E

天然气

F

液化石油气

L

甲醇

M

乙醇

N

太阳能

O

混合动力

Y

无(仅限全挂车等无动力的)

Z

其他

三.2 车辆类别

 

代码值

中文描述

01

小型车

02

大中型客车

03

大型货车

99

其他

 

三.3 车辆使用性质

 

代码值

中文描述

01

营运

02

非营运

三.4 维修类别

 

代码值

中文描述

01

零件修理

02

汽车小修

03

总成修理

04

汽车大修

05

日常维护

06

一级维护

07

二级维护

三.5 车牌颜色

 

代码值

中文描述

1

蓝色

2

黄色

3

黑色

4

白色

5

绿色

6

黄绿

8

农黄

9

其他

 


文档下载地址:

深圳市汽车维修电子健康档案对接上传接口说明.docx


  • 私家车
  • 营运车
  • 汽修企业管理
  • 汽修联盟
  • 汽修人才
  • 配件供应
  • 汽修论坛
深圳市机动车维修行业服务平台版权所有 All rights reservd   粤ICP备17026579号管理员登录