驾驶证机动车查询验证WebSerivce调用编程接口说明及示例代码

1、    引言

1.1　编写目的

为全国机动车驾驶证验证查询（物流公司、银行保险、大型网站）提供统一的WebService访问入口。接口的访问需要遵循相关的格式规定，为了使其他业务系统能很好地调用提供的WebService特编写该手册。

1.2 接口功能说明

一、查询接口（提供规范）

（1）驾驶者查询(验证），如果驾驶人姓名为空，则为驾驶证查询，否则为验证，只获取基本信息。（提交必要条件：发证机关、证件类型、证件号码，可选条件驾驶人姓名）（queryDriveInfoValidate）。

（2）机动车信息验证 提交必要条件：发证机关、车辆类型、车辆号码 、验证类型（0 查询 1发动机号校验 2 所有人校验 3 车架号校验 4 车身颜色校验）；可选条件：验证关键词（queryMotorInfoValidate）。

二、接口访问地址

考虑到WebService接口提供给全国各个公司的验证查询权限及安全机制的不同，分别提供不同的WebService访问接口。

对其他业务系统的接口访问地址为：

http://webservice.jtjc.cn/Service/VioOutAccess.asmx?WSDL其中域名标识Web服务器地址

2、    调用接口说明

2.1其他业务系统的接口定义说明

一、驾驶证信息查询验证接口

（1）对外公布方法名：

public XmlDocument queryDriveInfoValidate(string Pin, string Fzjg, string Zjlx, string Zjhm, string Syr)

序号	参数	参数名称	注释
1	调用序列号	Pin
2	发证机关	Fzjg	必须
3	证件类型	Zjlx	必须
4	证件号码	Zjhm	必须
5	驾驶人姓名	Syr	可选

（2）返回结果封装格式：

 <?xml version="1.0" encoding="utf-8" ?>

- <DriveInfo>

  <Code>00</Code>

  <Message>查询成功</Message>

- <Date>

  <Yxq>2003年03月31日至2009年03月31日</Yxq>

  <Jsnx>旧期限</Jsnx>

  <Zjcx>A2E</Zjcx>

  <Ljjf>0</Ljjf>

  <Cfrq>未填写</Cfrq>

  <Yxqz>2009年03月31日</Yxqz>

  <Hzrq>2010年03月31日</Hzrq>

  <Zt>正常</Zt>

  <Zxtjbrq>2008年04月29日</Zxtjbrq>

  <Hzjl>3</Hzjl>

  <Syjl>4</Syjl>

- <Hz0>

  <HZRQ>2003年01月20日</HZRQ>

  <Bhzyy>自愿降级</Bhzyy>

  <Yjsqx>旧证</Yjsqx>

  <Yyxqz>未填写</Yyxqz>

  </Hz0>

- <Hz1>

  <HZRQ>2003年12月24日</HZRQ>

  <Bhzyy>期满</Bhzyy>

  <Yjsqx>旧证</Yjsqx>

  <Yyxqz>未填写</Yyxqz>

  </Hz1>

- <Hz2>

  <HZRQ>2009年04月07日</HZRQ>

  <Bhzyy>遗失</Bhzyy>

  <Yjsqx>旧证</Yjsqx>

  <Yyxqz>未填写</Yyxqz>

  </Hz2>

- <Sy0>

  <Syrq>2005年12月31日</Syrq>

  <Ysynd>2005年12月24日</Ysynd>

  </Sy0>

- <Sy1>

  <Syrq>2006年12月30日</Syrq>

  <Ysynd>2006年12月24日</Ysynd>

  </Sy1>

- <Sy2>

  <Syrq>2008年04月29日</Syrq>

  <Ysynd>2007年12月24日</Ysynd>

  </Sy2>

- <Sy3>

  <Syrq>2009年02月18日</Syrq>

  <Ysynd>2008年12月24日</Ysynd>

  </Sy3>

  </Date>

  </DriveInfo>

（3）备注：

code：返回结果信息，00表示正常，其他值表示调用出现出错

Message：返回结果中文解析

Date:当Code为00时，返回详细结果，否则这个节点不存在。

 

（4）对应字段说明

序号	字段名	字段描述	类型	长度	备注
1、	Yxq	有效期限	Varchar2	25
2、	Jsnx	驾驶年限	Char	1
3、	Zjcx	准驾车型	Varchar2	8
4、	Ljjf	累计积分	char	3
5、	Cfrq	超分日期	Varchar2	15
6、	Yxqz	有效期止	Date		Yyyy-MM-dd
7、	Hzrq	换证日期	Date		Yyyy-MM-dd
8、	Zt	状态	Varchar2	15
9、	Zxtjbrq	最新体检表提交日期	Date	128	Yyyy-MM-dd
10、	Hzjl	换证记录	Varchar2	50	参见说明1
11、	Syjl	审验记录	Varchar2	128	参见说明2
12、	Hz0	换证数据包	Char	1	参见说明3
13、	HZRQ	换证日期	Varchar2	2
14、	Bhzyy	换证原因	Varchar2	15
15、	Yjsqx r	原驾驶期限	Varchar2	128
16、	Yyxqz	原有效期止	Varchar2	1
17、	Sy0	审验数据包	Varchar2	3	参见说明4
18、	Syrq	审验日期	Date		Yyyy-MM-dd
19、	Ysynd	原审验日期	Varchar2	15

（5）说明

1)  换证记录Hzjl说明，当Hzjl为0时，则hz0数据包不存在；如果Hzjl为1 则有hz0以及相应的包体；依次类推，如上例Hzjl为3，则有hz0、hz1、hz2三组包体。

2)  审验记录Syjl说明，当Syjl为0时，则Sy0数据包不存在；如果Syjl为1 则有Sy0以及相应的包体；依次类推，如上例Syjl为4，则有Sy0、Sy1、Sy2、Sy3 四组包体。

3)  换证数据包与Hzjl相对应，当Hzjl为0时，这个节点不存在。

4)  审验数据包与Syjl相对应，当Syjl为0时，这个节点不存在。

 

 

二、机动车信息查询验证接口

（1）对外公布方法名：

public XmlDocument queryMotorInfoValidate(string Pin, string Fzjg, string Hplx, string Hphm, string Type, string Keys)

序号	参数	参数名称	注释
1	调用序列号	Pin
2	发证机关	Fzjg	必填
3	号牌类型	Hplx	必填
4	号牌号码	Hphm	必填
5	查询类型	Type	必填
6	校验关键词	Keys	可选

说明：查询类型（0 查询 1发动机号校验 2 所有人校验 3 车架号校验 4 车身颜色校验）

（2）返回结果封装格式：

  <?xml version="1.0" encoding="utf-8" ?>

- <MotorInfo>

  <Code>00</Code>

  <Message>查询成功</Message>

- <DATA>

  <SYXZ>货运</SYXZ>

  <HDFS>购买</HDFS>

  <SCYS>不提供</SCYS>

  <CZRQ>2002年07月31日</CZRQ>

  <FZRQ>2005年04月11日</FZRQ>

  <BXYYQ>2008年08月04日</BXYYQ>

  <NJYXQ>2009年07月31日</NJYXQ>

  <ZT>正常</ZT>

  <JYXXNUM>1</JYXXNUM>

- <JYJL0>

  <JJRQ>2008年06月30日</JJRQ>

  <JJJG>合格</JJJG>

  <JJYXQZ>2009年07月31日</JJYXQZ>

  <DJRQ>2008年06月30日</DJRQ>

  </JYJL0>

 

  </DATA>

  </MotorInfo>

（3）备注

code：返回结果信息，00表示正常，其他值表示调用出现出错

Message：返回结果中文解析

Date:当Code为00时，返回详细结果，否则这个节点不存在。

（4）对应字段说明

序号	字段名	字段描述	类型	长度	备注
1、	SYXZ	使用性质	Varchar2	25
2、	HDFS	获得方式	Char	1
3、	SCYS	颜色	Varchar2	8
4、	CZRQ	初次领证日期	char	3
5、	FZRQ	发证日期	Varchar2	15
6、	NJYXQ	年检有效期	Date		Yyyy-MM-dd
7、	ZT	当前状态	Varchar2
8、	JYXXNUM	检验次数	Varchar2	15	参见说明1
9、	JYJL0	检验数据包	Char	12	参见说明2
10、	JJRQ	检验日期	Varchar2	50
11、	JJJG	检验结果	Varchar2	128
12、	JJYXQZ	检验有效期止	Char	1
13、	DJRQ	换证日期	Varchar2	2

 

 

 

转载于:https://www.cnblogs.com/autowebcms/archive/2009/05/26/1490115.html