海关外网数据交换接口规范.doc

PAGE 1 附件3 海关外网数据交换接口规范 范围 本标准适用于进出口企业向中国电子口岸平台进行数据导入的应用场景。 本标准规定进出口企业数据导入的接口技术要求，包括接入流程、传输接口定义、业务报文接口定义、安全接口定义等。 规范性引用文件 下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅所注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。 GB/T 22239-2008 信息安全技术 信息系统安全等级保护基本要求 术语和定义 下列术语和定义适用于本文件。 3.1 报文 message 数据交换与传输的数据单元，即一次性要发送的数据块。 3.2 终端报文 terminal message 终端报文是企业向中国电子口岸平台发送的传输报文。 3.3 响应报文 response message 响应报文是一次传输过程中，中国电子口岸平台接收到企业报文之后，向企业发送的响应信息。 业务概述 功能描述 海关面向从事进出口业务的企业开放数据导入接口，帮助企业实现内部信息系统能够与中国电子口岸平台的对接，实现海关各类业务单据的数据导入，提高进出口企业的通关效率。 海关业务单据开放的导入接口范围以海关总署业务管理部门对外提供的业务功能范围为准，如超出接口开放范围以外的数据接口，企业可以直接向当地海关进行申请。 场景描述 对于进出口企业内部信息化程度较高，且有需将企业自己的通关信息直接通过内部信息系统向海关申报的要求，即可参照本规范中开放企业数据导入接口进行内部信息系统改造实现数据导入，同时通过中国电子口岸平台将海关审核结果返回给企业。 数据传输接口定义 概述 海关外网业务数据交换接口报文格式定义，包括终端报文和响应报文。报文的格式和内容应按照本标准的5.3、5.4和5.5的要求确定。 传输协议 数据交换平台对外进行数据交换时，应采用以下传输方式的一种： EDI(AS2+AS3)； AMQP； ——MQ。 其中，AMQP协议使用rabbitmq消息中间件支持；MQ使用ibmmq消息中间件支持。 数据交换平台主要协议接入业务量规定： 接入协议 日均报文量（票） 峰值报文量（票/分钟） 每票报文大小（Kb） EDI(AS2+AS3) 5000 100 1024 MQ/AMQP 5000 100 4096 终端报文 报文结构 终端报文的结构如图2所示，包括XML根元素属性、终端信息、待传输数据、附加信息和签名。附录A规定了终端报文的XML schema。 终端报文的结构 XML根元素属性 XML根元素包括ver和id两个属性，见表1。 DxpMsg节点的属性 名称 英文名称 类型 是否必填 说明 版本 ver an..3 必填 版本信息，当前版本为1.0。 W3C签名需要的ID号 Id an..6 必填 W3C签名规范，可不存在，如果存在，值不能为空，且不能为纯数字 报文描述 终端报文描述如表2所示。 终端报文 名称 英文名称 类型 是否必填 说明 终端信息 TransInfo complexType 必填 定义终端封装的相关信息 待传输数据 Data complexType 必填 放置待传输的数据，即业务报文。Data定义类型为base64编码后的业务报文 附加信息 AddInfo complexType 选填 终端封装数据的附加信息。 数据签名 Signature complexType 选填 采用W3C标准封内签格式。 报文头描述 终端报文的报文头描述如表3所示。 终端报文的报文头 名称 英文名称 类型 是否必填 说明 发送方内部报文ID CopMsgId an..255 必填 发送方定义的传输报文内部唯一编号，是此票传输报文在发送方内部的编号。 发送方ID SenderId an..16 必填 发送方的用户编号。由数据交换平台统一分配 接收方 ReceiverIds complexType 必填 接收方ID列表 接收方ID ReceiverId an..16 必填 接收方的用户编号。可出现1到5次 原始报文创建时间 CreatTime DataTime 必填 原始报文的创建时间，格式为： yyyy-mm-ddThh:mm:ss 报文类型 MsgType an..30 必填 数据交换双方对业务报文约定的标识，传输双方协定填写。 附加信息描述 报文结构见图2，附加信息描述见表4。 附加信息描述 名称 英文名称 类型 是否必填 说明 报文名 FileName an..255 选填 原始报文名 Ic卡号 IcCard an..13 选填 发送方电子口岸Ic卡号