DB35/T 1533-2015 道路运输物流企业电子运单接口及单据规范

ICS03.100.01

A02

DB35

福建省地方标准

DB35/T1533-2015

道路运输物流企业电子运单接口

及单据规范

RoadFreightTransportationEnterprisesElectronicTransportDocument

ExchangeandDocumentSpecification

2015-11-09发布2016-02-09实施

福建省质量技术监督局发布

DB35/T1533-2015

目

次

前言................................................................................Ⅱ

1范围..............................................................................1

2规范性引用文件....................................................................1

3术语和定义........................................................................1

4缩略语............................................................................1

5协议基础..........................................................................2

6通信连接..........................................................................4

7报文处理..........................................................................5

8服务接口..........................................................................5

9单据格式..........................................................................6

10单据格式扩展....................................................................19

附录A（规范性附录）报文异常代码信息对照表.........................................21

附录B（规范性附录）操作类型.......................................................23

附录C（规范性附录）业务类型.......................................................24

I

DB35/T1533-2015

前

言

本标准按照GB/T1.1-2009《标准化工作导则第1部分：标准的结构和编写》给出的规则起草。

本标准由福建省交通运输厅提出。

本标准由福建省交通运输厅、福建省信息化标准化技术委员会归口。

本标准起草单位：福建省交通信息通信与应急处置中心、福建省运输管理局、福建省标准化研究院、

福建省盛辉物流集团、福建省盛丰物流集团、福建省宏捷物流有限公司、厦门锐特信息技术有限公司、

未名（福建）信息技术有限公司。

本标准主要起草人：罗冠伟、庄孝昆、张锦、黄淑宽、邱淮、曾昭辉、谢紫忠、杨林、林勇、张

和宾、黄军、黄舒宁、张宏清。

II

DB35/T1533-2015

道路运输物流企业电子运单接口及单据规范

1范围

本标准规定了道路运输物流企业电子运单的协议基础、通信连接、报文处理、服务接口与单据规范。

本标准适用于道路运输物流企业通过客户端向服务器端上传各类电子运单。

2规范性引用文件

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

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

GB/T2260-2007中华人民共和国行政区划代码

GB12268-2005危险货物品名表

GA24.9-2005机动车登记信息代码第9部分燃料(能源)种类代码

GA36-2014中华人民共和国机动车号牌

GA802-2014机动车类型术语和定义

JT/T19-2001运输货物分类和代码

3术语和定义

下列术语和定义适用于本文件。

3.1

电子运单electronictransportdocument

由货运单中与运输信息相关的数据组织形成的电子运输单据。

3.2

物流交换代码logisticsexchangecode

每家具备道路运输资质的道路运输物流企业在数据交换过程中所使用的唯一身份标识。

4缩略语

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

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

HTTP：超文本传输协议(HypertextTransferProtocol)

WebService：WEB服务（WebService）

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

REST：表述性状态传递（RepresentationalStateTransfer）

1

DB35/T1533-2015

5协议基础

5.1通信方式

本协议的通信方式采用WebService实现，符合SOAP、REST规范。通信方式支持：

a)SOAP方式调用；

b)REST方式调用。通过HTTP发起调用请求，利用PUT、POST提交数据，DELETE删除数据，以及

GET请求文本数据结果等。

5.2报文

5.2.1结构

每条报文由报文头和报文体组成。

5.2.2结构属性

报文结构的属性如表1所示。

表1报文结构属性

序号属性名称说明

1报文层Level标识数据元在报文结构中的位置和层次关系。

2XML标记XML的元素名称，采用数据元的英文名称。

3中文名称对数据元的中文描述。

指该数据元在报文中重复出现的次数：

a）0..1——数据元值域可填，且出现一次；

4出现次数b）0..n——数据元值域可填，且可出现多次；

c）1..1——数据元值域必填，且出现一次；

d）1..n——数据元值域必填，且可出现多次。

数据类型是用于表示数据元的符号、字符或其他表示的类型。数据元值的类型可能的取值

有：“字符型”、“数字型”、“日期型”、“时间型”、“日期时间型”、“布尔型”、“二进制型”。

数据格式中使用的字符含义如下：

a)a=字母字符

b)n=数字字符

c)an=字母数字字符

数据类型和数据d)m(自然数)=定长m个字符（字符集默认为GB2312）

5

格式e)..=字符型数据的最小长度到最大长度的分隔符

f)，=区分数字字符个数与小数点后小数位数的分隔符，即“，”前为数字字

符个数，“，”后为小数点后小数位数；

g)ul=长度不确定的文本；

h)YYYYMMDDhhmmss=“YYYY”表示世纪和年份，“MM”表示月份，“DD”表示日期，“hh”

表示小时，“mm”表示分钟，“ss”表示秒，可以视具体实际情况组合使用。

i)True/False=布尔型。

2

DB35/T1533-2015

表1（续）

序号属性名称说明

示例1：

an3..8表示最大长度为8，最小长度为3的不定长字符。

数据类型和数据

5示例2：

格式an5(aannn)表示定长5个字母数字字符，前2个为字母字符，后3个为数字字符。

示例3：

n..8,4表示该数值最大长度为八位数字字符、小数点后四位数字。

7是否必填是否必须填报。

5.2.3报文头

报文头内容如表2所示。道路运输物流企业进行数据交换时，客户端需在请求报文头中加入认证时

获取的密码或令牌信息。xml格式如示例所示。

表2报文头内容

数据类型/数据格式是否必

序号报文层XML标记中文名称出现次数

（Type/Length）填

11soapenvsoapenv1..1

22soapenv:Header报文头1..1

33wsse:Security报文头1..1

44wsse:UsernameToken报文头1..1

55wsse:Username用户名1..1an..20是

65wsse:Password密码或令牌1..1an..50是

示例：<soapenv:Header>

<wsse:Securitysoapenv:mustUnderstand="1">

<wsse:UsernameToken>

<wsse:Username></wsse:Username>

<wsse:Password></wsse:Password>

</wsse:UsernameToken>

</wsse:Security>

</soapenv:Header>

5.2.4报文体

报文体内容如表3所示，xml格式如示例所示。

3

DB35/T1533-2015

表3报文体内容

报文层

序号XML标记中文名称出现次数数据类型/数据格式（Type/Length）是否必填

Level

11soapenvsoapenv1..1

22soapenv:Body报文头1..1

33operate报文头1..1

44businessId单据编号1..1an..20是

54businessType业务类型1..1an..50是

64businessXml业务内容1..1an..2000是

示例：<soapenv:Body>

<operatexmlns="/">

<businessIdxmlns="">73360328-X_010a121210Z00103</businessId>

<businessTypexmlns="">FJWL_E-WAY_SEND_GENERAL</businessType>

<businessXmlxmlns="">WVdGaA==</businessXml>

</operate>

</soapenv:Body>

6通信连接

6.1连接的建立

客户端与服务器端的通信连接采用HTTP方式，上传报文前，先与服务器端建立HTTP连接，连接建立

后向服务器端发送报文。

6.2连接的维持

HTTP连接建立后，客户端向服务器端发送密码或令牌报文，鉴权成功后，客户端即可向服务器端发

送电子运单报文信息，服务器端收到客户端的报文信息后将反馈应答。客户端与服务器端之间不维持长

连接，只在需要上传电子运单报文时才建立连接。

6.3连接的断开

客户端在完成上传电子运单报文后，通过调用注销接口，向服务器端发送注销请求。客户端判断HTTP

连接断开的方法：

a)通过发送注销请求主动断开；

b)数据通信链路断开；

c)数据通信链路正常，重传一定次数后仍未收到应答。

4

DB35/T1533-2015

7报文处理

7.1数据通信链路正常

数据通信链路正常时，客户端主发的HTTP报文均要求服务器端应答。客户端发现应答超时后，应对

报文进行重传。

7.2数据通信链路异常

数据通信链路异常时，客户端应对需发送的电子运单报文进行保存。在数据通信链路恢复正常后，

立即发送保存的报文。

8服务接口

8.1服务接口功能

服务接口功能如表4所示。

表4服务接口功能

服务功能描述发送方接收方发送方式

物流交换物流交换代码同步，调用服务器端的业务操作

客户端服务器端

代码查询查询服务接口

客户端登客户端登录服务器端，通过发起登录操作，获得同步，调用服务器端的安全服务

客户端服务器端

录通讯令牌接口

客户端注客户端登录服务器端，会话结束后，发起注销操同步，调用服务器端的安全服务

客户端服务器端

销作接口

报文上传同步，调用服务器端的业务操作

上传各种业务类型电子运单客户端服务器端

服务接口服务接口

8.2服务接口数据

8.2.1物流交换代码查询

输入数据

操作类型(businessType)：FJWL_EXCHANGE_CODE_SEARCH，操作类型代码见附录B。

操作内容(businessXml)：base64编码格式,xml格式如下：

<?xmlversion="1.0"encoding="UTF-8"?>

<root>

<body>

<searchUserCode>查询的物流交换代码</searchUserCode>

</body>

</root>

输出数据

result：true为服务调用成功，false为服务调用异常。

resultXml：如果result返回true，则resultXml有值，以base64编码格式表示。

5

DB35/T1533-2015

resultXml格式如下：

<?xmlversion="1.0"encoding="UTF-8"?>

<root>

<body>

<userCode>查询企业的物流交换代码</userCode>

<companyName>企业名称</companyName>

<companyType>企业类型</companyType>

<contactTel>联系电话</contactTel>

<companyUrl>企业网址</companyUrl>

<email>企业邮箱</email>

<address>企业地址</address>

<licenseNo>企业经营许可证号</licenseNo>

</body>

</root>

genericFault：异常代码和异常信息，见附录A。

8.2.2客户端登录

输入数据

username：用户名。

password：密码。

输出数据

userTokentID：用户令牌信息。

genericFault：异常代码和异常信息，见附录A。

8.2.3客户端注销

输入数据

username：用户名。

userTokentID：用户令牌信息。

输出数据

logoutResult：服务器端返回的注销结果，true为注销成功，false为注销异常。

genericFault：异常代码和异常信息，见附录A。

8.2.4报文上传服务接口

输入数据

单据编号(businessId)：上传单据的编号，由道路运输物流企业物流交换代码+“_”+派车单号表

示。

操作类型(businessType)：根据不同的业务选择操作类型代码，操作类型代码见附录B。

操作内容(businessXml)：base64编码的电子运单单据格式。

输出数据

result：服务是否调用成功，true表示服务调用成功，false表示服务调用异常。

genericFault：异常代码和异常信息，见附录A。

9单据格式

6

DB35/T1533-2015

9.1普通货物运输电子运单数据

9.1.1普通货物运输字段

普通货物运输字段说明如表5所示（*为必填）。

表5普通货物运输字段说明

字段号说明备注

省内道路运输物流企业物流交换代码+

*电子运单号

“_”+派车单单号

业务类型业务类型代码详见附录C

*道路运输证号车辆的道路运输证号

*单位名称道路运输企业名

*号牌种类号牌类型代码参考标准GA36-2014

*车牌号车牌号

*核定载重吨位单位：吨

*实际载重吨位单位：吨

*车型车辆类型代码参考标准GA802-2014

燃料类型车辆的燃料类型代码参考标准GA24.9-2005

*驾驶员姓名驾驶员姓名

*驾驶员从业资格证号驾驶员从业资格证号

*驾驶员手机驾驶员手机号

*出发时间发车时间时间格式：yyyy-MM-ddhh:mm:ss

*始发城市始发城市地区代码参考标准GB/T2260-2007

始发地区始发区县代码参考标准GB/T2260-2007

具体始发地址始发地详细地址

*预计行驶里程单位：公里

预计到达时间到站时间时间格式：yyyy-MM-ddhh:mm:ss

*到达城市到达城市地区代码参考标准GB/T2260-2007

到达地区目的地区县代码参考标准GB/T2260-2007

具体到达地址目的地详细地址

指每趟次的油耗、货代/装卸费、过路

直接成本单位：元

过桥费之和。

*货物类型货物类型代码参考标准JT/T19-2001

发货方发货方单位或个人

发货方联系人发货方具体联系人

发货方电话发货方手机号码

承运方承运方名称

承运方电话承运方手机号码

收货方收货方姓名

收货方电话收货方手机号码

9.1.2普通货物运输报文格式

7

DB35/T1533-2015

普通货物运输报文格式如表6所示。

表6普通货物运输报文格式

序报文层出现数据类型/是否必

XML标记中文名称

号Level次数数据格式（Type/Length）填

11EWayBill根节点1..1

22Header报文头1..1

33MessageReferenceNumber操作类型1..1an..35是

43MessageName报文名称1..1an..70是

53MessageVersionNumber版本号1..1an..17是

发送方物流

63SenderCode1..1an..20是

交换代码

生成日期时是

73MessageMakingDateTime1..1yyyy-MM-ddhh:mm:ss

间

报文体

82Body业务数据部1..1

分

93EWayNo电子运单号1..1an..50是

103BusinessType业务类型1..1an..30

道路运输证