安徽省机动车检验监管平台接口文档.docx

1、安徽省机动车检验监管平台接口文档安徽省机动车检验监管平台接口使用手册安徽科力信息产业有限责任公司2014年10月8日目 录第一部分 接口调用规范 51、接口访问地址 52、检验流程 62.1检验基本流程 63、接口调用说明 63.1查询 XML格式定义 63.2写入类接口XML文档格式 73.3调用注意事项 83.4返回结果错误代码说明 8第二部分 对外接口说明 91、时间同步接口 91.1接口方法名 91.2接口功能说明 91.3查询参数说明 91.4返回结果XML文档说明 92、车辆信息查询接口 102.1接口方法名 102.2接口功能说明 102.3查询参数说明 102.4返回结果XML

2、文档说明 103、机动车检验登录 123.1接口方法名 123.2接口功能说明 133.3写入参数说明 133.4返回结果XML文档说明 174、机动车复检登录 174.1接口方法名 174.2接口功能说明 174.3写入参数说明 174.4返回结果XML文档说明 185、请求检测过程开始 195.1接口方法名 195.2接口功能说明 195.3写入参数说明 195.4返回结果XML文档说明 206、请求检验项目开始 206.1接口方法名 206.2接口功能说明 206.3写入参数说明 206.4返回结果XML文档说明 217、写检验结果详细数据 227.1接口方法名 227.2接口功能说明

3、227.3写入参数说明 227.4返回结果XML文档说明 408、请求检验项目结束 408.1接口方法名 408.2接口功能说明 408.3写入参数说明 418.4返回结果XML文档说明 419、写检验结果其它信息（整车制动等） 429.1接口方法名 429.2接口功能说明 429.3写入参数说明 429.4返回结果XML文档说明 4310、请求检验过程结束 4310.1接口方法名 4310.2接口功能说明 4410.3写入参数说明 4410.4返回结果XML文档说明 4411、写检验结论 4511.1接口方法名 4511.2接口功能说明 4511.3写入参数说明 4511.4返回结果XML文

4、档说明 4712、机动车检验登录信息修正 4712.1接口方法名 4712.2接口功能说明 4812.3写入参数说明 4813、检测线备案信息下载 5113.1接口方法名 5113.2接口功能说明 5113.3查询参数说明 5114、安检机构工作人员备案信息下载 5814.1接口方法名 5814.2接口功能说明 5814.3查询参数说明 5815、查询车辆所属类别对应检验项目信息 5915.1接口方法名 5915.2接口功能说明 5915.3查询参数说明 6016、请求抓拍照片 6116.1接口方法名 6116.2接口功能说明 6116.3请求参数说明 6116.4返回结果XML文档说明 62

5、17、查询车辆外观检验结果 6217.1接口方法名 6217.2接口功能说明 6217.3请求参数说明 6217.4返回结果XML文档说明 6318、写车辆底盘动态、底盘查验结果（GB21861-2008） 6618.1接口方法名 6618.2接口功能说明 6618.3请求参数说明 6617.4返回结果XML文档说明 70第三部分 相关代码表 701、车辆外观检验结果项目 702、号牌种类代码表 773、车身颜色代码表 774、使用性质代码表 785、车辆状态代码表 786、车辆类型代码表 797、燃料种类代码表 828、国产/进口代码表 839、身份证名称代码表 8310、制造国代码表 84

6、第一部分 接口调用规范1、接口访问地址安徽省检验监管系统对外访问接口地址：http:/ip:port/vehcheckweb/services/OutService?wsdl其中IP标识Web服务器地址；port对应系统应用服务的端口号，启用80的不填写2、检验流程2.1检验基本流程3、接口调用说明3.1查询 XML格式定义 查询车辆信息返回结果XML文档格式：1数据下载成功！ BAA12302 A3.2写入类接口XML文档格式 写入数据文档格式如下： -节点标签 -写入数据字段 写入操作返回XML格式如下：0数据保存成功3.3调用注意事项 （1）接口查询结果进行过URLEncoder和UTF

7、-8编码处理，须进行转换（转换函数为URLDecoder.decode(str,”utf-8”);）才能正常读取中文。 （2）写入信息中文字符必须用URLEncoder变成utf-8编码格式，转换函数为URLEncoder.encode(xmldoc,”utf-8”);（3）XML文档的【写入数据节点】和【返回节点】的标签均为小写字符。XML文档【节点标签】必须和手册中注明的保持一致。（4）注：修订后的GB21861未正式实施前，人工检验项目检验结果 机动车人工检验项目检验结果详细信息(按GB 21861-XXXX) 和 机动车人工检验项目检验结果详细信息(按GB 21861-2008) 都要

8、上传，正式实施后，只上传机动车人工检验项目检验结果详细信息(按GB 21861-XXXX)。3.4返回结果错误代码说明 调用成功与否标记code（0-调用成功；1-调用失败）。失败时message返回详细描述信息。第二部分 对外接口说明1、时间同步接口1.1接口方法名 public String getSynchTime(String jkxlh)1.2接口功能说明检验业务信息系统与检验监管系统时间同步时使用。建议每天同步1-2次。1.3查询参数说明查询条件数据字段如下表。序号字段名字段描述类型长度是否可空备注1jkxlh接口序列号字符由接口提供者提供1.4返回结果XML文档说明序号字段名字段

9、描述类型备注1code调用成功与否标记字符0-成功；1-失败2message消息字符成功时,返回日期，如2014-08-19 13:28:45.678；失败时，返回错误信息。2、车辆信息查询接口2.1接口方法名 public String queryVehicleOut(String jkxlh,String hpzl,String hphm,String clsbdh)2.2接口功能说明车辆检验上线前，查询车辆基本信息。2.3查询参数说明查询条件数据字段如下表。序号字段名字段描述类型是否可空备注1jkxlh接口序列号字符不可空由接口提供者提供2hpzl号牌种类字符不可空号牌种类代码3hphm

10、号牌号码字符不可空填写格式如：“皖AWS345”填写“皖BWS345”、“皖A1234挂”填写“皖A1234”、“皖A1234学”填写“皖A1234”4clsbdh车辆识别代号字符不可空可填写后四位2.4返回结果XML文档说明序号参数项名称类型长度是否可空备注1 xh机动车序号char142 hpzl号牌种类char2号牌种类代码3 hphm号牌号码varchar2154 clpp1中文品牌varchar2325 clxh车辆型号varchar2326 clpp2英文品牌varchar2327 gcjk国产/进口char1国产/进口代码8 zzg制造国char3制造国代码9 zzcmc制造厂名

11、称varchar26410 clsbdh车辆识别代号varchar22511 fdjh发动机号varchar23012 cllx车辆类型char3车辆类型代码13 csys车身颜色varchar25车身颜色代码14 syxz使用性质char1使用性质代码15 sfzmhm身份证明号码varchar218身份证明名称代码16 sfzmmc身份证明名称char117 syr机动车所有人varchar212818 ccdjrq初次登记日期date719 djrq最近定检日期date720 yxqz检验有效期止date721 qzbfqz强制报废期止date722 fzjg发证机关varchar210

12、23 glbm管理部门varchar21224 bxzzrq保险终止日期date725 zt机动车状态varchar2626 dybj抵押标记0-未抵押，1-已抵押char127 fdjxh发动机型号varchar26428 rlzl燃料种类varchar23燃料种类代码29 pl排量number630 gl功率number5,131 zxxs转向形式char10-无，1-方向盘，2-方向把32 cwkc车外廓长number533 cwkk车外廓宽number434 cwkg车外廓高number435 hxnbcd货箱内部长度number536 hxnbkd货箱内部宽度number437 hx

13、nbgd货箱内部高度number438 gbthps钢板弹簧片数number339 zs轴数number140 zj轴距number541 qlj前轮距number442 hlj后轮距number443 ltgg轮胎规格varchar26444 lts轮胎数number245 zzl总质量number846 zbzl整备质量number847 hdzzl核定载质量number848 hdzk核定载客number349 zqyzl准牵引总质量number850 qpzk驾驶室前排载客人数number151 hpzk驾驶室后排载客人数number252 hbdbqk环保达标情况varchar212

14、853 ccrq出厂日期date754 clyt车辆用途char255 ytsx用途属性char156 xszbh行驶证证芯编号varchar22057 jyhgbzbh检验合格标志varchar2203、机动车检验登录3.1接口方法名 public String registerVehicleOut(String jkxlh,String vehXmlDoc)3.2接口功能说明车辆上线前，登录检测车辆信息。3.3写入参数说明写入数据字段如下表。序号字段名字段描述类型是否可空备注1jkxlh接口序列号字符不可空由接口提供者提供2vehXmlDoc请求信息XML格式字符串不可空vehXmlDoc

15、格式内含字段如下表：序号参数项名称类型长度是否可空备注1 jylsh检验流水号varchar217不可空对同一安检机构，此检验流水号必须唯一，下同2 jcxdh检测线代号varchar22可空按检测线备案信息，下同，如：1、2、3、4、5、6、7、8、9、10,3 xh机动车序号varchar214可空4 hpzl号牌种类varchar22可空按GA/T16.7。在用车不可空。5 hphm号牌号码varchar215可空在用车不可空。填写格式如：“苏BAA345”填写“苏BAA345”、“苏B1234挂”填写“苏B1234”，下同。6 clsbdh车辆识别代号varchar225不可空填写完整

16、的VIN号或车架号。7 fdjh发动机/电动机号码varchar230可空8 csys车身颜色varchar25可空按GA/T16.89 syxz使用性质char1可空按GA/T16.310 ccdjrq初次登记日期date可空按“yyyy-mm-dd”格式填写11 jyrq最近定检日期date可空按“yyyy-mm-dd”格式填写12 jyyxqz检验有效期止date可空按“yyyy-mm-dd”格式填写13 bxzzrq保险终止日期date可空按“yyyy-mm-dd”格式填写14 rlzl燃料种类varchar23可空可同时输入三种，每种按GA/T16.915 gl功率number5,1

17、可空单位为千瓦（kw），四位整数，一位小数16 zs轴数number1不可空17 zj轴距number5可空单位为毫米（mm）18 qlj前轮距number4可空单位为毫米（mm）19 hlj后轮距number4可空单位为毫米（mm）20 zzl总质量number8不可空单位为千克（kg）21 zbzl整备质量number8不可空单位为千克（kg）22 ccrq出厂日期date不可空按“yyyy-mm-dd”格式填写23 qdxs驱动形式(驱动轴位)varchar25不可空组合串:如1234(1表示一轴.)24 zczs驻车轴数number1可空摩托车无此参数25 zczw驻车轴位varcha

18、r25可空组合串:如1234(1表示一轴.)26 zzs主轴数number1可空27 zzly制动力源char1可空0-气压制动，1-液压制动，2-气推油制动28 qzdz前照灯制varchar22可空01-四灯远近光，02-四灯远光，03-二灯远近光，04-二灯近光，05-一灯远光29 ygddtz远光单独调整char1可空0-不能单独调整，1-单独调整30 zxzxjxs转向轴（前轴）悬架形式char1可空0-独立悬架，1-非独立悬架31 lcbds里程表读数number8可空单位为千米（km）32 jyxm检验项目varchar2100不可空多值，英文半角逗号分隔。各项目代码为：F1-车

19、辆外观检验C1-底盘检验DC-动态底盘检验B1-一轴制动B2-二轴制动B3-三轴制动B4-四轴制动B5-五轴制动B6-六轴制动B0-驻车制动H1-左外灯或二三轮机动车的左灯H2-左内灯H3-右内灯H4-右外灯或二三轮机动车的右灯S1-车速表A1-侧滑R1-路试制动R2-路试坡道驻车R3-路试车速表M1-外廓尺寸自动测量33 jylb检验类别varchar22不可空00-注册登记检验，01-在用车检验（定检），02-临时检验，03-特殊检验，04-在用车检验（非定检）34 bhgx不合格项varchar250可空35 ccdlsj初次登录时间date可空按“yyyy-mm-dd hh24:mi:

20、ss”格式填写36 dlsj登录时间date不可空按“yyyy-mm-dd hh24:mi:ss”格式填写37 jycs检验次数number2不可空38 dly登录员varchar230不可空39 ycy引车员varchar230可空40 wjy外检员varchar230可空41 dtjyy动态检验员varchar230可空42 dpjyy底盘检验员varchar230可空43 clpp1车辆品牌varchar232不可空44 clxh车辆型号varchar232不可空45 syr机动车所有人varchar2128可空46 cllx车辆类型varchar23可空在用车不可空47 cwkc车外廓

21、长number5不可空48 cwkk车外廓宽number4不可空49 cwkg车外廓高number4不可空50 clyt车辆用途char251 ytsx用途属性char152 dlysfzh登录员（身份证号）varchar230不可空53 ycysfzh引车员（身份证号）varchar230可空54 wjysfzh外检员（身份证号）varchar230可空55 dtjyysfzh动态检验员（身份证号）varchar230可空56 dpjyysfzh底盘检验员（身份证号）varchar230可空57 clsslb车辆所属类别varchar22不可空01-常规汽车02-全时四驱03-超重04-超宽

22、05-驱动防滑06-双后轴驱动07-挂车08-灯位超高09-多轴车10-其他特种车11-常规（摩托车）58 jcxlb检测线类别char1不可空1-汽车，2-摩托车59 sjr送检人（姓名）varchar230可空60 sjrsfzh送检人身份证号varchar230可空3.4返回结果XML文档说明序号字段名字段描述类型备注1code调用成功与否标记字符0-成功；1-失败2message消息字符失败时，返回错误信息。3pdyj判定依据1-旧标准，2-新标准4、机动车复检登录4.1接口方法名 public String recheckRegisterVehicleOut(String jkxlh

23、,String vehXmlDoc)4.2接口功能说明车辆复检上线前，登录复检检测车辆信息。4.3写入参数说明写入数据字段如下表。序号字段名字段描述类型是否可空备注1jkxlh接口序列号字符不可空由接口提供者提供2vehXmlDoc登记车辆信息XML格式字符串不可空vehXmlDoc内含字段如下表：序号参数项名称类型长度是否可空备注1 jylsh检验流水号varchar217不可空2 jcxdh检测线代号varchar22可空如：1、2、3、4、5、6、7、8、9、10,3 xh机动车序号varchar214可空4 hpzl号牌种类varchar22可空在用车不可空5 hphm号牌号码varchar215可空在用车不可空6 clsbdh车辆识别代号 varchar225不可空填写完整的VIN号或车架号。7 fdjh发动机/电动机号码varchar2