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

中国电子口岸数据中心技术规范 海关外网数据交换接口规范（正式发布稿）年 月实施年 月发布中国电子口岸数据中心 发布目录前言海关外网业务数据交换接口规范 范围 规范性引用文件 术语和定义 业务概述 功能描述 场景描述 数据传输接口定义 概述 传输协议 终端报文 报文结构 根元素属性 报文描述 报文头描述 附加信息描述 响应报文 报文结构 根元素属性 报文描述 报文头描述 回执内容描述 签名 响应代码及其信息 安全接口定义 数据安全 加签要求附录 （规范性附录） 数据传输报文接口 描述附录 （规范性附录） 终端报文的 描述参考文献前言本标准由中国电子口岸数据中心提出并归口。本标准主要起草单位： 中国电子口岸数据中心。29 / 29海关外网业务数据交换接口规范1 范围本标准适用于进出口企业向中国电子口岸平台进行数据导入的应用场景。本标准规定进出口企业数据导入的接口技术要求，包括接入流程、传输接口定义、业务报文接口定义、安全接口定义等。2 规范性引用文件下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅所注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。 信息安全技术 信息系统安全等级保护基本要求3 术语和定义下列术语和定义适用于本文件。 报文 数据交换与传输的数据单元，即一次性要发送的数据块。 终端报文 终端报文是企业向中国电子口岸平台发送的传输报文。 响应报文 响应报文是一次传输过程中，中国电子口岸平台接收到企业报文之后，向企业发送的响应信息。4 业务概述4.1 功能描述海关面向从事进出口业务的企业开放数据导入接口，帮助企业实现内部信息系统能够与中国电子口岸平台的对接，实现海关各类业务单据的数据导入，提高进出口企业的通关效率。海关业务单据开放的导入接口范围以海关总署业务管理部门对外提供的业务功能范围为准，如超出接口开放范围以外的数据接口，企业可以直接向当地海关进行申请。4.2 场景描述对于进出口企业内部信息化程度较高，且有需将企业自己的通关信息直接通过内部信息系统向海关申报的要求，即可参照本规范中开放企业数据导入接口进行内部信息系统改造实现数据导入，同时通过中国电子口岸平台将海关审核结果返回给企业。5 数据传输接口定义5.1 概述海关外网业务数据交换接口报文格式定义，包括终端报文和响应报文。报文的格式和内容应按照本标准的、和的要求确定。5.2 传输协议数据交换平台对外进行数据交换时，应采用以下传输方式的一种： ()；。数据交换平台主要协议接入业务量规定：接入协议日均报文量（票）峰值报文量（票分钟）每票报文大小（）()5.3 终端报文5.3.1 报文结构终端报文的结构如图所示，包括根元素属性、终端信息、待传输数据、附加信息和签名。附录规定了终端报文的 。 图1 终端报文的结构5.3.2 根元素属性根元素包括和两个属性，见表。表1 节点的属性名称英文名称类型是否必填说明版本必填版本信息，当前版本为。签名需要的号必填签名规范，可不存在，如果存在，值不能为空，且不能为纯数字5.3.3 报文描述终端报文描述如表所示。表2 终端报文名称英文名称类型是否必填说明终端信息必填定义终端封装的相关信息待传输数据必填放置待传输的数据，即业务报文。定义类型为编码后的业务报文附加信息选填终端封装数据的附加信息。数据签名必填采用标准封内签格式。5.3.4 报文头描述终端报文的报文头描述如表所示。表3 终端报文的报文头名称英文名称类型是否必填说明发送方内部报文必填发送方定义的传输报文内部唯一编号，是此票传输报文在发送方内部的编号。 发送方必填发送方的用户编号。由数据交换平台统一分配接收方必填接收方列表接收方必填接收方的用户编号。可出现到次原始报文创建时间必填原始报文的创建时间，格式为：报文类型必填数据交换双方对业务报文约定的标识，传输双方协定填写。5.3.5 附加信息描述报文结构见图，附加信息描述见表。表4 附加信息描述名称英文名称类型是否必填说明报文名选填原始报文名卡号选填发送方电子口岸卡号业务关键字选填业务关键字列表关键字选填以属性标识该业务关键字的名称，节点值为其对应关键字的值。该节点有个文本标识节点选填文本标识节点，如标识为文本文件，必须说明其属性字符集，如为非文本文件，该节点可不出现接收方报文转换选填接收方报文转换5.4 响应报文5.4.1 报文结构响应报文的结构如图所示，包括根元素属性，响应报文和签名。附录规定了响应报文的 。图2 响应报文的结构5.4.2 根元素属性根元素包括属性。如表所示。表5 响应节点的根元素属性名称英文名称类型是否必填说明版本必填标识响应信息的版本，当前版本为5.4.3 报文描述响应报文描述如表所示。表6 响应报文名称英文名称类型是否必填说明接收方必填接收方终端的标识。归属节点选填该节点不会返回，无需关心。响应信息必填见响应节点数据签名信息选填采用标准封内签格式5.4.4 报文头描述响应报文的报文头描述如表所示。表7 响应报文的报文头名称英文名称类型是否必填说明产生错误回执的传输节点选填该节点不会返回，无需关心。报文处理响应码必填报文处理响应码报文响应信息选填报文响应信息的详细内容回执内容选填每个接收者的处理回执内容，见表回执产生时间必填回执产生时间，由服务器生成，格式：备注选填对响应信息的说明原始头必填原始终端节点报文的头信息5.4.5 回执内容描述回执内容描述如表所示。表8 回执内容描述名称英文名称类型是否必填说明响应必填位响应响应代码必填数据交换过程中，数据交换平台返回的响应代码，具体值见中的表响应信息必填数据交换过程中，数据交换平台返回的响应信息，具体值见中的表注释选填数据交换过程中，数据交换平台返回的注释内容5.5 签名如需对传输报文进行数字签名，应采用颁布的数字签名规范（ ）进行加签处理，采用封内签格式，报文结构见图。 图 签名报文结构签名报文描述见表。表9 签名报文描述名称英文名称类型是否必填说明正规化方法必填采用规范，该元素的属性的值为 签名算法必填目前采用算法，该元素的属性的值为，随着系统的升级，其算法也相应的改变摘要算法必填目前采用算法，该元素的属性的值为，随着系统的升级，其算法也相应的改变数据签名信息必填在节点出现的时候，该节点为必填节点。用于对此票报文加签的电子口岸证书序号5.6 响应代码及其信息数据交换过程中，数据交换平台应及时返回响应代码及信息。表给出了常见的响应代码及信息。表10 响应代码及信息序号响应代码响应信息“成功”传输报文合法性校验失败传输验签失败“用户注册信息已变更，请重新发送”“接收用户不存在”“接收用户目前不可用”“接收用户未注册节点”“部分接收用户处理失败”“接收用户信息异常，请通知接收用户联系平台客服解决”上表列出的响应代码（）及信息（），为时，表示数据交换平台成功将客户端请求发送给业务系统，可以进一步等待业务系统响应回执。不为时，表示数据交换平台没有将客户端请求成功发送给业务系统，此时需要根据具体内容进行调试，必要时联系服务商协助解决。6 安全接口定义6.1 数据安全为保证用户导入的报文是合法有效的，导入报文应包含业务签名，由业务系统对业务签名进行校验，以确定该票业务报文是该用户申报的，并且数据是完整的。若校验不通过，则不允许导入。6.2 加签要求 签名的实现可以通过电子口岸安全产品（包括智能卡，智能密码钥匙），也可以通过密码机实现，签名信息应符合加签标准。密码机需要支持电子口岸系统对密码机的技术要求，具体技术要求如下：（）应具备国家密码管理局批准的商用密码产品型号证书（在有效期内）；（）具有数字签名和签名验证功能；（）具有密钥对生成和管理功能；（）支持（位位）非对称密码算法；（）支持杂凑算法；（）支持国产非对称密码算法、对称密码算法、杂凑算法。（）支持按照标准生成证书请求并导出请求包；（）支持双机热备或集群部署；若采用电子口岸安全产品实现加签，电子口岸提供形式的控件接口，该接口采用语言开发，可供或应用程序调用，具体接口如下：函数原型 ( *, , *, * , * ) 使用前提 () ( *, , *, * , * )功能简介用加密设备传入报文进行加签参数说明【】 待签名的原始数据【】待签名的原始数据的长度【】签名数据，至少分配字节【，】签名数据长度，应大于个字节，输入时应等于 实际分配的空间大小【】进行加签的卡密码返回值说明签名成功卡初始化错卡口令不正确签名失败编码失败A附录A （规范性附录） 数据传输报文接口 描述客户端传输报文客户端节点待传输数据交换平台响应报文发送给用户回执时，是否可以把其归属节点信息一并返回？产生错误回执的节点报文处理响应码报文响应信息每个接收者的处理回执内容回执产生时间，由服务器生成备注原始报文发送方接收方，可支持多个接收方原始报文创建时间报文类型原始报文名，可选卡号业务关键字，可选文本标识节点，存在标识为文本，必须说明字符集字符集接收方报文转换附录B （规范性附录）终端报文的 描述终端报文的 描述如下，其中包括了响应节点的报文描述。 终端报文 响应报文 发送给用户回执时，可把其归属节点信息一并返回 产生错误回执的节点 报文处理响应码 报文响应信息 每个接收者的处理回执内容 回执产生时间，由服务