机动车检验监管系统接口使用手册.docx

1、机动车检验监管系统接口使用手册机动车检验监管系统接口使用手册公安部交通管理科学研究所 2014年10月第一部分 接口调用规范1.1.接口访问地址检验监管系统对外接口访问地址：http:/ip:port/pnweb/services/TmriOutAccess?wsdl其中IP标识Web服务器地址；port对应系统应用服务的端口号，启用80的不填写。1.2.接口调用函数检验监管系统对外接口包括两类：查询类和写入类接口。查询类接口对外提供查询服务，写入类接口对外提供将业务数据写入检验监管系统业务库。1.2.1.查询类接口public String queryObjectOut(String xtl

2、b,String jkxlh,String jkid,String QueryXmlDoc)表1：查询类接口调用参数说明序号参数名称参数说明备注信息1xtlb系统类别接口提供者的业务类别代码，默认为“18”（代表机动车检验监管系统）2jkxlh接口序列号由外挂系统请求服务平台授权生成下发3jkid接口标识5位，由系统类别C两位接口顺序号组成，用于唯一表示一个接口。4QueryXmlDoc查询条件封装查询条件的XML格式文档1.2.2.写入类接口Public String writeObjectOut (String xtlb,String jkxlh,String jkid,String Wr

3、iteXmlDoc)表2：写入类接口调用参数说明序号参数名称参数说明备注信息1xtlb系统类别同上2jkxlh接口序列号同上3jkid接口标识同上4WriteXmlDoc写入数据业务数据写入XML格式文档1.3.XML文件格式定义1.3.1.查询类接口XML文档查询条件QueryXmlDoc的文档格式要求如下： -节点标签 苏BAA123 02 1234 -车辆识别代号后四位 3200000001 查询返回结果ResultXML文档格式1数据下载成功！1 BAA12302 A1.3.2.写入类接口XML文档写入数据WriteXmlDoc文档格式如下： -节点标签 -写入数据字段 写入操作返回结

4、果Xml文档格式如下： 1 数据保存成功 1.4.调用注意事项1.4.1.XML文档的中文处理（1）接口查询结果进行过URLDecoder和UTF-8编码处理,须进行转换（转换函数为URLDecoder.decode(str, utf-8);）才能正常读取；（2）写入信息中文字符必须URLEncoder成utf-8格式（转换函数为URLEncoder.encode(xmlDoc, utf-8)；）后再封装成XML文档。（3）XML文档的【写入数据字段】和【返回结果字段】的标签均为小写字符。XML文档【节点标签】必须和手册中注明的保持一致。1.4.2.返回结果错误代码说明正常返回结果code为成

5、功与否标记（小于等于0-失败；1-成功，由提供的接口服务定义），网络异常或接口权限异常等系统原因时返回$E的标记。写入失败时的message返回详细描述信息。第二部分 对外接口说明2.1.接口列表检验监管系统提供的信息接口共33个（见下表），其中写照片接口还可参考第四部分提供的方式。序号接口名称接口定义提供者调用者1.检验备案信息查询接口【1】检验机构备案信息【2】检测线备案信息【3】检验机构工作人员备案信息【4】检验业务信息系统备案信息检验监管系统检验业务信息系统2.检验信息写入接口【5】机动车检验登录信息【6】机动车检验过程开始信息【7】机动车检验项目开始信息【8】机动车人工检验项目检验结

6、果详细信息（GB21861-XXXX）【9】机动车人工检验项目检验结果详细信息（GB21861-2008）【10】二、三轮机动车人工检验项目检验结果详细信息（GB21861-2008）【11】仪器设备检验项目检验结果详细信息【12】路试检验信息【13】机动车检验项目结束信息【14】机动车检验过程结束信息【15】机动车检验结果其他信息【16】机动车交通事故责任强制保险信息【17】机动车检验判定结果信息【18】机动车检验照片和资料照片信息【19】机动车检验结果资料申请审核信息【20】机动车复检登录信息检验监管系统检验业务信息系统、检验智能终端系统3.其他查询与写入接口【21】时间同步【22】获取车

7、辆所属类别对应检验项目信息【23】获取机动车对应需拍摄照片和人工检验项目信息【24】获取机动车检验审核不通过信息【25】获取机动车基本信息【26】机动车检验登录信息更正【27】机动车检验视频异常信息【28】检验业务信息系统操作日志【29】写入收费信息【30】机动车检验审核通过信息获取回执【31】机动车检验业务退办【32】读取车管业务流水号【33】互联网检验预约信息下载检验监管系统检验业务信息系统、视频监管系统、检验智能终端系统2.2.检验过程数据接口流程1、上传检验信息基本流程注：修订后的GB21861未正式实施前，人工检验项目检验结果18C80和18C53都要上传，正式实施后，只上传18C8

8、0。2、审核未通过，需补充材料的，通过以下接口重新上传。3、复检具有以下情形之一的，首先进行复检登录，然后再进行后续操作（同1，但外观检验不复检的，可跳过外观检验项目）。1）当机动车检验过程结束，存在不合格项目需要复检的。2）当审核（外观检验）未通过需要复检的。2.3.检验备案信息读取接口定义2.3.1.18C01-检验机构备案信息下载接口类型：查询类接口接口标识：18C01功能说明：根据检验机构编号、更新日期等信息下载检验机构备案信息。处理过程：对接口输入参数进行逻辑校验；查询相应检验机构备案信息。查询文档QueryXmlDoc说明：节点标签QueryCondition，查询条件数据字段如下

9、表：序号参数项名称类型长度是否可空备注1jczbh检验机构编号varchar210不可空2gxrq更新日期date可空返回结果文档ResultXML说明：节点标签vehispara，查询结果数据字段如下表：表1：检验机构备案信息序号参数项名称类型长度是否可空备注1jczbh检验机构编号varchar220不可空2jczmc检验机构名称varchar2128不可空3sflw是否与公安网联网char1不可空1-是，2-否4rdsbh资格许可证书编号varchar232不可空5rdyxqs资格许可有效期始date不可空6rdyxqz资格许可有效期止date不可空7shejirjcnl设计日检测能力(

10、汽车辆)number4不可空8shijirjcnl实际日检测能力(汽车辆)number4不可空9jcryzs检测人员总数number4不可空10wjgwrs外检工位人数number4不可空11lrgwrs录入工位人数number4不可空12ycyrs引车员人数number4不可空13dpgwrs底盘工位人数number4不可空14zjgwrs总检工位人数number4不可空15qtgwrs其他工位人数number4不可空16tgszjbmkhrs通过省级质检部门考核人数number4不可空17wtgszjbmkhrs未通过省级质检部门考核人数number4不可空18fzjg发证机关varcha

11、r210不可空19glbm管理部门varchar212不可空20gxrq更新日期date不可空21bz备注varchar24000可空22shejirjcmtsl设计日检测能力(摩托辆)number4不可空23shijirjcmtsl实际日检测能力(摩托辆)number4不可空24shbj审核标记varchar22可空0-待审核，1-同意，2-不同意25syglbm使用管理部门varchar24000可空26shyj审核意见varchar24000可空27zt状态标记 char1不可空0-撤销，1-正常，2-停用，3-首次备案申请，4-过有效期28ztyy暂停原因varchar2512可空29

12、dwdz单位地址varchar2300不可空30yzbm邮政编码varchar26不可空31xkjyfw许可检验范围varchar2100不可空00-大型车，01-小型车，02-许可路试超检验能力的车，03-上门检验32rdsffdw资格许可发放单位varchar2300不可空33frdb法人代表varchar230不可空34frdbsfzh法人代表身份证号varchar218不可空35frdblxdh法人代表联系电话varchar215不可空36fzr负责人varchar230不可空37fzrsfzh负责人身份证号varchar218不可空38fzrlxdh负责人联系电话varchar215

13、不可空39rclxr日常联系人varchar230不可空40rclxrsfzh日常联系人身份证号varchar218不可空41rclxrlxdh日常联系人联系电话varchar215不可空2.3.2.18C02-检测线备案信息下载接口类型：查询类接口接口标识：18C02功能说明：根据检验机构编号、更新日期等信息下载检测线备案信息。处理过程：对接口输入参数进行逻辑校验；查询相应检测线备案信息。查询文档QueryXmlDoc说明：节点标签QueryCondition，查询条件数据字段如下表：序号参数项名称类型长度是否可空备注1jczbh检验机构编号varchar210不可空2gxrq更新日期dat

14、e可空返回结果文档ResultXML说明：节点标签vehispara，查询结果数据字段如下表：表2：检测线备案信息序号参数项名称类型长度是否可空备注1jczbh检验机构编号varchar220不可空2jcxxh检测线代号varchar22不可空3jczmc检验机构名称varchar2128不可空4jcxmc检测线名称varchar2128不可空5jcxlb检测线类别char1不可空1-汽车，2-摩托车6jcxczfs检测线控制方式char1不可空1-全自动，2-单工位检测，9-其他7zdsbmc制动检测设备名称varchar2128可空8zdsbxh制动检测设备型号varchar232不可空9

15、zdsbsccj制动检测设备生产厂家varchar2128不可空10zdjcsj制动检测最少时间number4不可空11zdjcfs制动检测方式char1可空1-平板，2-滚筒12pbzs平板制式varchar232可空1-二板式，2-四板式13dpbcd单平板长度number5可空14pbjj平板间距number5可空15gtszdtzs滚筒式制动台制式char1可空1-开槽式，2-粘砂式16gtszdttjfs滚筒式制动台停机方式char1可空1-第三滚筒，2-时间停机，3-其它(如可以通过监测制动力,当制动力达到最大停电机)17zdsbqysj制动检测设备启用时间date可空18zdsb

16、jdyxqz制动检测设备检定有效期止date不可空19zdsbzt制动检测设备状态char1不可空1-正常，2-故障维修，3-报废20dgsbmc灯光检测设备名称varchar2128可空21dgsbxh灯光检测设备型号varchar232可空22dgsbsccj灯光检测设备生产厂家varchar2128可空23dgjcsj灯光检测最少时间number4可空24dgjcfs灯光检测方式char1可空1-双灯同检，2-单灯检测25dgcspyxz灯光检测是否有车身偏移修正功能char1可空1-有，2-无26dgsbqysj灯光检测设备启用时间date可空27dgsbjdyxqz灯光检测设备检定有

17、效期止date不可空28dgsbzt灯光检测设备状态char1不可空1-正常，2-故障维修，3-报废29sdsbmc速度检测设备名称varchar2128可空30sdsbxh速度检测设备型号varchar232可空31sdsbsccj速度检测设备生产厂家varchar2128可空32sdjcsj速度检测最少时间number4可空33sdsbqysj速度检测设备启用时间date可空34sdsbjdyxqz速度检测设备检定有效期止date不可空35sdsbzt速度检测设备状态char1不可空1-正常，2-故障维修，3-报废36chsbmc侧滑检测设备名称varchar2128可空37chsbxh侧

18、滑检测设备型号varchar232可空38chsbsccj侧滑检测设备生产厂家varchar2128可空39chjcsj侧滑检测最少时间number4可空40chsbqysj侧滑检测设备启用时间date可空41chsbjdyxqz侧滑检测设备检定有效期止date不可空42chsbzt侧滑检测设备状态char1不可空1-正常，2-故障维修，3-报废43czsbmc称重设备名称varchar2128可空44czsbxh称重检测设备型号varchar232可空45czsbsccj称重检测设备生产厂家varchar2128可空46czjcsj称重检测最少时间number4可空47czjb称重范围num

19、ber6可空设备设计最大承受车辆轴重范围，单位为千克（kg）48czsbjdyxqz称重检测设备检定有效期止date可空49czsbqysj称重检测设备启用时间date不可空50czsbzt称重检测设备状态char1不可空1-正常，2-故障维修，3-报废51qxjcsj全线检测时间number4可空52gw1工位1varchar216可空53gw2工位2varchar216可空54gw3工位3varchar216可空55gw4工位4varchar216可空56gw5工位5varchar216可空57gw6工位6varchar216可空58gw7工位7varchar216可空59gw8工位8va

20、rchar216可空60gw9工位9varchar216可空61bz备注varchar2128可空62fzjg发证机关varchar210不可空63glbm管理部门varchar212不可空64gxrq更新日期date可空65zdsbbh制动检验设备编号varchar230可空66zdsbjdzsbh制动检验设备检定/校准证书编号varchar230可空67dgsbbh灯光检验设备编号varchar230可空68dgsbjdzsbh灯光检测设备检定/校准证书标号varchar230可空69sdsbbh速度检验设备编号varchar230可空70sdsbjdzsbh速度检验设备检定/校准证书标号

21、varchar230可空71chsbbh侧滑检验设备编号varchar230可空72chsbjdzsbh侧滑检验设备检定/校准证书编号varchar230可空73czsbbh称重检验设备编号varchar230可空74czsbjdzsbh称重检验设备检定/校准证书编号varchar230可空75zt状态标记varchar21不可空0-撤销，1-正常，2-停用，3-首次备案申请，4-过有效期76ztyy暂停原因varchar2512可空2.3.3.18C05-检验机构工作人员备案信息下载接口类型：查询类接口接口标识：18C05功能说明：根据身份证明号码、姓名、检验机构编号、更新时间等信息下载检验

22、机构工作人员的基本信息。处理过程：对接口输入参数进行逻辑校验；查询相应检验机构工作人员备案信息。查询文档QueryXmlDoc说明：节点标签QueryCondition，查询条件数据字段如下表：序号参数项名称类型长度是否可空备注1sfzmhm身份证明号码varchar230可空2xm姓名varchar230可空3jczbh检验机构编号varchar210不可空4gxrq更新时间date可空返回结果文档ResultXML说明：节点标签vehispara，查询结果数据字段如下表：表3：检验机构工作人员备案信息序号参数项名称类型长度是否可空备注1sfzmhm身份证明号码varchar218不可空2xm姓名varchar230不可空3rylb人员类别varchar2300不可空4glbm管理部门varchar212不可空5fzjg发证机关varchar210不可空6jczbh检验机构编号varchar220不可空7gxrq更新日期date可空8bz备注varchar24000可空9shbj审核标记varchar21可空0-待审核，1-同意，2-不同意10shyj审核意见varchar24000可空11zt状态标记char1不可空0-撤销，1-正常，2-停用，3-