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

机动车检验监管系统接口使用手册公安部交通管理科学研究所 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.检验备案信息读取接口定义- 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-机动车人工检验项目检验结果详细信息(按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.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.18C67-机动车检验视频异常信息- 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 -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. 接口调用函数检验监管系统对外接口包括两类：查询类和写入类接口。查询类接口对外提供查询服务，写入类接口对外提供将业务数据写入检验监管系统业务库。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. 写入类接口Public 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数据下载成功！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文档的【写入数据字段】和【返回结果字段】的标签均为小写字符。XML文档【节点标签】必须和手册中注明的保持一致。1.4.2. 返回结果错误代码说明正常返回结果code为成功与否标记（小于等于0-失败；1-成功，由提供的接口服务定义），网络异常或接口权限异常等系统原因时返回$E的标记。写入失败时的message返回详细描述信息。第二部分 对外接口说明2.1. 接口列表检验监管系统提供的信息接口共33个（见下表），其中写照片接口还可参考第四部分提供的方式。序号接口名称接口定义提供者调用者1.检验备案信息查询接口【1】 检验机构备案信息【2】 检测线备案信息【3】 检验机构工作人员备案信息【4】 检验业务信息系统备案信息检验监管系统检验业务信息系统2.检验信息写入接口【5】 机动车检验登录信息【6】 机动车检验过程开始信息【7】 机动车检验项目开始信息【8】 机动车人工检验项目检验结果详细信息（GB21861-XXXX）【9】 机动车人工检验项目检验结果详细信息（GB21861-2008）【10】 二、三轮机动车人工检验项目检验结果详细信息（GB21861-2008）【11】 仪器设备检验项目检验结果详细信息【12】 路试检验信息【13】 机动车检验项目结束信息【14】 机动车检验过程结束信息【15】 机动车检验结果其他信息【16】 机动车交通事故责任强制保险信息【17】 机动车检验判定结果信息【18】 机动车检验照片和资料照片信息【19】 机动车检验结果资料申请审核信息【20】 机动车复检登录信息检验监管系统检验业务信息系统、检验智能终端系统3.其他查询与写入接口【21】 时间同步【22】 获取车辆所属类别对应检验项目信息【23】 获取机动车对应需拍摄照片和人工检验项目信息【24】 获取机动车检验审核不通过信息【25】 获取机动车基本信息【26】 机动车检验登录信息更正【27】 机动车检验视频异常信息【28】 检验业务信息系统操作日志【29】 写入收费信息【30】 机动车检验审核通过信息获取回执【31】 机动车检验业务退办【32】 读取车管业务流水号【33】 互联网检验预约信息下载检验监管系统检验业务信息系统、视频监管系统、检验智能终端系统2.2. 检验过程数据接口流程1、上传检验信息基本流程注：修订后的GB21861未正式实施前，人工检验项目检验结果18C80和18C53都要上传，正式实施后，只上传18C80。2、审核未通过，需补充材料的，通过以下接口重新上传。3、复检具有以下情形之一的，首先进行复检登录，然后再进行后续操作（同1，但外观检验不复检的，可跳过外观检验项目）。1）当机动车检验过程结束，存在不合格项目需要复检的。2）当审核（外观检验）未通过需要复检的。2.3. 检验备案信息读取接口定义2.3.1. 18C01-检验机构备案信息下载接口类型：查询类接口接口标识：18C01功能说明：根据检验机构编号、更新日期等信息下载检验机构备案信息。处理过程：对接口输入参数进行逻辑校验；查询相应检验机构备案信息。查询文档QueryXmlDoc说明：节点标签QueryCondition，查询条件数据字段如下表：序号参数项名称类型长度是否可空备注1jczbh检验机构编号varchar210不可空2gxrq更新日期date可空返回结果文档ResultXML说明：节点标签vehispara，查询结果数据字段如下表：表1： 检验机构备案信息序号参数项名称类型长度是否可空备注1jczbh检验机构编号varchar220不可空2jczmc检验机构名称varchar2128不可空3sflw是否与公安网联网char1不可空1-是，2-否4rdsbh资格许可证书编号varchar232不可空5rdyxqs资格许可有效期始date不可空6rdyxqz资格许可有效期止date不可空7shejirjcnl设计日检测能力(汽车辆)number4不可空8shijirjcnl实际日检测能力(汽车辆)number4不可空9jcryzs检测人员总数number4不可空10wjgwrs外检工位人数number4不可空11lrgwrs录入工位人数number4不可空12ycyrs引车员人数number4不可空13dpgwrs底盘工位人数number4不可空14zjgwrs总检工位人数number4不可空15qtgwrs其他工位人数number4不可空16tgszjbmkhrs通过省级质检部门考核人数number4不可空17wtgszjbmkhrs未通过省级质检部门考核人数number4不可空18fzjg发证机关varchar210不可空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可空29dwdz单位地址varchar2300不可空30yzbm邮政编码varchar26不可空31xkjyfw许可检验范围varchar2100不可空00-大型车，01-小型车，02-许可路试超检验能力的车，03-上门检验32rdsffdw资格许可发放单位varchar2300不可空33frdb法人代表varchar230不可空34frdbsfzh法人代表身份证号varchar218不可空35frdblxdh法人代表联系电话varchar215不可空36fzr负责人varchar230不可空37fzrsfzh负责人身份证号varchar218不可空38fzrlxdh负责人联系电话varchar215不可空39rclxr日常联系人varchar230不可空40rclxrsfzh日常联系人身份证号varchar218不可空41rclxrlxdh日常联系人联系电话varchar215不可空2.3.2. 18C02-检测线备案信息下载接口类型：查询类接口接口标识：18C02功能说明：根据检验机构编号、更新日期等信息下载检测线备案信息。处理过程：对接口输入参数进行逻辑校验；查询相应检测线备案信息。查询文档QueryXmlDoc说明：节点标签QueryCondition，查询条件数据字段如下表：序号参数项名称类型长度是否可空备注1jczbh检验机构编号varchar210不可空2gxrq更新日期date可空返回结果文档ResultXML说明：节点标签vehispara，查询结果数据字段如下表：表2： 检测线备案信息序号参数项名称类型长度是否可空备注1jczbh检验机构编号varchar220不可空2jcxxh检测线代号varchar22不可空3jczmc检验机构名称varchar2128不可空4jcxmc检测线名称varchar2128不可空5jcxlb检测线类别char1不可空1-汽车，2-摩托车6jcxczfs检测线控制方式char1不可空1-全自动，2-单工位检测，9-其他7zdsbmc制动检测设备名称varchar2128可空8zdsbxh制动检测设备型号varchar232不可空9zdsbsccj制动检测设备生产厂家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可空18zdsbjdyxqz制动检测设备检定有效期止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灯光检测设备检定有效期止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侧滑检测设备型号varchar232可空38chsbsccj侧滑检测设备生产厂家varchar2128可空39chjcsj侧滑检测最少时间number4可空40chsbqysj侧滑检测设备启用时间date可空41chsbjdyxqz侧滑检测设备检定有效期止date不可空42chsbzt侧滑检测设备状态char1不可空1-正常，2-故障维修，3-报废43czsbmc称重设备名称varchar2128可空44czsbxh称重检测设备型号varchar232可空45czsbsccj称重检测设备生产厂家varchar2128可空46czjcsj称重检测最少时间number4可空47czjb称重范围number6可空设备设计最大承受车辆轴重范围，单位为千克（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工位8varchar216可空60gw9工位9varchar216可空61bz备注varchar2128可空62fzjg发证机关varchar210不可空63glbm管理部门varchar212不可空64gxrq更新日期date可空65zdsbbh制动检验设备编号varchar230可空66zdsbjdzsbh制动检验设备检定/校准证书编号varchar230可空67dgsbbh灯光检验设备编号varchar230可空68dgsbjdzsbh灯光检测设备检定/校准证书标号varchar230可空69sdsbbh速度检验设备编号varchar230可空70sdsbjdzsbh速度检验设备检定/校准证书标号varchar230可空71chsbbh侧滑检验设备编号varchar230可空72chsbjdzsbh侧滑检验设备检定/校准证书编号varchar230可空73czsbbh称重检验设备编号varchar230可空74czsbjdzsbh称重检验设备检定/校准证书编号varchar230可空75zt状态标记varchar21不可空0-撤销，1-正常，2-停用，3-首次备案申请，4-过有效期76ztyy暂停原因varchar2512可空2.3.3. 18C05-检验机构工作人员备案信息下载接口类型：查询类接口接口标识：18C05功能说明：根据身份证明号码、姓名、检验机构编号、更新时间等信息下载检验机构工作人员的基本信息。处理过程：对接口输入参数进行逻辑校验；查询相应检验机构工作人员备案信息。查询文档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-首次备案申请，4-过有效期12sgzbh上岗证编号varchar232不可空13sgzyxqz上岗证有效期止date不可空14sgzffdw上岗证发放单位varchar2300不可空15syglbm使用管理部门varchar21024可空2.3.4. 18C06-检验业务信息系统备案信息下载接口类型：查询类接口接口标识：18C06功能说明：根据备案编号、更新日期等信息下载检验业务信息系统备案信息。处理过程：对接口输入参数进行逻辑校验；查询相应检验业务信息系统备案信息。查询文档QueryXmlDoc说明：节点标签QueryCondition，查询条件数据字段如下表：序号参数项名称类型长度是否可空备注1babh备案编号varchar210不可空2gxrq更新日期date可空返回结果文档ResultXML说明：节点标签vehispara，查询结果数据字段如下表：表4： 检验业务信息系统备案信息序号参数项名称类型长度是否可空备注1babh备案编号varchar210不可空2jyxtmc检验系统名称varchar264不可空3jyxtsm检验系统说明varchar2256不可空4bbbh版本编号varchar264不可空5kfdw开发单位varchar2256不可空6sjkbb数据库版本varchar2128不可空7xtjgms系统架构描述varchar22048不可空8jczbh检验机构编号varchar210不可空9jcxxh检测线代号varchar2100不可空10jcsj检测时间date可空11yssj验收时间date可空12syzt使用状态char1不可空13ztyy暂停原因varchar2512可空14jbr经办人varchar230可空15shbj审核标记varchar22不可空16shyj审核意见varchar24000可空17shr审核人varchar230可空18shsj审核时间date可空19fzjg发证机关varchar210不可空20glbm管理部门varchar212可空21gxsj更新日期date可空22syglbm使用管理部门varchar21024可空2.4. 检验信息写入接口定义2.4.1. 18C51-机动车检验登录信息接口类型：写入类接口接口标识：18C51功能说明：机动车检验开始前，上传机动车检验登录信息。处理过程：根据jylsh和jyjgbh查询流水过程控制信息表、检验登录信息表和检验机构备案信息表等，对输入信息进行合法性校验，保存检验登录信息，返回处理结果。WriteXmlDoc文档说明：节点标签vehispara，写入数据字段如下表：表5： 检验登录信息序号参数项名称类型长度是否可空备注1jylsh检验流水号varchar217不可空对同一检验机构，此检验流水号必须唯一，下同2jyjgbh检验机构编号varchar210不可空按检验机构备案信息，下同3jcxdh检测线代号varchar22可空按检测线备案信息，下同，如：1、2、3、4、5、6、7、8、9、10、4xh机动车序号varchar214可空5hpzl号牌种类varchar22可空按GA/T16.7。在用车不可空。6hphm号牌号码varchar215可空在用车不可空。填写格式如：“苏BAA345”填写“苏BAA345”、“苏B1234挂”填写“苏B1234”，下同。7clsbdh车辆识别代号varchar225不可空填写完整的VIN号或车架号。8fdjh发动机/电动机号码varchar230可空9csys车身颜色varchar25可空按GA/T16.810syxz使用性质char1可空按GA/T16.311ccdjrq初次登记日期date可空按“yyyy-mm-dd”格式填写12jyrq最近定检日期date可空按“yyyy-mm-dd”格式填写13jyyxqz检验有效期止date可空按“yyyy-mm-dd”格式填写14bxzzrq保险终止日期date可空按“yyyy-mm-dd”格式填写15rlzl燃料种类varchar23可空可同时输入三种，每种按GA/T16.916gl功率number5,1可空单位为千瓦（kw），四位整数，一位小数17zs轴数number1不可空18zj轴距number5可空单位为毫米（mm）19qlj前轮距number4可空单位为毫米（mm）20hlj后轮距number4可空单位为毫米（mm）21zzl总质量number8不可空单位为千克（kg）22zbzl整备质量number8不可空单位为千克（kg）23ccrq出厂日期date不可空按“yyyy-mm-dd”格式填写24qdxs驱动形式(驱动轴位)varchar25不可空组合串:如1234(1表示一轴.)25zczs驻车轴数number1可空摩托车无此参数26zczw驻车轴位varchar25可空组合串:如1234(1表示一轴.)27zzs主轴数number1可空28zzly制动力源char1可空0-气压制动，1-液压制动，2-气推油制动29qzdz前照灯制varchar22可空01-四灯远近光，02-四灯远光，03-二灯远近光，04-二灯近光，05-一灯远光30ygddtz远光单独调整char1可空0-不能单独调整，1-单独调整31zxzxjxs转向轴（前轴）悬架形式char1可空0-独立悬架，1-非独立悬架32lcbds里程表读数number8可空单位为千米（km）33jyxm检验项目varchar2100不可空多值，英文半角逗号分隔。各项目代码为：F1-车辆外观检验