园区通工程应用端技术规范试行杭州.docx
《园区通工程应用端技术规范试行杭州.docx》由会员分享，可在线阅读，更多相关《园区通工程应用端技术规范试行杭州.docx（72页珍藏版）》请在冰豆网上搜索。
园区通工程应用端技术规范试行杭州
交通物流电子枢纽
物流基地“园区通”工程
应用端技术规范
（试行）
2010-07
1实现目标
本文将阐述物流基地间的“园区通”技术方案，具体包括：
1.共享各物流基地和港区的车辆卡，实现物流园区港区车辆卡的“一卡通”。
各物流基地间共享车辆卡及卡信息，一处发卡，各基地通用，避免各基地对同一车辆重复发卡，减轻车主负担，提高车辆进出物流基地的效率，加强安全管理，防止套牌黑车，提高信用追溯能力。
2.实现物流基地间信息互通。
实现物流基地间信息互通，各物流基地的交易信息、信用信息（包括物流企业信用信息，车辆信用信息和人员信用信息）、公共信息能够共享和互动。
3.实现物流基地系统与兼容系统互连。
实现物流基地系统与兼容系统互连，即物流基地软件与车辆交易平台、物流通用软件、运管信息系统等进行有机结合，形成依托于兼容系统的“一卡通”和信息互通。
4.实现物流基地和公共服务平台互联。
实现物流基地与公共服务平台互联，依靠公共服务平台的交换服务功能，可实现与对接系统进行互联，使物流基地信息系统建设具有较高的起点。
同时公共服务平台也提供了信息展示等公共信息服务。
2业务需求
物流基地互联共享相关业务需求，包括六个方面：
●物流园区港区“一卡通”
●公共信息的互联共享
●交易信息的互联共享
●信用信息的互联共享
●业务信息的互联共享
2.1物流园区港区“一卡通”需求
1）各物流园区港区可进行车辆会员登记，并进行发卡。
2）车辆进场时，若车辆已有卡，可使用该卡，并根据基地现有条件尽量获取最及时、可靠的数据。
3）卡可被各物流基地共享，无论基地是否与中心互联。
4）当其他系统接入时，对接系统的卡只要符合下列条件，即可被各物流基地共享使用：
a）卡可被物流基地的读卡设备读取
b）卡号符合相关标准，全球唯一
c）卡内有数据，并且数据解密算法公开；或车辆档案可用卡号检索，并与交换中心对接。
5）对工本费、维护费由发卡基地收取。
暂不实现连网收费功能。
利用卡可进行停车费计费，并支持临时卡计费功能。
收费方式包括现结、包月等。
2.2公共信息的互联共享需求
公共服务平台已经实现了天气预报、企业动态、道路通堵、行业资讯、企业通用网站等服务，各物流基地可直接将这些信息和服务集成接入使用，增强物流基地信息服务能力。
2.3交易信息的互联共享需求
各物流企业系统（包括物流基地、普通运输、小件快运、集装箱等通用软件及其他兼容系统）都有车源、货源发布的功能，中心的网上交易市场每天都有大量的各地车源、货源信息。
这些信息都可以通过交换中心发布到各物流基地，在物流基地的大屏幕上进行展示。
2.4信用信息的互联共享需求
信用信息包括企业信用信息、车辆信用信息、人员信用信息三个层面。
2.4.1企业信用信息的互联共享需求
1）物流基地可对相关物流企业进行信用评价。
2）物流基地可查询各方对指定物流企业的信用评价信息。
3）物流基地可通过交换中心与运管系统对接，查看指定物流企业的基本信息。
2.4.2车辆信用信息的互联共享需求
1）物流基地可对车辆基本信息进行登记，核发车辆信息卡，并上传车辆档案信息。
2）物流基地可对车辆进行信用评价。
3）物流基地将车辆进出基地的信息进行记录并上传。
4）物流基地可查询各方对车辆的档案信息、信用评价信息、进出各基地的动态信息、运管系统的车辆安全行车事故信息等。
2.4.3人员信用信息的互联共享需求
1）物流基地可登记人员信息，并对摘要信息（只包含身份证号码，基地名称及登记日期）进行汇总。
2）物流基地可对人员（驾驶员）进行信用评价。
3）物流基地可查询人员的信用评价信息及摘要信息。
4）物流基地可通过交换中心，查询管理部门营运驾驶人员信用记录
2.5业务信息的互联共享需求
以物流基地与集装箱运输企业的业务信息互联共享为例进行阐述。
1）将物流基地集装箱堆存量统计概要信息上传到中心，供集装箱运输企业等相关企业查询。
2）将集装箱进出物流基地的信息发送到中心，供集装箱运输企业等相关企业查询。
3“园区通”数据交换设计规范
在物流基地企业进行互联互通之前，需在公共服务平台上申请物流交换代码，并安装物流基地通用软件，进行相应的设置后，就可以与和中心互联互通的系统进行信息互联共享。
通过对业务需求的理解，结合电子物流枢纽所能提供的服务和资源，我们对上述各信息互联共享需求所需接口进行了设计。
这里我们重点描述物流基地与中心的接口，对于中心与其他相关系统的接口不进行阐述。
3.1技术准备
3.1.1准备物流代码
在logink网站（http:
//eac.logink.org/eac/web/l1000/reg.jsp）申请物流交换代码。
待审核通过后，可以使用。
3.1.2接入交换中心
对于与中心接入相关资料，可参照下列网址中的《接入服务》文档（http:
//www.logink.org/zjhy/info/download.html）。
该文档有对于数据发送，数据接收，服务代理等的通用描述。
本文在详细讲述每个接口规范时，将主要阐述互联互通方式、操作类型、目标物流交换代码以及发送信息、查询条件、查询结果等的信息格式和要求。
3.2“一卡通”接口设计规范
对于报文实体标识名中的描述，需参见下表。
XML标记：
XML的元素名称（包括中文名称和英文名称）。
出现次数：
指该数据元在报文中重复出现的次数：
1）0..1——可选，且出现一次；
2）0..n——可选，且可出现多次；
3）1..1——必选，且出现一次；
4）1..n——必选，且可出现多次。
数据格式：
数据格式中使用的字符含义如下：
a=字母字符
n=数字字符
an=字母数字字符
m（m=为自然数）=定长m个字符（字符集默认为GB2312）
..ul=长度不确定的文本
..=从最小长度到最大长度，前面附加最小长度，后面附加最大长度
YYYYMMDDhhmmss=“YYYY”表示世纪和年份，“MM”表示月份，“DD”表示日期，“hh”表示小时，“mm”表示分钟，“ss”表示秒，可以视具体实际情况组合使用。
True/False=布尔型
说明：
对标记名的简要解释和应用说明。
3.2.1车辆初始发卡信息上传接口
物流基地通过物流基地通用软件对会员车辆进行登记后，发卡，并将信息上传至中心，实现共享。
采用的互联互通方式：
异步的数据交换。
操作类型：
JTWL_CLKZX_KZX_BASEINFO_Upload。
接收方：
车辆卡中心，对应的物流交换代码是CLZX00001。
报文实体：
1）车辆卡基本内容，标示名为CLZX_KZX_BASEINFO。
2）车辆照片附件（可选），标示名为CLZX_KZX_VEHICLEPHOTO。
3.2.1.1车辆卡基本内容（CLZX_KZX_BASEINFO）
XML标记
中文名称
出现
次数
数据
格式
说明
VehicleIdentifierCardNumber
车辆识别卡号
1..1
an..32
车辆卡号
VehicleIdentifierCardType
车辆识别卡
类型
1..1
an..2
参见附录
VehicleNumber
车牌号码
1..1
an..10
VehicleColor
车牌颜色代码
1..1
an..10
参见附录，传代码
VehicleColorName
车牌颜色名称
1..1
an..30
参见附录，传名称
VehicleType
车辆型号
1..1
an..10
即行驶证车型，参见附录
VehicleTonnage
核定吨位
1..1
n..6,2
VehicleCorporationName
车辆所属单位
1..1
an..50
IssueCardSystemNumber
发卡系统编号
1..1
an..4
区分不同属性卡，参见附录
CheckCode
防伪认证码
1..1
an..20
根据特定算法，根据卡号算出
UpdateDatetime
更新时间
1..1
an..17
YYYYMMDDHHMMSS
IssueDatetime
发卡时间
1..1
an..17
YYYYMMDDHHMMSS
TelephoneNumber
联系电话
1..1
an..50
ContactName
联系人名称
1..1
an..35
联系人的名称，如部门或雇员。
VehicleBusinessOperation
业务操作
1..1
an..1
A：
发卡（补卡）
C：
销卡
E-mail
电子邮件
0..1
an..50
OtherContact
其他联系方式
0..1
an..100
VehicleEngineNumber
发动机号
0..1
an..30
VehicleIdentificationNumber
车架号
0..1
an..20
VehicleManufacturerModel
厂牌型号
0..1
an..30
VehicleSeatNumber
座位
0..1
n..2
MakeUseOfName
使用者名称
0..1
an..50
使用人或单位
RoadTransportCertificateNumber
道路运输证号
0..1
an..20
即营运证编号
VehicleDrivingLicenceEeffectDate
行驶证发证日期
0..1
an..8
YYYYMMDD
VehicleDrivingLicenceineffectiveDate
行驶证截止日期
0..1
an..8
YYYYMMDD
3.2.1.2车辆照片附件（CLZX_KZX_VEHICLEPHOTO）
XML元素名
属性名
类型
是否必须
最大出现
次数
dataFileID
文件标识
属性/string
是
1
fileName
文件名
属性/string
是
1
dataFileFormat
文件格式
属性/string
是
1
AttachmentData
数据附件
子元素/base64Binary
是
1
3.2.2车辆信息查询接口（按车号、卡号、时间段）
通过精确录入的车牌号码、车辆识别卡号或更新时间段对发卡记录进行查询。
采用的互联互通方式：
同步的服务代理。
操作方法：
getVehicleCardInfo。
请求消息：
getVehicleCardInfoRequestType。
响应消息：
getVehicleCardInfoResponseType。
3.2.2.1请求消息（getVehicleCardInfoRequestType）
属性名
XML元素名
数据类型
数据
长度
出现次数
说明
查询方式
searchType
元素/String
2
1..1
V：
车牌号
C：
识别卡号
T：
卡更新时间
车牌号码信息
VehicleNumberInfomation
子元素/VehicleNumberInfomation
0..1
车牌号码和识别卡号是三选一，只能选一个。
按车牌号码、
识别卡号或更新时间段来查询
车辆识别卡号信息
VehicleIdentifierCardNumberInfomation
子元素/VehicleIdentifierCardNumberInfomation
0..1
更新时间段
UpdateDatetimeInfomatio
n
子元素/
UpdateDatetimeIn
fomation
0..1
✓车牌号码信息（VehicleNumberInfomation）
属性名
XML元素名
数据类型
数据
长度
出现次数
说明
车牌号码
VehicleNumber
元素/String
10
1..1
车牌颜色
代码
VehicleColor
元素/String
10
1..1
参见附录
✓车辆识别卡卡号信息（VehicleIdentifierCardNumberInfomation）
属性名
XML元素名
数据类型
数据
长度
出现次数
说明
车辆识别
卡号
VehicleIdentifie
rCardNumber
元素/String
32
1..1
车辆识别
卡类型
VehicleIdentifie
rCardType
元素/String
2
1..1
IC:
IC卡
RF:
RF卡
✓更新时间段信息（UpdateDatetimeInfomation）
属性名
XML元素名
数据类型
数据
长度
出现次数
说明
开始更新时间
BeginUpdateDatetime
属性/String
18
1..1
YYYYMMDDhhmmss
截止更新时间
EndUpdateDatetime
属性/String
18
1..1
YYYYMMDDhhmmss
3.2.2.2响应消息（searchVehicleCardResponseType）
属性名
XML元素名
数据类型
数据
长度
出现次数
说明
响应结果
ResultCode
元素/String
2
1..1
00:
服务提供者运行异常（由服务交换中心反馈）
01:
车辆卡不存在
02:
车辆卡存在
异常信息
ErrorMessage
元素/String
255
0..1
车辆信息
VehicleInfomation
子元素/VehicleInfomation
0..n
车辆信息，包括车辆基本信息和车辆卡信息
1、如查询方式为”V和C”时，则只出现1次。
2、如查询为“T”时，则可能出现多次
✓车辆信息（VehicleInfomation）
车辆识别卡号
VehicleIdentifie
rCardNumber
元素/String
32
1..1
车辆识别
卡类型
VehicleIdentifie
rCardType
元素/String
2
1..1
IC:
IC卡
RF:
RF卡
车牌号码
VehicleNumber
元素/String
10
1..1
车牌颜色
代码
VehicleColor
元素/String
10
1..1
车牌颜色
名称
VehicleColorName
元素/String
30
1..1
车辆型号
VehicleType
元素/String
10
1..1
核定吨位
VehicleTonnage
元素/double
6,2
1..1
车辆所属
单位
VehicleCorporationName
元素/String
50
1..1
发卡系统编号
IssueCardSystemNumber
元素/String
4
1..1
区分不同属性卡
0101：
浙江园区通
0102：
宁波港EDI
防伪认证码
CheckCode
元素/String
20
1..1
发卡单位
代码
IssueCardEnterpriseCode
元素/String
18
1..1
发卡单位代码（即物流交换代码）
车辆识别
卡状态
VehicleIdentifie
rCardStatus
元素/String
2
1..1
A：
正常
C：
注销
更新时间
UpdateDatetime
元素/String
17
1..1
发卡时间
IssueDatetime
元素/String
17
1..1
联系电话
TelephoneNumber
元素/String
50
1..1
联系人名称
ContactName
元素/String
35
1..1
电子邮件
E-mail
元素/String
50
0..1
其他联系方式
OtherContact
元素/String
100
0..1
发动机号
VehicleEngineNumber
元素/String
30
0..1
车架号
VehicleIdentificationNumber
元素/String
20
0..1
厂牌型号
VehicleManufacturerModel
元素/String
30
0..1
座位
VehicleSeatNumber
元素/int
6
0..1
使用者名称
MakeUseOfName
元素/String
50
0..1
道路运输证号
RoadTransportCertificateNumber
元素/String
20
0..1
行驶证发证日期
VehicleDrivingLicenceEeffectDate
元素/String
8
0..1
行驶证截止日期
VehicleDrivingLicenceineffectiveDate
元素/String
8
0..1
车辆识别卡信息
VehicleIdentifierCardInfomation
子元素/VehicleIdentifierCardInfomation
0..n
车辆识别卡的历史登记信息，列表包括当前有效卡
1、如查询方式为”V和C”时，才出现
2、如查询为“T”时，则不出现
✓车辆识别卡信息（VehicleIdentifierCardInfomation）
属性名
XML元素名
数据类型
数据
长度
出现次数
说明
车辆识别
卡号
VehicleIdentifie
rCardNumber
元素/String
32
1..1
车辆识别
卡类型
VehicleIdentifie
rCardType
元素/String
2
1..1
IC:
IC卡
RF:
RF卡
发卡系统编号
IssueCardSystemNumber
元素/String
4
1..1
区分不同属性卡
0101：
浙江园区通
0102：
宁波港EDI
防伪认证码
CheckCode
元素/String
20
1..1
更新时间
UpdateDatetime
元素/String
17
1..1
发卡时间
IssueDatetime
元素/String
17
1..1
发卡单位
代码
IssueCardEnterpriseCode
元素/String
18
1..1
发卡单位代码（即物流交换代码）
车辆识别
卡状态
VehicleIdentifie
rCardStatus
元素/String
2
1..1
A：
正常
C：
注销
3.2.3车辆园区登记信息上传接口
当某一已发卡的车辆第一次进入其他园区（或港区），该园区（或港区）可从中心查询到该车辆的信息，同时在本地作登记注册，并将该登记信息上传至中心。
采用的互联互通方式：
异步的数据交换。
操作类型：
ZJWL_CLZX_KZX_CARD_RemarkUpload。
目标物流交换代码：
CLZX00001。
报文名称：
JTWL_CLZX_CLBZXX。
调用形式：
ZJWL_CLZX_KZX_CARD_RemarkUpload。
3.2.3.1车辆园区登记信息
XML标记
中文名称
出现
次数
数据
格式
说明
VehicleNumber
车牌号码
1..1
an..10
VehicleColor
车牌颜色
代码
1..1
an..2
参见附录
RegistrationDateTime
登记时间
1..1
an..16
YYYYMMDDHHMMSS
Remark
备注
an..500
登记备注
3.3交易信息的互联共享接口设计规范
3.3.1车源信息发送接口
物流基地通过物流基地通用软件，将车源信息通过中心发送给相关企业（主要指相关物流基地、网上运输市场等）。
采用的互联互通方式：
异步的数据交换。
操作类型：
ZJWL_LOGINK_JYZX_InfoVehicleIssueReques。
目标交换物流代码：
JYZX00001。
发送信息格式需包括下列信息：
XML标记
中文名称
出现次数
数据格式
说明
originChineseName
企业中文名称
1..1
an..50
originName
发送方用户名
1..1
an..50
originLocal
始发地
1..1
an..30
destinaLocal
目的地
1..1
an..50
vehicleType
车辆型号
1..1
an..10
vehicleTypename
车辆型号名称
1..1
an..20
vehiclePlate
车牌号码
1..1
an..10
deadlineDate
截止日期
1..1
an..17
YYYY-MM-DDHH:
MM:
SS
beginDate
发布日期
1..1
an..17
YYYY-MM-DDHH:
MM:
SS
sourceSystem
信息来源
1..1
an..50
参见附录
vehicleUrl
车源明细URL
0..1
an..100
expectCubage
载重量
0..1
n..15,2
serverType
服务类型
0..1
an..100
contactMan
联系人
0..1
an..30
contactTel
联系电话
0..1
an..30
referenceTariff
参考运价
0..1
n..7,2
vehicleCarryLoad
车载
0..1
an..20
vehicleLen
车长
0..1
n..7,2
line
线路
0..1
an..30
describe
描述
0..1
an..200
3.3.2车源信息查询接口
物流基地通过物流基地通用软件，查询本基地相关的未查询过的有效车源信息，该查询通过中心中转，由网上货运市场处理，并将查询结果反馈给企业。
采用的互联互通方式：
同步的服务代理。
操作方法：
getVehicleResourceInfo。
3.3.2.1请求消息（getVehicleResourceInfoRequestType）
接收请求消息以XML方式描述了操作的请求数据，消息内容包括的属性如下：
属性名
升级会员 