DB32/T 3498-2019 道路运输管理信息接口技术要求

ICS03.220.20

R10

备案号：DB32

江苏省地方标准

DB32/T3498—2019

道路运输管理信息接口技术要求

Roadtransportationmanagementinformationsharinginterfacestandard

2019-01-12发布2019-01-30实施

江苏省市场监督管理局发布

DB32/T3498—2019

目  次

目  次I

前  言II

道路运输管理信息接口技术要求1

1范围1

2规范性引用文件1

3缩略语1

4安全策略1

5接口内容规范2

5.1接入业务分类2

5.2接口交换要求2

5.3接口报文格式2

6数据接口总体要求4

6.1获取数据的接口4

6.2上传数据接口定义8

7具体业务数据接口要求9

7.1从业人员业务数据接口要求9

7.2业户17

7.3车辆24

7.4其他43

7.55接入平台数据项说明47

附录A82

A.1性别编码82

A.2民族编码82

A.3身份证件类别编码84

A.4从业资格编码84

A.5申请种类编码85

A.6学历编码85

A.7健康状况编码86

A.8车牌颜色编码86

A.9车辆技术等级编码86

A.10客车等级编码87

A.11经营范围编码87

A.12许可事项编码91

A.13经济类型编码91

A.14车型编码92

I

DB32/T3498—2019

前  言

本标准按照GB/T1.1-2009给出的规则编写。

本标准由江苏省交通运输厅运输管理局提出。

本标准由江苏省交通运输厅运输管理局归口。

本标准起草单位：江苏省交通运输厅运输管理局、江苏长天智远交通科技有限公司、无锡

市运输管理处、苏州市运输管理处。

本标准主要起草人：陆元良、陶绪林、李云飞、王登才、高潮、张进、方力、叶嘉宁、张

新民、吴勇、李瑞航、张鹏飞、刘霄云、陆熠等。

II

DB32/T3498—2019

III

DB32/T3498—2019

道路运输管理信息接口技术要求

1范围

本标准规定了江苏省道路运输管理信息共享接口服务的基本内容。

本标准适用于江苏省内的道路运输管理过程中的信息共享。

2规范性引用文件

下列文件对于本标准的应用是必不可少的。凡是注日期的引用文件，仅所注日期的版本适

用于本标准。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本标准。

GB/T2659—2000世界各国和地区名称代码

JT/T414—2006道路运输电子政务平台信息分类与指标

JT/T415—2006道路运输电子政务平台编目编码规则

JT/T697.1—2013交通信息基础数据元第1部分：总则

JT/T697.7—2014交通信息基础数据元第7部分：道路运输信息基础数据元

JT/T809交通部卫星定位数据传输标准

3缩略语

下列缩略语适用于本文件。

Base64：一种用于传输8Bit字节代码的编码方式

CDATA：不由XML解析器进行解析的文本数据（CharacterData）

CSV：逗号分隔值（Comma-SeparatedValues）

FTP：文件传输协议（FileTransferProtocol）

FTPS：增强型FTP协议（FTP-SSL或者FTP-over-SSL）

GBK：汉字内码扩展规范（ChineseInternalCodeSpecification）

HTTP：超文本传输协议（HypertextTransferProtocol）

ID：标识号，是某个体系中相对唯一的标识（Identification）

MD5：信息-摘要算法第五版（Message-DigestAlgorithm5）

RSA：公钥加密算法（RSAAlgorithm）

SOAP：简单对象访问协议（SimpleObjectAccessProtocol）

SSL：安全套接层(SecureSocketsLayer)

UTF-8：是一种针对Unicode的可变长度字符编码，又称万国码（8-bitUnicodeTransformation

Format）

XML：可扩展标记语言（ExtensibleMarkupLanguage）

4安全策略

运输信息平台边界接入平台Transportinformationplatformboundaryaccessplatform

运输信息边界接入平台（以下简称“接入平台”）是边界接入业务与运输信息平台进行数

据交换和授权访问的基础。接入平台提供各类接入业务与运输信息通信网进行数据交换和授权

访问的网络通道，对各类接入业务进行注册、监控与审计。

系统安全策略SystemSecurityPolicy

1

DB32/T3498—2019

需要建立系统安全防范策略，包括访问控制与安全边界、弱点漏洞分析和风险审计、入侵

检测与防御、信息监控、病毒防护以及系统安全的安全管理，从链路、网络主机、应用等方面

采取必要的安全技术措施，在实现接入业务交换的同时，保障接入平台及运输信息通信网的安

全。

接口服务器InterfaceServer

业务接入服务器必须具备病毒防护、入侵检测与防御的安全管理策略，确保接入服务器不

影响运输信息平台。

5接口内容规范

5.1接入业务分类

运输管理机构所有向外提供信息服务和接收外部信息的业务，以下简称“接入业务”。接

入业务按接入对象划分，主要分为三大类：交通行业内部接入业务、政府职能部门接入业务和

社会第三方应用。

政府职能部门接入业务，其接入对象为具备行政职能的机关及事业单位用户。例如：政府

部门用户、公安、环保、安监、工商、民政、信用等相关单位与运管部门实现信息共享交换的

业务。

交通行业内部接入业务，其接入对象为，包括交通运输厅、交通运输部、地方交通局等部

门。例如向交通运输部接收和上报车辆和业户的接入及基础信息获取服务等。

社会第三方应用接入业务，其接入对象为机动车检测站、驾驶员培训学校、教育学习网、卫

星定位系统服务商等社会单位。例如向运管部门上报车辆定位信息、从业人员继续教育学时等。

5.2接口交换要求

全省运政系统与其它相关系统互为SOAP客户端和SOAP服务端。当某一系统为SOAP客户端

时，即为服务的发起方，发送报文后30s内未收到应答报文，应中断后重新进行一次请求。作

为SOAP服务端一方，即为服务的接收方，收到报文后应及时按数据格式要求提供信息反馈。

每个数据接口中，针对接入和调取数据的对象不同，如：交通行业内部接入业务、政府职

能单位接入业务和社会第三方应用，提供不同的输入、输出数据信息范围。

5.3接口报文格式

5.3.1报文定义

报文(message)是网络中交换与传输的数据单元，即站点一次性要发送的数据块。报文包含

了将要发送的完整的数据信息，其长短很不一致，长度不限且可变。接口报文结构包括包头

（header）和包体（body）节点，以XML格式描述，编码方式为UTF-8。

具体业务编码含义参见附录，常用的地区编码等内容参见国家相关标准。

5.3.2约束

约束是用来确保数据的准确性和一致性。接口报文结构字段约束条件解释见表1。

表1约束条件

约束约束条件

?0..1可以没有，也可以有

*0..n，可以没有，也可以有多项

+1..n，至少有1项，也可以有多项

1必须且只能填1项

5.3.3报文结构

2

DB32/T3498—2019

表2接口报文结构

序父元素名约长

层级元素名称报文格式描述取值说明

号称束度

交易报文的

10-transaction1---

主节点

transacton

21header1--报文头-

6位代码（见JT/T

697.7—2014中

.3）+时间

31.1headerserialnum1StringF32流水号格

式YYYYMMDDhhmm

ss+12位序列号；

6位代码（见JT/T

sourceservice

41.2header1StringF6发起方系统编码697.7—2014中

.3）

6位代码（见JT/T

51.3headertargetservice1StringF6接收方系统编码697.7—2014中

.3）

61.4headersystemid1StringF6服务的系统编码默认值000000

71.5headerserviceid1StringF6业务接口代码-

81.6headerdate1StringF8请求日期YYYYMMDD

91.7headertime1StringF6请求时间hhmmss

0-请求

101.8headerisreq1StringF1标志位

1-响应

111.9headersignature1--数字签名信息-

对body节点做

Base64编码对编

121.9.1signaturemd51StringF32Md5校验码码结果做MD5转换，

生成32位数据摘

要

使用RSA算法对

V256

131.9.2signaturedetail1String数字签名MD5数据摘要进行

签名

141.10headerresponse1-响应结果信息-

1.10.见A.1应答代码与

15responseretcode1StringF4应答/错误代码

1消息

1.10.见A.1应答代码与

16responseretmsg1String应答/错误信息

2V256消息

transactionCDATA见业务功能中报文

171.11body?-具体交易的XML

结构

5.3.4分页

3

DB32/T3498—2019

系统默认应答报文中最大返回记录数为100，对于查询结果大于100的请求，客户端应请求

多次获取完整的查询结果。分页内容放入报文结构body中。

分页请求报文字段解释见表3。

表表31（分续页）请求报文

序

层级父元素名称元素名称约束类型长度描述取值说明

号

11-reqInfo1--请求体-

22reqInfopageInfo1--分页信息-

String-

33pageInfopage1V6页码

分页应答报文字段解释见表4。

表4分页应答报文

序

层级父元素名称元素名称约束类型长度描述取值说明

号

10-respInfo1--返回信息-

21respInfopageInfo1--分页信息-

String

32pageInfolimit1V6每页记录数默认100

String

43pageInfopage1V6当前页码-

String-

54pageInfototalcount1V10总记录条数

String-

65pageInfototalpages1V6总页数

6数据接口总体要求

6.1获取数据的接口

1、描述

用来获取江苏省运输管理业务系统中的数据。

2、接口要求

publicstringGetData(stringfunName,stringuserId,stringpassword,string

param)

3、参数说明

funName：业务功能名称，由运政业务系统确定，例.1：GetUserInfo；

userId：运政系统为接入系统分配的用户标识，系统验证用；

password：运政系统为接入系统分配的用户密码，系统验证用；

param：调用参数，XML格式，描述如下：

4

DB32/T3498—2019

<jstmbsinterface>

<!--分批操作标签,非必填-->

<!--num：批次号-->

<!--count：每批次数量(不能大于200),可以没有此段,没有此段系统默认为200-->

<batchnum=""count=""></batch>

<!--数据筛选条件标签(参见具体的任务类型定义),,非必填项目-->

gong

<condition>

<fieldname=""value=""></field>

</condition>

</jstmbsinterface>

表5标签说明

标签及属性是否必须说明

jstmbsinterface是Xml的根级元素，表示江苏运输管理业务系统接口

batch否分批操作标签，用来标识要获取哪一批次的数据

批次号，如果有batch标签，此属性则是必须的，表示要获取哪一批数据，

num是

num>0

此属性可为空，则系统默认为200条数据，大于200，系统也默认为200条，

count否

最小值为1

condition否对数据的筛选条件，具体的要求见相应业务数据的说明

返回参数：XML格式

5

DB32/T3498—2019

<jstmbsinterface>

<!--返回结果标签,必填,code:返回代码,必填-->

<!--description:返回结果描述,(可能为空字符)-->

<resultcode=""description=""></result>

<!--返回数据部分,不一定有此项-->

<dataencryptflag="0"encryptkey="">

<!--具体数据,如Practitioners表示为从业人员数据,count:数量,如果分批查询会有以下

两属性

batchnum:当前批次号,totalbatch:共有多少批次-->

<Practitionerscount="350"batchnum="1"totalbatch="2">

<Practitioneraction="1">

<Id></Id>

<PractitionerName></PractitionerName>

<Sex></Sex>

</Practitioner>

<!--下一条数据-->

<Practitioneraction="2">

……

</Practitioner>

</Practitioners>

<!--从业人员删除的数据-->

<PractitionerDeletecount="350"batchnum="1"totalbatch="2">

<Practitioneraction="3"><!--删除的数据-->

<Id>1432454325</Id>

</Practitioner>

</PractitionerDelete>

</data>

</jstmbsinterface>

6

DB32/T3498—2019

表6标签说明

标签及属性是否必须说明

jstmbsinterface是Xml的根级元素，表示江苏运输管理业务系统接口

result是返回的调用结果

code是属性，返回代码：

0：成功

1：用户标识或密码错误

2：用户已停用

3：调用的IP地址不相符

4：不可识别的业务功能（funName业务功能不可识别）

5：业务功能已不使用

6：分批查询参数错误（如果是分批查询，缺少批次号，或类型范围不正

确）

7：查询条件错误（缺少XX查询条件）

8：上传的数据为空

9：上传的数据已存在

10：获取的数据不存在

11：上传的数据有误

98：系统WebService服务关闭

99：其他错误

description否内容为返回代码的补充描述，成功时为空字符

data否返回取到的数据

如果有data标签，则此属性必填，数据部分是否加密标识，0:不加密，

encryptflag是

1:加密

encryptkey否加密的密钥，如果加密标识为1，密钥不为空

数据标签否根据具体的业务数据定义，如：从业人员定义为Practitioner（注：区

分大小写）

count否此属性则是非必须的，共有多少数据

batchnum否如果是分配查询，此属性则是必须的，表示要返回的批次号

7

DB32/T3498—2019

totalbatch否如果是分配查询，此属性则是必须的，共有多少批

数据操作属性，非必须属性

action否

1：新增，2：修改，3：删除（删除时业务数据中只有主键标识）

6.2上传数据接口定义

1、描述：

用来上传数据到江苏省运输管理业务系统中。

2、接口要求

publicstringSetData(stringfunName,stringuserId,stringpassword,string

data)

3、参数说明：

funName：业务功能名称，运政业务系统确定，例：SetPracApplyInfo；userId：运政系

统为接入系统分配的用户标识，系统验证用；

password：运政系统为接入系统分配的用户密码，系统验证用；

data：上报的业务数据，XML格式，描述如下：

<jstmbsinterface>

<!--数据,必填-->

<dataencryptflag="0"encryptkey="">

<!--例:申请基本信息-->

<PracApply>

……

</PracApply>

<!--例:材料信息-->

<PracApplyMaterials>

…….

</PracApplyMaterials>

</data>

</jstmbsinterface>

表7标签说明

是否

标签及属性说明

必须

jstmbsinterface是Xml的根级元素，表示江苏运输管理业务系统接口

返回的调用结果，内容为返回代码的补充描述，成功时为空字符，参

Result是

见获取数据返回结果说明

8

DB32/T3498—2019

data是上传的数据标签

如果有data标签，则此属性必填，数据部分是否加密标识，0:不加密，

encryptflag是

1:加密

encryptkey否加密的密钥，如果加密标识为1，密钥不为空

根据具体的业务数据定义，如：从业人员定义为Practitioner（注：区

数据标签否

分大小写）

count否此属性则是非必须的，共有多少数据

数据操作属性，非必须属性

action否

1：新增，2：修改，3：删除（删除时业务数据中只有主键标识）

返回参数：XML格式

<jstmbsinterface>

<!--返回结果标签,必填,code:返回代码,必填,descriptoin:返回结果描述(可能为空字符)-->

<resultcode=""description=""></result>

</jstmbsinterface>

7具体业务数据接口要求

7.1从业人员业务数据接口要求

7.1.1上传从业资格申请数据

上传一条从业资格申请数据。

业务功能

调用方法为：UploadPracApply

数据标签

<PracApply>申请信息

<PracApplyMaterial>申请材料

<PracMaterialAttachment>材料附件

数据格式

数据格式见附录，示例为：

<PracApply>

<ApplyId>293849234732949123</ApplyId>

………

</PracApply>

<PracApplyMaterials>

<PracApplyMaterial>

<MaterialName>身份证复印件</MaterialName>

9

DB32/T3498—2019

…………

<!--每个材料可以有多个附件-->

<Attachments>

<PracMaterialAttachment>

<AttachName>file1</AttachName>

…………

</PracMaterialAttachment>

<PracMaterialAttachment>

<AttachName>file1</AttachName>

…………

</PracMaterialAttachment>

</Attachments>

</PracApplyMaterial>

<PracApplyMaterial>

<MaterialName>申请表复印件</MaterialName>

…………

<!--每个材料可以有多个附件-->

<Attachments>

<PracMaterialAttachment>……</PracMaterialAttachment>

<PracMaterialAttachment>……</PracMaterialAttachment>

…………

</Attachments>

</PracApplyMaterial>

<!--多个材料-->

………

</PracApplyMaterials>

7.1.2获取从业资格申请审核情况信息

业务功能（获取数据）

调用方法为：GetPracApplyInfo

查询条件

表1查询条件

条件名称描述是否必须数据类型备注

applyId申请Id主键是VARCHAR

返回数据标签

<PracApply>申请信息标签

数据格式

数据格式见附录，示例为：

<PracApply>

<ApplyId>293849234732949123</ApplyId>

………

</PracApply>

7.1.3获取从业人员基础信息

业务功能（获取数据）

调用方法为：GetPractitionerInfo

10

DB32/T3498—2019

查询条件

表2查询条件

条件名称描述是否必须数据类型备注

idCertNum身份证号是VARCHAR

返回数据标签

<Practitioner>从业人员基本信息

<PracCertificate>证件信息

<PracOwnerRegister>服务单位备案（或巡游出租汽车驾驶员注册）信息，如无备案（或

注册）则无此标签

数据格式

数据格式见附录，示例为：

<Practitioner>

……….

</Practitioner>

<!--证件信息-->

<PracCertificate>

……….

</PracCertificate>

7.1.4获取审核通过的人员信息

根据申请时间等条件获取审核通过的人员信息，返回多条数据。如果数据多于200条，需

分批次获取。

业务功能（获取数