输入手机号查物流单号通信业务接口
(Version1.0)
1范围
本部分给出了交通运输物流公共信息平台提供的公共服务调用接口规范。
本部分适用于交通运输物流公共信息平台的设计和开发。
2通信业务接口
2.1用户手机短信查询（小件）
2.1.1描述
小件快运企业的用户，使用手机短信可跟踪货物的托运状态。
用户在手机终端上编写短信（包含托运单号，电信特服号），发至电信平台，电信平台受到短信后，组装xml报文，发送到数据交换中心，供货物跟踪中心。
�发送方：电信短信平台
�发送方式：异步，通过数据交换中心的传输服务。
�接收方：货物跟踪中心。
2.1.2发送数据操作(send)
2.1.2.1请求消息
调用数据交换中心的send接口来发送请求消息，send接口中请求消息由下面的属性组成：
属性名XML元素名数据类型约束默认值
目标地址ToAddress元素/String 1..n
交换事件ExchangeEvent交换事件数据类型 1..n
其中：
�目标地址（ToAddress）默认为：HWGZ00001
�交换事件数据类型定义如下：
属性名XML元素名数据类型约束默认值
事件标识EventID String 1..1
操作类型ActionType String 1..1
交换数据包ExchangeDataPackage XML数据文件 1..1
�事件标识（EventID）：由标准版客户端传入的流水号，需要保证唯一性。
�操作类型（ActionType）：JTWL_MESSAGE_HWGZ_XIAOJIAN_BillQuery
�交换数据包（ExchangeDataPackage）：字段属性、及其约束请参看《数据格式规范》第5节。此数据交换包只对应一个数据包单元。
�数据包单元（ExchangeDataPackageUnit）：字段属性定义及约束请参看《数据格式规范》
第6节；数据包单元对应的数据格式为：数据文件（DataFile）。
�数据文件（DataFile）定义如下：
属性名XML元素名类型是否必须最大出现次
数
文件标识dataFileID属性/string是1
文件名fileName属性/string是1
文件格式dataFileFormat属性/string是1
嵌入式内容Base64EncodedData子元素/base64Binary是1
�文件标识（dataFileID）：数据文件的标识符，分组标识是一个UUID。
�文件格式（dataFileFormat）：XML
�嵌入式内容（Base64EncodedData）：采用XML文件格式，以Base64编码方式将数据文件内容直接存放在此元素下。
XML具体定义描述如下：
<?xml version='1.0'encoding='UTF-8'?>
<root>
<simNo>通信卡号</simNo>
<msgFmt>短信格式（预留）</msgFmt>
<targetID>接收号（预留）</targetID>
<content>短信内容</content>
</root>
2.1.2.2响应消息
发送数据操作的响应消息的接口规范见《交通运输物流公共信息平台系统规范第4部分：接入服务》、《交通运输物流公共信息平台接入服务－数据格式规范》和对应的WSDL和XSD 文件。
2.2手机短信查询（普通运输）
2.2.1描述
普通运输企业的用户，使用手机短信可跟踪货物的托运状态。
用户在手机终端上编写短信（包含托运单号，电信特服号），发至电信平台，电信平台受到短信后，组装xml报文，发送到数据交换中心，供货物跟踪中心下载。
�发送方：电信平台
�发送方式：异步，通过数据交换中心的传输服务
�接收方：货物跟踪中心。
2.2.2发送数据操作(send)
2.2.2.1请求消息
调用数据交换中心的send接口来发送请求消息，send接口中请求消息由下面的属性组成：
属性名XML元素名数据类型约束默认值
目标地址ToAddress元素/String 1..n
交换事件ExchangeEvent交换事件数据类型 1..n
其中：
�目标地址（ToAddress）默认为：HWGZ00002
�交换事件数据类型定义如下：
属性名XML元素名数据类型约束默认值
事件标识EventID String 1..1
操作类型ActionType String 1..1
交换数据包ExchangeDataPackage XML数据文件 1..1
�事件标识（EventID）：由标准版客户端传入的流水号，需要保证唯一性。
�操作类型（ActionType）：JTWL_MESSAGE_HWGZ__YSL_BillQuery
�交换数据包（ExchangeDataPackage）：字段属性、及其约束请参看《数据格式规范》第5节。此数据交换包只对应一个数据包单元。
�数据包单元（ExchangeDataPackageUnit）：字段属性定义及约束请参看《数据格式规范》第6节；数据包单元对应的数据格式为：数据文件（DataFile）。
�数据文件（DataFile）定义如下：
属性名XML元素名类型是否必须最大出现次
数
文件标识dataFileID属性/string是1
文件名fileName属性/string是1
文件格式dataFileFormat属性/string是1
嵌入式内容Base64EncodedData子元素/base64Binary是1
�文件标识（dataFileID）：数据文件的标识符，分组标识是一个UUID。
�文件格式（dataFileFormat）：XML
�嵌入式内容（Base64EncodedData）：采用XML文件格式，以Base64编码方式将数据文件内容直接存放在此元素下。
XML具体定义描述如下：
<?xml version='1.0'encoding='UTF-8'?>
<root>
<simNo>通信卡号</simNo>
<msgFmt>短信格式（预留）</msgFmt>
<targetID>接收号（预留）</targetID>
<content>短信内容</content>
</root>
发布评论