交通运输物流公共信息平台技术方案-第2部分：接入系统

交通运输物流公共信息平台技术方案第2部分:接入系统LoginktechnicalsolutionPart2：accesssystem(Version1.0)1目录1范围..................................................................................22规范性引用............................................................................23概述..................................................................................24交换认证服务..........................................................................24.1安全认证服务......................................................................24.2退出授权服务......................................................................35数据交换服务..........................................................................35.1数据发送服务(send)................................................................45.2数据接收服务(receive).............................................................45.3接收确认服务(confirmReceive)......................................................55.4业务代理服务(proxySend)...........................................................66数据类型定义..........................................................................76.1简单数据类型......................................................................76.2复杂数据类型......................................................................77数据格式..............................................................................87.1交换数据包........................................................................87.2数据包单元........................................................................97.3国标业务数据.....................................................................107.4数据文件.........................................................................117.5简单数据.........................................................................127.6CSV数据文件......................................................................128传输错误代码.........................................................................12附录A（规范性附录）WSDL和XMLSchema文件...........................................14A.1交换同步传输服务接口定义（ExchangeTransPortService.wsdl）..........................14A.2交换安全服务接口定义（exchange-security.wsdl）.....................................18A.3业务代理服务接口定义（ExchangeBusinessProxyService.wsdl）..........................19A.4交换同步传输服务XML消息定义（ExchangeTransportSystem.xsd）.......................21A.5业务代理服务XML消息定义（ExchangeBusinessProxy-data-format.xsd）.................25A.6交换安全服务XML消息定义（exchange-security.xsd）.................................26A.7基本数据类型XML消息定义（coreDataTypes.xsd）.....................................27A.8数据格式XML消息定义（exchange-data-format.xsd）..................................28A.9业务数据表示格式XML消息定义（egs-org-cn-businessdata.xsd）.......................29附录B（资料性附录）API接口说明.....................................................32B.1Cuteinfo客户端API接口说明(.Net版）.............................................32B.2Cuteinfo客户端API接口说明(Java版)...............................................322交通运输物流公共信息平台技术方案第2部分：接入系统1范围本部分给出了交通运输物流公共信息平台的安全、交换传输的技术要求。本部分适用于交通运输物流公共信息平台的设计和开发。2规范性引用《GB/T21062政务信息资源交换体系第1部分总体框架》3概述本部分规范了企业接入交换中心所遵循的技术要求和约束，包括：交换认证，交换传输，数据类型、数据格式、错误代码等。是数据交换的技术规范，采用Webservice技术，遵循的技术规范有:WSDL、SOAP、WS-Security等，并且平台提供一整套API，使物流通用软件重要物流及相关信息系统可快速接入平台。其中，数据格式定义了系统间基于消息机制进行数据交换时数据的表示格式，本规范在使用国标已经定义的数据接口模型的基础上，进行补充、细化；经过补充和细化后，数据格式规范扩充了表达大量数据集合、非结构化数据文件以及多种格式数据的能力，同时增强了交换的数据的元数据信息。4交换认证服务企业接入交换中心的一种安全保障机制，为交换双方提供平台级身份安全认证和交换的合法性认证。包括安全认证操作和退出授权操作。企业在进行数据交换前，首先调用平台的安全认证服务，该安全认证服务返回给企业一个令牌标识。企业进行数据交换时，物流通用软件、重要物流及相关信息系统需在请求消息头中加入认证时获取的令牌信息。令牌信息在消息头中通过ws-security格式来描述，示例如下：wsse:Securitywsse:UsernameTokenwsse:UsernameuserName/wsse:Usernamewsse:UserTokenIDpwdvalue/wsse:UserTokenID/wsse:UsernameToken/wsse:Security其中，企业进行用户认证时，使用的用户名（userName）是企业通过平台管理中心的门户网站上申请时自动获取的物流交换代码，密码（pwdvalue）是企业通过平台网站上申请时填写的密码。申请物流交换代码见《交通运输物流公共信息平台技术方案第1部分：物流交换代码》4.1安全认证服务34.1.1概述安全认证服务是一种基于web的服务，从输入消息和输出消息两部分服务属性进行约定,完成对用户身份的安全认证。4.1.2请求消息用户安全认证消息以XML方式描述了需要进行认证的用户信息。认证请求消息包括用户名和密码4.1.3响应消息用户认证操作将用户的令牌标识以XML格式封装返回给用户。如果认证失败，返回用户错误代码和错误原因。�认证失败（GenericFaul）:是复杂数据类型，由数据类型进行完整描述，见本部分中6.2.3通用异常数据类型。4.2退出授权服务4.2.1概述退出授权服务是一种基于web的服务，从输入消息和输出消息两部分服务属性进行约定,完成对用户退出登录的功能4.2.2请求消息用户注销登陆请求消息以XML方式描述了用户名称和用户令牌标识。4.2.3响应消息用户退出授权服务请求以XML方式返回用户注销操作的结果。属性名XML元素名数据类型约束说明账号名称Username属性/String1..1账号密码Password属性/String1..1属性名XML元素名数据类型约束说明账号名称Username属性/String1..1账号密码Password属性/String1..1属性名XML元素名数据类型约束说明退出结果LogoutResult属性/boolean1..1属性名XML元素名数据类型约束默认值用户令牌标识UserTokentID属性/String0..1认证失败GenericFaul元素/复杂数据类型0..145数据交换服务支持分布或异构应用系统，通过交换平台进行信息交换的、面向SOA（面向服务架构）的一种信息系统服务模式，目前提供发送、接收、接收确认、业务代理服务。5.1数据发送服务(send)5.1.1概述数据发送服务是一种基于web的服务，从输入消息和输出消息两部分服务属性进行约定，为企业提供了发送数据的功能，采用异步方式的交换传输技术规范。5.1.2请求消息存储输入数据消息以XML方式描述了通用的存储请求。请求消息由数据目标地址、交换事件是否同步发送属性组成，请求消息主要由下面的属性组成：其中：�目标地址（ToAddress）为：数据事件发送的目的地址。这里地址类型可以单个用户地址，也可以群组地址；�交换事件数据类型:需要发送的数据进行封装，由交换事件数据类型进行完整描述，见本部分6.2.1交换事件数据类型。5.1.3响应消息响应消息是将操作结果封装。响应消息是发送结果类型。由执行状态，发送失败集组成。其中：�发送结果：整数类型。表示发送操作是否执行成功；�失败信息：执行发送失败的复杂类型。包括错误代码和错误原因，见本部分中6.2.3通用异常数据类型。5.2数据接收服务(receive)5.2.1概述数据接收服务是一种基于web的服务，从输入消息和输出消息两部分服务属性进行约定,为企业提供了接收数据的功能，采用异步方式的交换传输技术规范。属性名XML元素名数据类型约束默认值目标地址ToAddress元素/String1..n交换事件Exchang