交通运输物流公共信息平台技术方案 第5部分：数据元和代码库

交通运输物流公共信息平台技术方案第5部分：数据元和代码库LoginktechnicalsolutionPart5：dataelementsandstandardcode(Version1.0)2目录1范围..................................................................................32规范性引用文件........................................................................33概述..................................................................................34数据元................................................................................35代码集管理............................................................................35.1代码集列表..........................................................................35.1.1机动车号牌种类代码................................................................35.1.2包装类型..........................................................................35.1.3货物类型..........................................................................45.1.4地区编码..........................................................................45.1.5危险货物..........................................................................45.2应用功能............................................................................45.2.1代码下载..........................................................................45.2.2代码版本对比......................................................................45.2.3代码值下载........................................................................45.3业务接口............................................................................45.3.1标准代码版本对比..................................................................45.3.2标准代码下载......................................................................75.3.3标准代码值域下载.................................................................113交通运输物流公共信息平台技术方案第5部分：数据元和代码库1范围本部分给出了代码集、标准代码的下载和使用方法。本部分适用于交通运输物流公共信息平台的设计和开发。2规范性引用文件下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本标准。GB/T16472-1996货物类型、包装类型和包装材料类型代码JT/T19-2001运输货物分类和代码GB/T2260-2007中华人民共和国行政区划代码GA24.7-2001机动车号牌种类代码GB12268-2005危险货物品名表3概述本文档主要是定义数据元、代码集。4数据元�数据元又称为“数据元素”，用一组属性描述其定义、标识、表示和允许值的数据单元。在特定的语义环境中被认为是不可再分的数据最小单位。�数据元的定义，可以规范和统一数据标准，为不同系统的数据交换和共享提供基础。提高系统的开发质量。在平台建设中，企业间的单据交换涉及的字段都引用数据元。�本规范中，按运输基本信息、货物信息、运输工具信息、运输地点与日期信息、运输基础设施信息、装卸与搬运设备信息等类别定义的数据元。�数据元目录的定义见《交通运输物流公共信息平台数据规范第1部分：主要业务数据元》5代码集管理�代码集是一些数据元值域定义的数据，是平台对物流通用软件在数据交换中依据国家标准和行业标准，对数据元值域进行的统一约定。�目前，已有代码集：机动车号牌种类代码、包装类型、货物类型、地区编码、危险货物五种。�平台根据实际情况及时更新代码表。企业可使用物流通用软件，通过交换中心下载。5.1代码集列表5.1.1机动车号牌种类代码机动车号码种类代码值见《GA24.7-2001机动车号牌种类代码》。5.1.2包装类型4包装类型代码值见《GB/T16472-1996货物类型、包装类型和包装材料类型代码附录D》。5.1.3货物类型货物类型代码值见《JT/T19-2001运输货物分类和代码》。5.1.4地区编码地区编码值见《GB/T2260-2007中华人民共和国行政区划代码》。5.1.5危险货物危险货物值见《GB12268-2005危险货物品名表》。5.2应用功能5.2.1代码下载企业使用物流通用软件重要物流及相关信息系统,通过交换中心下载标准代码。物流通用软件及重要物流信息系统需进行接口改造，见本文档5.3.2小节。5.2.2代码版本对比为了确保企业使用的物流通用软件及重要物流信息系统的标准代码和平台的标准代码版本保持一直，要求物流通用软件及重要物流信息系统自动定期进行标准代码版本对比，如有新版本，则更新代码值。物流通用软件及重要物流信息系统需进行接口改造，见本文档5.3.1小节。5.2.3代码值下载物流通用软件及重要物流信息系统自动进行标准代码版本对比之后，发现版本号不一致，则从交换中心获取该标准代码最新值。物流通用软件及重要物流信息系统需进行接口改造，见本文档5.3.3小节。5.3业务接口5.3.1标准代码版本对比5.3.1.1描述物流通用软件在下载标准代码前，建议先进行版本对比，自动上传本地标准代码的版本号给数据交换中心，由中心应用来进行标准代码的版本做比对服务，判断物流通用软件和中心应用版本是否相同。�发送方：企业，通过小件快运、普通运输、物流基地、集装箱等物流通用软件发送�发送方式：异步，通过数据交换中心的传输服务�接收方：管理中心55.3.1.2发送数据操作�请求消息调用数据交换中心的send接口来发送版本号对比请求，send接口中请求消息由下面的属性组成：其中：�目标地址（ToAddress）默认为：BZGL00001�交换事件数据类型定义如下：��事件标识（EventID）：由物流通用软件传入的流水号，需要保证唯一性。�操作类型（ActionType）：ZJWL_LOGINK_BZGL_CompareVersionsRequest�交换数据包（ExchangeDataPackage）：字段属性、及其约束请参看《交通运输物流公共信息平台技术方案第2部分：接入系统》7.1小节。此数据交换包只对应一个数据包单元。�数据包单元（ExchangeDataPackageUnit）：字段属性定义及约束请参看《交通运输物流公共信息平台技术方案第2部分：接入系统》7.2小节；数据包单元对应的数据格式为：数据文件（DataFile）。�数据文件（DataFile）定义如下：�文件标识（dataFileID）：数据文件的标识符，分组标识是一个UUID。�文件格式（dataFileFormat）：XML�嵌入式内容（Base64EncodedData）：采用XML文件格式，以Base64编码方式将数据文件内容直接存放在此元素下，XML文件定义：?xmlversion=1.0encoding=UTF-8?root属性名XML元素名数据类型约束默认值目标地址ToAddress元素/String1..n交换事件ExchangeEvent交换事件数据类型1..n属性名XML元素名数据类型约束默认值事件标识EventIDString1..1操作类型ActionTypeString1..1交换数据包ExchangeDataPackage交换数据包数据类型1..1属性名XML元素名类型是否必须最大出现次数文件标识dataFileID属性/string是1文件名fileName属性/string是1文件格式dataFileFormat属性/string是1嵌入式内容Base64EncodedData子元素/base64Binary是16DataUnitdataUnitId数据元ID/dataUnitIdversionNo版本号/versionNo/DataUnit/root�响应消息接收数据的请求消息涉及的接口规范请参看《交通运输物流公共信息平台技术方案第2部分：接入系统》和对应的WSDL和XSD文件。5.3.1.3接收数据响应�请求消息接收数据的请求消息涉及的接口规范请参看《交通运输物流公共信息平台技术方案第2部分：接入系统》和对应的WSDL和XSD文件。�响应消息调用数据交换中心的receive接口接收操作来返回版本是否相同的标志，接收操作的响应消息封装了接收操作执行的返回结果，响应消息包括的属性如下：1)交换事件数据类型定义如下：�事件标识（EventID）：事件标识流水号。操作类型（ActionType）：ZJWL_LOGINK_BZGL_CompareVersionsResponse。�交换数据包（ExchangeDataPackage）：字段属性、及其约束请参看《交通运输物流公共信息平台技术方案第2部分：接入系统》7.1小节。此数据交换包只对应一个数据包单元。�数据包单元（ExchangeDataPackageUnit）：字段属性定义及约束请参看《交通运输物流公共信息平属性名XML元素名数据类型约束默认值未处理事件数TotalEventCountString1..10接收事件ReceiveExchangeEvent交换事件数据类型0..n异常信息GenericFault通用异常类型0..1属性名XML元素名数据类型约束默认值事件标识EventIDString1..1操作类型ActionTypeString1..1交换数据包ExchangeDataPackage1..17台技术方案第2部分：接入系统》7.2小节；数据包单元对应的数据格式为：数据文件（DataFile）。�数据文件（DataFile）定义如下：�文件标识（dataFileID）：数据文件的标识符，分组标识是一个UUID。�文件格式（dataFileFormat）：XML�嵌入式内容（Base64EncodedData）：采用XML文件格式，以Base64编码方式将数据文件内容直接存放在此元素下，XML文件定义：?xmlversion=1.0encodin