ICS 03.100.01 A02 DB35 福 建 省 地 方 标 准 DB35/T 1533-2015 道路运输物流企业电子运单接口 及单据规范 Road Freight Transportation Enterprises Electronic Transport Document Exchange and Document Specification 2015 - 11 - 09 发布 福建省质量技术监督局 2016 - 02 - 09 实施 发 布 DB35/T 1533-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/T 1533-2015 前    言 本标准按照GB/T 1.1-2009《标准化工作导则 第1部分：标准的结构和编写》给出的规则起草。 本标准由福建省交通运输厅提出。 本标准由福建省交通运输厅、福建省信息化标准化技术委员会归口。 本标准起草单位：福建省交通信息通信与应急处置中心、福建省运输管理局、福建省标准化研究院、 福建省盛辉物流集团 、福建省盛丰物流集团、福建省宏捷物流有限公司、厦门锐特信息技术有限公司、 未名（福建）信息技术有限公司。 本标准主要起草人：罗冠伟、庄孝昆、张 锦、黄淑宽、邱 淮、曾昭辉、谢紫忠、杨林、林勇、张 和宾、黄 军、黄舒宁、张宏清。 II DB35/T 1533-2015 道路运输物流企业电子运单接口及单据规范 1 范围 本标准规定了道路运输物流企业电子运单的协议基础、通信连接、报文处理、服务接口与单据规范。 本标准适用于道路运输物流企业通过客户端向服务器端上传各类电子运单。 2 规范性引用文件 下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文件。 凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。 GB/T 2260-2007 中华人民共和国行政区划代码 GB 12268-2005 危险货物品名表 GA 24.9-2005 机动车登记信息代码 第9部分 燃料(能源)种类代码 GA 36-2014 中华人民共和国机动车号牌 GA 802-2014 机动车类型 术语和定义 JT/T 19-2001 运输货物分类和代码 3 术语和定义 下列术语和定义适用于本文件。 3.1 电子运单 electronic transport document 由货运单中与运输信息相关的数据组织形成的电子运输单据。 3.2 物流交换代码 logistics exchange code 每家具备道路运输资质的道路运输物流企业在数据交换过程中所使用的唯一身份标识。 4 缩略语 下列缩略语适用于本文件。 XML：可扩展标记语言（Extensible Markup Language，XML） HTTP：超文本传输协议(Hypertext Transfer Protocol) Web Service：WEB服务（Web Service） SOAP：简单对象访问协议（Simple Object Access Protocol） REST：表述性状态传递（Representational State Transfer） 1 DB35/T 1533-2015 5 协议基础 5.1 通信方式 本协议的通信方式采用Web Service实现，符合SOAP、REST规范。通信方式支持： a) SOAP 方式调用； b) REST 方式调用。通过 HTTP 发起调用请求，利用 PUT、POST 提交数据，DELETE 删除数据，以及 GET 请求文本数据结果等。 5.2 报文 5.2.1 结构 每条报文由报文头和报文体组成。 5.2.2 结构属性 报文结构的属性如表 1 所示。 表1 报文结构属性 序号 属性名称 说明 1 报文层 Level 2 XML 标记 XML 的元素名称，采用数据元的英文名称。 3 中文名称 对数据元的中文描述。 标识数据元在报文结构中的位置和层次关系。 指该数据元在报文中重复出现的次数： a）0..1——数据元值域可填，且出现一次； 4 出现次数 b）0..n——数据元值域可填，且可出现多次； c）1..1——数据元值域必填，且出现一次； d）1..n——数据元值域必填，且可出现多次。 数据类型是用于表示数据元的符号、字符或其他表示的类型。数据元值的类型可能的取值 有： “字符型”、 “数字型”、 “日期型”、 “时间型” 、 “日期时间型”、 “布尔型”、 “二进制型”。 数据格式中使用的字符含义如下： 5 a) a = 字母字符 b) n = 数字字符 c) an = 字母数字字符 数据类型和数据 d) m(自然数) 格式 e) .. f) ， = 定长 m 个字符（字符集默认为 GB2312） = 字符型数据的最小长度到最大长度的分隔符 = 区分数字字符个数与小数点后小数位数的分隔符，即“，”前为数字字 符个数，“，”后为小数点后小数位数； g) ul = 长度不确定的文本； h) YYYYMMDDhhmmss = “YYYY”表示世纪和年份， “MM”表示月份， “DD”表示日期， “hh” 表示小时，“mm”表示分钟，“ss”表示秒，可以视具体实际情况组合使用。 i) 2 True/False =布尔型。 DB35/T 1533-2015 表1（续） 序号 属性名称 说明 示例1： an3..8 表示最大长度为8，最小长度为3的不定长字符。 数据类型和数据 5 格式 7 是否必填 示例2： an5(aannn)表示定长5个字母数字字符，前2个为字母字符，后3个为数字字符。 示例3： n..8,4 表示该数值最大长度为八位数字字符、小数点后四位数字。 是否必须填报。 5.2.3 报文头 报文头内容如表2所示。道路运输物流企业进行数据交换时，客户端需在请求报文头中加入认证时 获取的密码或令牌信息。xml格式如示例所示。 表2 报文头内容 数据类型/数据格式 是否 必 （Type/Length） 填 1..1 an..20 是 1..1 an..50 是 序号 报文层 XML 标记 中文名称 出现次数 1 1 soapenv soapenv 1..1 2 2 soapenv:Header 报文头 1..1 3 3 wsse:Security 报文头 1..1 4 4 wsse:UsernameToken 报文头 1..1 5 5 wsse:Username 用户名 6 5 wsse:Password 密码或令牌 示例：<soapenv:Header> <wsse:Security soapenv: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/T 1533-2015 表3 序号 报文层 Level 报文体内容 XML 标记 中文名称 出现次数 数据类型/数据格式（Type/Length） 是否必填 1 1 soapenv soapenv 1..1 2 2 soapenv:Body 报文头 1..1 3 3 operate 报文头 1..1 4 4 businessId 单据编号 1..1 an..20 是 5 4 busi