园区通工程应用端技术规范试行杭州.docx

1、园区通工程应用端技术规范试行杭州交通物流电子枢纽物流基地“园区通”工程应用端技术规范（试行）2010-071 实现目标本文将阐述物流基地间的“园区通”技术方案，具体包括：1. 共享各物流基地和港区的车辆卡，实现物流园区港区车辆卡的“一卡通”。各物流基地间共享车辆卡及卡信息，一处发卡，各基地通用，避免各基地对同一车辆重复发卡，减轻车主负担，提高车辆进出物流基地的效率，加强安全管理，防止套牌黑车，提高信用追溯能力。2. 实现物流基地间信息互通。实现物流基地间信息互通，各物流基地的交易信息、信用信息（包括物流企业信用信息，车辆信用信息和人员信用信息）、公共信息能够共享和互动。3. 实现物流基地系统与

2、兼容系统互连。实现物流基地系统与兼容系统互连，即物流基地软件与车辆交易平台、物流通用软件、运管信息系统等进行有机结合，形成依托于兼容系统的“一卡通”和信息互通。4. 实现物流基地和公共服务平台互联。实现物流基地与公共服务平台互联，依靠公共服务平台的交换服务功能，可实现与对接系统进行互联，使物流基地信息系统建设具有较高的起点。同时公共服务平台也提供了信息展示等公共信息服务。2 业务需求物流基地互联共享相关业务需求，包括六个方面： 物流园区港区“一卡通” 公共信息的互联共享 交易信息的互联共享 信用信息的互联共享 业务信息的互联共享2.1 物流园区港区“一卡通”需求1) 各物流园区港区可进行车辆会

3、员登记，并进行发卡。2) 车辆进场时，若车辆已有卡，可使用该卡，并根据基地现有条件尽量获取最及时、可靠的数据。3) 卡可被各物流基地共享，无论基地是否与中心互联。4) 当其他系统接入时，对接系统的卡只要符合下列条件，即可被各物流基地共享使用：a) 卡可被物流基地的读卡设备读取b) 卡号符合相关标准，全球唯一c) 卡内有数据，并且数据解密算法公开；或车辆档案可用卡 号检索，并与交换中心对接。5) 对工本费、维护费由发卡基地收取。暂不实现连网收费功能。利用卡可进行停车费计费，并支持临时卡计费功能。收费方式包括现结、包月等。2.2 公共信息的互联共享需求公共服务平台已经实现了天气预报、企业动态、道路

4、通堵、行业资讯、企业通用网站等服务，各物流基地可直接将这些信息和服务集成接入使用，增强物流基地信息服务能力。2.3 交易信息的互联共享需求各物流企业系统（包括物流基地、普通运输、小件快运、集装箱等通用软件及其他兼容系统）都有车源、货源发布的功能，中心的网上交易市场每天都有大量的各地车源、货源信息。这些信息都可以通过交换中心发布到各物流基地，在物流基地的大屏幕上进行展示。2.4 信用信息的互联共享需求信用信息包括企业信用信息、车辆信用信息、人员信用信息三个层面。2.4.1 企业信用信息的互联共享需求1) 物流基地可对相关物流企业进行信用评价。2) 物流基地可查询各方对指定物流企业的信用评价信息。

5、3) 物流基地可通过交换中心与运管系统对接，查看指定物流企业的基本信息。2.4.2 车辆信用信息的互联共享需求1) 物流基地可对车辆基本信息进行登记，核发车辆信息卡，并上传车辆档案信息。2) 物流基地可对车辆进行信用评价。3) 物流基地将车辆进出基地的信息进行记录并上传。4) 物流基地可查询各方对车辆的档案信息、信用评价信息、进出各基地的动态信息、运管系统的车辆安全行车事故信息等。2.4.3 人员信用信息的互联共享需求1) 物流基地可登记人员信息，并对摘要信息（只包含身份证号码，基地名称及登记日期）进行汇总。2) 物流基地可对人员（驾驶员）进行信用评价。3) 物流基地可查询人员的信用评价信息及

6、摘要信息。4) 物流基地可通过交换中心，查询管理部门营运驾驶人员信用记录2.5 业务信息的互联共享需求以物流基地与集装箱运输企业的业务信息互联共享为例进行阐述。1) 将物流基地集装箱堆存量统计概要信息上传到中心，供集装箱运输企业等相关企业查询。2) 将集装箱进出物流基地的信息发送到中心，供集装箱运输企业等相关企业查询。3 “园区通”数据交换设计规范在物流基地企业进行互联互通之前，需在公共服务平台上申请物流交换代码，并安装物流基地通用软件，进行相应的设置后，就可以与和中心互联互通的系统进行信息互联共享。通过对业务需求的理解，结合电子物流枢纽所能提供的服务和资源，我们对上述各信息互联共享需求所需接

7、口进行了设计。这里我们重点描述物流基地与中心的接口，对于中心与其他相关系统的接口不进行阐述。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）。该文档有对于数据发送，数据接收，服务代理等的通用描述。本文在详细讲述每个接口规范时，将主要阐述互联互通方式、操作类型、目标物流交换代码以及发送信息、

8、查询条件、查询结果等的信息格式和要求。3.2 “一卡通”接口设计规范对于报文实体标识名中的描述，需参见下表。XML标记：XML的元素名称（包括中文名称和英文名称）。出现次数：指该数据元在报文中重复出现的次数：1）0.1可选，且出现一次；2）0.n可选，且可出现多次；3）1.1必选，且出现一次；4）1.n必选，且可出现多次。数据格式：数据格式中使用的字符含义如下：a = 字母字符n = 数字字符an = 字母数字字符m(m=为自然数) = 定长m个字符（字符集默认为GB2312）.ul = 长度不确定的文本. = 从最小长度到最大长度，前面附加最小长度，后面附加最大长度YYYYMMDDhhmms

9、s = “YYYY”表示世纪和年份，“MM”表示月份，“DD”表示日期，“hh”表示小时，“mm”表示分钟，“ss”表示秒，可以视具体实际情况组合使用。True/False =布尔型说明：对标记名的简要解释和应用说明。3.2.1 车辆初始发卡信息上传接口物流基地通过物流基地通用软件对会员车辆进行登记后，发卡，并将信息上传至中心，实现共享。采用的互联互通方式：异步的数据交换。操作类型：JTWL_CLKZX_KZX_BASEINFO_Upload 。接收方：车辆卡中心，对应的物流交换代码是CLZX00001。报文实体：1) 车辆卡基本内容，标示名为CLZX_KZX_BASEINFO。2) 车辆照片

10、附件（可选），标示名为CLZX_KZX_VEHICLEPHOTO。3.2.1.1 车辆卡基本内容(CLZX_KZX_BASEINFO)XML标记中文名称出现次数数据格式说明VehicleIdentifierCardNumber车辆识别卡号1.1an.32车辆卡号VehicleIdentifierCardType车辆识别卡类型1.1an.2参见附录VehicleNumber车牌号码1.1an.10VehicleColor车牌颜色代码1.1an.10参见附录，传代码VehicleColorName车牌颜色名称1.1an.30参见附录，传名称VehicleType车辆型号1.1an.10即行驶证车型

11、，参见附录VehicleTonnage 核定吨位1.1n.6,2Vehicle CorporationName车辆所属单位1.1an.50IssueCardSystemNumber发卡系统编号1.1an.4区分不同属性卡，参见附录CheckCode防伪认证码1.1an.20根据特定算法，根据卡号算出UpdateDatetime更新时间1.1an.17YYYYMMDDHHMMSSIssueDatetime发卡时间1.1an.17YYYYMMDDHHMMSSTelephoneNumber联系电话1.1an.50ContactName联系人名称1.1an.35联系人的名称，如部门或雇员。Vehicl

12、eBusinessOperation业务操作1.1an.1A：发卡(补卡)C：销卡E-mail电子邮件0.1an.50OtherContact其他联系方式0.1an.100VehicleEngineNumber发动机号0.1an.30VehicleIdentificationNumber车架号0.1an.20VehicleManufacturerModel厂牌型号0.1an.30VehicleSeatNumber座位0.1n.2MakeUseOfName使用者名称0.1an.50使用人或单位RoadTransportCertificateNumber道路运输证号0.1an.20即营运证编号Ve

13、hicleDrivingLicenceEeffectDate行驶证发证日期0.1an.8YYYYMMDDVehicleDrivingLicenceineffectiveDate行驶证截止日期0.1an.8YYYYMMDD3.2.1.2 车辆照片附件(CLZX_KZX_VEHICLEPHOTO)XML元素名属性名类型是否必须最大出现次数dataFileID文件标识属性/string是1fileName文件名属性/string是1dataFileFormat文件格式属性/string是1AttachmentData数据附件子元素/base64Binary是13.2.2 车辆信息查询接口（按车号、卡

14、号、时间段）通过精确录入的车牌号码、车辆识别卡号或更新时间段对发卡记录进行查询。采用的互联互通方式：同步的服务代理。操作方法：getVehicleCardInfo。请求消息：getVehicleCardInfoRequestType。响应消息：getVehicleCardInfoResponseType。3.2.2.1 请求消息(getVehicleCardInfoRequestType)属性名XML元素名数据类型数据长度出现次数说明查询方式searchType 元素/String21.1V：车牌号C：识别卡号T：卡更新时间车牌号码信息VehicleNumberInfomation子元素/ V

15、ehicleNumberInfomation0.1车牌号码和识别卡号是三选一，只能选一个。按车牌号码、识别卡号或更新时间段来查询车辆识别卡号信息VehicleIdentifierCardNumberInfomation子元素/ VehicleIdentifierCardNumberInfomation0.1更新时间段UpdateDatetimeInfomation子元素/UpdateDatetimeInfomation0.1 车牌号码信息(VehicleNumberInfomation)属性名XML元素名数据类型数据长度出现次数说明车牌号码VehicleNumber元素/String101.1

16、车牌颜色代码VehicleColor元素/String101.1参见附录 车辆识别卡卡号信息(VehicleIdentifierCardNumberInfomation)属性名XML元素名数据类型数据长度出现次数说明车辆识别卡号VehicleIdentifierCardNumber元素/String321.1车辆识别卡类型VehicleIdentifierCardType元素/String21.1IC:IC卡RF:RF卡 更新时间段信息(UpdateDatetimeInfomation)属性名XML元素名数据类型数据长度出现次数说明开始更新时间BeginUpdateDatetime属性/Str

17、ing181.1YYYYMMDDhhmmss截止更新时间EndUpdateDatetime属性/String181.1YYYYMMDDhhmmss3.2.2.2 响应消息(searchVehicleCardResponseType)属性名XML元素名数据类型数据长度出现次数说明响应结果ResultCode元素/String21.100:服务提供者运行异常（由服务交换中心反馈）01:车辆卡不存在02:车辆卡存在异常信息ErrorMessage元素/String2550.1车辆信息VehicleInfomation子元素/ VehicleInfomation0.n车辆信息，包括车辆基本信息和车辆卡

18、信息1、 如查询方式为”V和C”时，则只出现1次。2、 如查询为“T”时，则可能出现多次 车辆信息（VehicleInfomation）车辆识别卡号VehicleIdentifierCardNumber元素/String321.1车辆识别卡类型VehicleIdentifierCardType元素/String21.1IC:IC卡RF:RF卡车牌号码VehicleNumber元素/String101.1车牌颜色代码VehicleColor元素/String101.1车牌颜色名称VehicleColorName元素/String301.1车辆型号VehicleType元素/String101.1

19、核定吨位VehicleTonnage 元素/double6,21.1车辆所属单位Vehicle CorporationName元素/String501.1发卡系统编号IssueCardSystemNumber元素/String41.1区分不同属性卡0101：浙江园区通0102：宁波港EDI防伪认证码CheckCode元素/String201.1发卡单位代码IssueCardEnterpriseCode元素/String181.1发卡单位代码(即物流交换代码)车辆识别卡状态VehicleIdentifierCardStatus元素/String21.1A：正常C：注销更新时间UpdateDate

20、time元素/String171.1发卡时间IssueDatetime元素/String171.1联系电话TelephoneNumber元素/String501.1联系人名称ContactName元素/String351.1电子邮件E-mail元素/String500.1其他联系方式OtherContact元素/String1000.1发动机号VehicleEngineNumber元素/String300.1车架号VehicleIdentificationNumber元素/String200.1厂牌型号VehicleManufacturerModel元素/String300.1座位Vehicl

21、eSeatNumber元素/int60.1使用者名称MakeUseOfName元素/String500.1道路运输证号RoadTransportCertificateNumber元素/String200.1行驶证发证日期VehicleDrivingLicenceEeffectDate元素/String80.1行驶证截止日期VehicleDrivingLicenceineffectiveDate元素/String80.1车辆识别卡信息VehicleIdentifierCardInfomation子元素/ VehicleIdentifierCardInfomation0.n车辆识别卡的历史登记信息

22、，列表包括当前有效卡1、 如查询方式为”V和C”时，才出现2、 如查询为“T”时，则不出现 车辆识别卡信息(VehicleIdentifierCardInfomation)属性名XML元素名数据类型数据长度出现次数说明车辆识别卡号VehicleIdentifierCardNumber元素/String321.1车辆识别卡类型VehicleIdentifierCardType元素/String21.1IC:IC卡RF:RF卡发卡系统编号IssueCardSystemNumber元素/String41.1区分不同属性卡0101：浙江园区通0102：宁波港EDI防伪认证码CheckCode元素/St

23、ring201.1更新时间UpdateDatetime元素/String171.1发卡时间IssueDatetime元素/String171.1发卡单位代码IssueCardEnterpriseCode元素/String181.1发卡单位代码(即物流交换代码)车辆识别卡状态VehicleIdentifierCardStatus元素/String21.1A：正常C：注销3.2.3 车辆园区登记信息上传接口当某一已发卡的车辆第一次进入其他园区（或港区），该园区（或港区）可从中心查询到该车辆的信息，同时在本地作登记注册，并将该登记信息上传至中心。采用的互联互通方式：异步的数据交换。操作类型：ZJWL

24、_CLZX_KZX_CARD_RemarkUpload。目标物流交换代码：CLZX00001。报文名称：JTWL_CLZX_CLBZXX。调用形式：ZJWL_CLZX_KZX_CARD_RemarkUpload。3.2.3.1 车辆园区登记信息XML标记中文名称出现次数数据格式说明VehicleNumber车牌号码1.1an.10VehicleColor车牌颜色代码1.1an.2参见附录RegistrationDateTime登记时间1.1an.16YYYYMMDDHHMMSSRemark备注an.500登记备注3.3 交易信息的互联共享接口设计规范3.3.1 车源信息发送接口物流基地通过物流

25、基地通用软件，将车源信息通过中心发送给相关企业（主要指相关物流基地、网上运输市场等）。采用的互联互通方式：异步的数据交换。操作类型：ZJWL_LOGINK_JYZX_InfoVehicleIssueReques。目标交换物流代码：JYZX00001。发送信息格式需包括下列信息：XML标记中文名称出现次数数据格式说明originChineseName企业中文名称1.1an.50originName发送方用户名1.1an.50originLocal始发地1.1an.30destinaLocal目的地1.1an.50vehicleType车辆型号1.1an.10vehicleTypename车辆型号

26、名称1.1an.20vehiclePlate车牌号码1.1an.10deadlineDate截止日期1.1an.17YYYY-MM-DD HH:MM:SSbeginDate发布日期1.1an.17YYYY-MM-DD HH:MM:SSsourceSystem信息来源1.1an.50参见附录vehicleUrl车源明细URL0.1an.100expectCubage载重量0.1n.15,2serverType服务类型0.1an.100contactMan联系人0.1an.30contactTel联系电话0.1an.30referenceTariff参考运价0.1n.7,2vehicleCarryLoad车载0.1an.20vehicleLen车长0.1n.7,2line线路0.1an.30describe描述0.1an.2003.3.2 车源信息查询接口物流基地通过物流基地通用软件，查询本基地相关的未查询过的有效车源信息，该查询通过中心中转，由网上货运市场处理，并将查询结果反馈给企业。采用的互联互通方式：同步的服务代理。操作方法：getVehicleResourceInfo。3.3.2.1 请求消息（getVehicleResourceInfoRequestType）接收请求消息以XML方式描述了操作的请求数据，消息内容包括的属性如下：属性名