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