机动车检验监管系统接口使用手册.doc
《机动车检验监管系统接口使用手册.doc》由会员分享,可在线阅读,更多相关《机动车检验监管系统接口使用手册.doc(120页珍藏版)》请在咨信网上搜索。
1、机动车检验监管系统接口使用手册公安部交通管理科学研究所 2014年10月目录第一部分 接口调用规范- 5 -1.1.接口访问地址- 5 -1.2.接口调用函数- 5 -1.2.1.查询类接口- 5 -1.2.2.写入类接口- 5 -1.3.XML文件格式定义- 6 -1.3.1.查询类接口XML文档- 6 -1.3.2.写入类接口XML文档- 7 -1.4.调用注意事项- 8 -1.4.1.XML文档的中文处理- 8 -1.4.2.返回结果错误代码说明- 8 -第二部分 对外接口说明- 9 -2.1.接口列表- 9 -2.2.检验过程数据接口流程- 11 -2.3.检验备案信息读取接口定义-
2、12 -2.3.1.18C01-检验机构备案信息下载- 12 -2.3.2.18C02-检测线备案信息下载- 15 -2.3.3.18C05-检验机构工作人员备案信息下载- 20 -2.3.4.18C06-检验业务信息系统备案信息下载- 21 -2.4.检验信息写入接口定义- 23 -2.4.1.18C51-机动车检验登录信息- 23 -2.4.2.18C52-机动车检验过程开始信息- 29 -2.4.3.18C55-机动车检验项目开始信息- 30 -2.4.4.18C80-机动车人工检验项目检验结果详细信息(按GB 21861-XXXX)- 32 -2.4.5.18C53-机动车人工检验项目
3、检验结果详细信息(按GB 21861-2008)- 38 -2.4.6.18C68-二、三轮机动车人工检验项目检验结果详细信息(按GB 21861-2008)- 47 -2.4.7.18C81-仪器设备检验项目检验结果详细信息- 54 -2.4.8.18C54-路试检验信息- 71 -2.4.9.18C58-机动车检验项目结束信息- 74 -2.4.10.18C59-机动车检验过程结束信息- 76 -2.4.11.18C82-机动车检验结果其他信息- 77 -2.4.12.18C61-机动车交通事故责任强制保险信息- 79 -2.4.13.18C62-机动车检验判定结果信息- 81 -2.4.
4、14.18C63-机动车检验照片和资料照片信息- 84 -2.4.15.18C64-机动车检验结果资料申请审核信息- 88 -2.4.16.18C65-机动车复检登录信息- 89 -2.5.其他接口定义- 91 -2.5.1.18C50-时间同步- 91 -2.5.2.18C46-获取车辆所属类别对应检验项目信息- 92 -2.5.3.18C47-获取机动车对应需拍摄照片和人工检验项目信息- 94 -2.5.4.18C48-获取机动车检验审核不通过原因- 95 -2.5.5.18C49-获取机动车基本信息- 98 -2.5.6.18C66-机动车检验登录信息更正- 101 -2.5.7.18C
5、67-机动车检验视频异常信息- 105 -2.5.8.18C69-检验业务信息系统操作日志- 107 -2.5.9.18C70-写入收费信息- 109 -2.5.10.18C71-机动车检验审核通过信息获取回执- 110 -2.5.11.18C72-机动车检验业务退办- 111 -2.5.12.18C21-读取车管业务流水号- 112 -2.5.13.18C07-互联网检验预约信息下载- 113 -第三部分 接口调用范例- 116 -3.1.JAVA调用示例- 116 -3.1.1.中文转码及XML文档封装代码- 116 -3.1.2.查询接口示例- 118 -3.1.3.写接口示例- 119
6、 -3.2.其他调用示例- 120 -第四部分 写照片接口说明- 121 -4.1.示例代码- 121 -4.1.1.java调用示例代码- 121 -4.2.接口调用请求说明- 122 -4.2.1.写机动车检验照片表信息- 122 -第一部分 接口调用规范1.1. 接口访问地址检验监管系统对外接口访问地址:http:/ip:port/pnweb/services/TmriOutAccess?wsdl其中IP标识Web服务器地址;port对应系统应用服务的端口号,启用80的不填写。1.2. 接口调用函数检验监管系统对外接口包括两类:查询类和写入类接口。查询类接口对外提供查询服务,写入类接口对
7、外提供将业务数据写入检验监管系统业务库。1.2.1. 查询类接口public String queryObjectOut(String xtlb,String jkxlh,String jkid,String QueryXmlDoc)表1:查询类接口调用参数说明序号参数名称参数说明备注信息1xtlb系统类别接口提供者的业务类别代码,默认为“18”(代表机动车检验监管系统)2jkxlh接口序列号由外挂系统请求服务平台授权生成下发3jkid接口标识5位,由系统类别C两位接口顺序号组成,用于唯一表示一个接口。4QueryXmlDoc查询条件封装查询条件的XML格式文档1.2.2. 写入类接口Publ
8、ic String writeObjectOut (String xtlb,String jkxlh,String jkid,String WriteXmlDoc)表2:写入类接口调用参数说明序号参数名称参数说明备注信息1xtlb系统类别同上2jkxlh接口序列号同上3jkid接口标识同上4WriteXmlDoc写入数据业务数据写入XML格式文档1.3. XML文件格式定义1.3.1. 查询类接口XML文档查询条件QueryXmlDoc的文档格式要求如下: -节点标签 苏BAA123 02 1234 -车辆识别代号后四位 3200000001 查询返回结果ResultXML文档格式1数据下载成
9、功!1 BAA12302 A1.3.2. 写入类接口XML文档写入数据WriteXmlDoc文档格式如下: -节点标签 -写入数据字段 写入操作返回结果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文档的【写入
10、数据字段】和【返回结果字段】的标签均为小写字符。XML文档【节点标签】必须和手册中注明的保持一致。1.4.2. 返回结果错误代码说明正常返回结果code为成功与否标记(小于等于0-失败;1-成功,由提供的接口服务定义),网络异常或接口权限异常等系统原因时返回$E的标记。写入失败时的message返回详细描述信息。第二部分 对外接口说明2.1. 接口列表检验监管系统提供的信息接口共33个(见下表),其中写照片接口还可参考第四部分提供的方式。序号接口名称接口定义提供者调用者1.检验备案信息查询接口【1】 检验机构备案信息【2】 检测线备案信息【3】 检验机构工作人员备案信息【4】 检验业务信息系统
11、备案信息检验监管系统检验业务信息系统2.检验信息写入接口【5】 机动车检验登录信息【6】 机动车检验过程开始信息【7】 机动车检验项目开始信息【8】 机动车人工检验项目检验结果详细信息(GB21861-XXXX)【9】 机动车人工检验项目检验结果详细信息(GB21861-2008)【10】 二、三轮机动车人工检验项目检验结果详细信息(GB21861-2008)【11】 仪器设备检验项目检验结果详细信息【12】 路试检验信息【13】 机动车检验项目结束信息【14】 机动车检验过程结束信息【15】 机动车检验结果其他信息【16】 机动车交通事故责任强制保险信息【17】 机动车检验判定结果信息【18
12、】 机动车检验照片和资料照片信息【19】 机动车检验结果资料申请审核信息【20】 机动车复检登录信息检验监管系统检验业务信息系统、检验智能终端系统3.其他查询与写入接口【21】 时间同步【22】 获取车辆所属类别对应检验项目信息【23】 获取机动车对应需拍摄照片和人工检验项目信息【24】 获取机动车检验审核不通过信息【25】 获取机动车基本信息【26】 机动车检验登录信息更正【27】 机动车检验视频异常信息【28】 检验业务信息系统操作日志【29】 写入收费信息【30】 机动车检验审核通过信息获取回执【31】 机动车检验业务退办【32】 读取车管业务流水号【33】 互联网检验预约信息下载检验监
13、管系统检验业务信息系统、视频监管系统、检验智能终端系统2.2. 检验过程数据接口流程1、上传检验信息基本流程注:修订后的GB21861未正式实施前,人工检验项目检验结果18C80和18C53都要上传,正式实施后,只上传18C80。2、审核未通过,需补充材料的,通过以下接口重新上传。3、复检具有以下情形之一的,首先进行复检登录,然后再进行后续操作(同1,但外观检验不复检的,可跳过外观检验项目)。1)当机动车检验过程结束,存在不合格项目需要复检的。2)当审核(外观检验)未通过需要复检的。2.3. 检验备案信息读取接口定义2.3.1. 18C01-检验机构备案信息下载接口类型:查询类接口接口标识:1
14、8C01功能说明:根据检验机构编号、更新日期等信息下载检验机构备案信息。处理过程:对接口输入参数进行逻辑校验;查询相应检验机构备案信息。查询文档QueryXmlDoc说明:节点标签QueryCondition,查询条件数据字段如下表:序号参数项名称类型长度是否可空备注1jczbh检验机构编号varchar210不可空2gxrq更新日期date可空返回结果文档ResultXML说明:节点标签vehispara,查询结果数据字段如下表:表1: 检验机构备案信息序号参数项名称类型长度是否可空备注1jczbh检验机构编号varchar220不可空2jczmc检验机构名称varchar2128不可空3s
15、flw是否与公安网联网char1不可空1-是,2-否4rdsbh资格许可证书编号varchar232不可空5rdyxqs资格许可有效期始date不可空6rdyxqz资格许可有效期止date不可空7shejirjcnl设计日检测能力(汽车辆)number4不可空8shijirjcnl实际日检测能力(汽车辆)number4不可空9jcryzs检测人员总数number4不可空10wjgwrs外检工位人数number4不可空11lrgwrs录入工位人数number4不可空12ycyrs引车员人数number4不可空13dpgwrs底盘工位人数number4不可空14zjgwrs总检工位人数number
16、4不可空15qtgwrs其他工位人数number4不可空16tgszjbmkhrs通过省级质检部门考核人数number4不可空17wtgszjbmkhrs未通过省级质检部门考核人数number4不可空18fzjg发证机关varchar210不可空19glbm管理部门varchar212不可空20gxrq更新日期date不可空21bz备注varchar24000可空22shejirjcmtsl设计日检测能力(摩托辆)number4不可空23shijirjcmtsl实际日检测能力(摩托辆)number4不可空24shbj审核标记varchar22可空0-待审核,1-同意,2-不同意25syglbm
17、使用管理部门varchar24000可空26shyj审核意见varchar24000可空27zt状态标记 char1不可空0-撤销,1-正常,2-停用,3-首次备案申请,4-过有效期28ztyy暂停原因varchar2512可空29dwdz单位地址varchar2300不可空30yzbm邮政编码varchar26不可空31xkjyfw许可检验范围varchar2100不可空00-大型车,01-小型车,02-许可路试超检验能力的车,03-上门检验32rdsffdw资格许可发放单位varchar2300不可空33frdb法人代表varchar230不可空34frdbsfzh法人代表身份证号varc
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 机动车 检验 监管 系统 接口 使用手册
1、咨信平台为文档C2C交易模式,即用户上传的文档直接被用户下载,收益归上传人(含作者)所有;本站仅是提供信息存储空间和展示预览,仅对用户上传内容的表现方式做保护处理,对上载内容不做任何修改或编辑。所展示的作品文档包括内容和图片全部来源于网络用户和作者上传投稿,我们不确定上传用户享有完全著作权,根据《信息网络传播权保护条例》,如果侵犯了您的版权、权益或隐私,请联系我们,核实后会尽快下架及时删除,并可随时和客服了解处理情况,尊重保护知识产权我们共同努力。
2、文档的总页数、文档格式和文档大小以系统显示为准(内容中显示的页数不一定正确),网站客服只以系统显示的页数、文件格式、文档大小作为仲裁依据,个别因单元格分列造成显示页码不一将协商解决,平台无法对文档的真实性、完整性、权威性、准确性、专业性及其观点立场做任何保证或承诺,下载前须认真查看,确认无误后再购买,务必慎重购买;若有违法违纪将进行移交司法处理,若涉侵权平台将进行基本处罚并下架。
3、本站所有内容均由用户上传,付费前请自行鉴别,如您付费,意味着您已接受本站规则且自行承担风险,本站不进行额外附加服务,虚拟产品一经售出概不退款(未进行购买下载可退充值款),文档一经付费(服务费)、不意味着购买了该文档的版权,仅供个人/单位学习、研究之用,不得用于商业用途,未经授权,严禁复制、发行、汇编、翻译或者网络传播等,侵权必究。
4、如你看到网页展示的文档有www.zixin.com.cn水印,是因预览和防盗链等技术需要对页面进行转换压缩成图而已,我们并不对上传的文档进行任何编辑或修改,文档下载后都不会有水印标识(原文档上传前个别存留的除外),下载后原文更清晰;试题试卷类文档,如果标题没有明确说明有答案则都视为没有答案,请知晓;PPT和DOC文档可被视为“模板”,允许上传人保留章节、目录结构的情况下删减部份的内容;PDF文档不管是原文档转换或图片扫描而得,本站不作要求视为允许,下载前自行私信或留言给上传者【精****】。
5、本文档所展示的图片、画像、字体、音乐的版权可能需版权方额外授权,请谨慎使用;网站提供的党政主题相关内容(国旗、国徽、党徽--等)目的在于配合国家政策宣传,仅限个人学习分享使用,禁止用于任何广告和商用目的。
6、文档遇到问题,请及时私信或留言给本站上传会员【精****】,需本站解决可联系【 微信客服】、【 QQ客服】,若有其他问题请点击或扫码反馈【 服务填表】;文档侵犯商业秘密、侵犯著作权、侵犯人身权等,请点击“【 版权申诉】”(推荐),意见反馈和侵权处理邮箱:1219186828@qq.com;也可以拔打客服电话:4008-655-100;投诉/维权电话:4009-655-100。