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

中国电子口岸数据中心技术规范 海关外网数据交换接口规范（正式发布稿）2016年 4 月实施2016年 4 月发布中国电子口岸数据中心 发布目录前言III海关外网业务数据交换接口规范41 范围42 规范性引用文件43 术语和定义44 业务概述44.1 功能描述44.2 场景描述45 数据传输接口定义55.1 概述55.2 传输协议55.3 终端报文55.3.1 报文结构55.3.2 XML根元素属性65.3.3 报文描述75.3.4 报文头描述75.3.5 附加信息描述75.4 响应报文85.4.1 报文结构85.4.2 XML根元素属性95.4.3 报文描述95.4.4 报文头描述105.4.5 回执内容描述105.5 签名115.6 响应代码及其信息126 安全接口定义126.1 数据安全126.2 加签要求13A14附录A （规范性附录） 数据传输报文接口XML schema描述14附录B （规范性附录） 终端报文的XML schema描述22参考文献30前言本标准由中国电子口岸数据中心提出并归口。本标准主要起草单位： 中国电子口岸数据中心。海关外网业务数据交换接口规范1 范围本标准适用于进出口企业向中国电子口岸平台进行数据导入的应用场景。本标准规定进出口企业数据导入的接口技术要求，包括接入流程、传输接口定义、业务报文接口定义、安全接口定义等。2 规范性引用文件下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅所注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB/T 22239-2008 信息安全技术 信息系统安全等级保护基本要求3 术语和定义下列术语和定义适用于本文件。3.1 报文 message数据交换与传输的数据单元，即一次性要发送的数据块。3.2 终端报文 terminal message终端报文是企业向中国电子口岸平台发送的传输报文。3.3 响应报文 response message响应报文是一次传输过程中，中国电子口岸平台接收到企业报文之后，向企业发送的响应信息。4 业务概述4.1 功能描述海关面向从事进出口业务的企业开放数据导入接口，帮助企业实现内部信息系统能够与中国电子口岸平台的对接，实现海关各类业务单据的数据导入，提高进出口企业的通关效率。海关业务单据开放的导入接口范围以海关总署业务管理部门对外提供的业务功能范围为准，如超出接口开放范围以外的数据接口，企业可以直接向当地海关进行申请。4.2 场景描述对于进出口企业内部信息化程度较高，且有需将企业自己的通关信息直接通过内部信息系统向海关申报的要求，即可参照本规范中开放企业数据导入接口进行内部信息系统改造实现数据导入，同时通过中国电子口岸平台将海关审核结果返回给企业。5 数据传输接口定义5.1 概述海关外网业务数据交换接口报文格式定义，包括终端报文和响应报文。报文的格式和内容应按照本标准的5.3、5.4和5.5的要求确定。5.2 传输协议数据交换平台对外进行数据交换时，应采用以下传输方式的一种： EDI(AS2+AS3)；MQ。数据交换平台主要协议接入业务量规定：接入协议日均报文量（票）峰值报文量（票/分钟）每票报文大小（Kb）EDI(AS2+AS3)5000100500010040965.3 终端报文5.3.1 报文结构终端报文的结构如图2所示，包括XML根元素属性、终端信息、待传输数据、附加信息和签名。附录A规定了终端报文的XML schema。 图1 终端报文的结构5.3.2 XML根元素属性XML根元素包括ver和id两个属性，见表1。表1 DxpMsg节点的属性名称英文名称类型是否必填说明版本veran.3必填版本信息，当前版本为1.0。W3C签名需要的ID号Idan.6必填W3C签名规范，可不存在，如果存在，值不能为空，且不能为纯数字5.3.3 报文描述终端报文描述如表2所示。表2 终端报文名称英文名称类型是否必填说明终端信息TransInfocomplexType必填定义终端封装的相关信息待传输数据DatacomplexType必填放置待传输的数据，即业务报文。Data定义类型为base64编码后的业务报文附加信息AddInfocomplexType选填终端封装数据的附加信息。数据签名SignaturecomplexType必填采用W3C标准封内签格式。5.3.4 报文头描述终端报文的报文头描述如表3所示。表3 终端报文的报文头名称英文名称类型是否必填说明发送方内部报文IDCopMsgIdan.255必填发送方定义的传输报文内部唯一编号，是此票传输报文在发送方内部的编号。 发送方IDSenderIdan.16必填发送方的用户编号。由数据交换平台统一分配接收方ReceiverIdscomplexType必填接收方ID列表接收方IDReceiverIdan.16必填接收方的用户编号。可出现1到5次原始报文创建时间CreatTimeDataTime必填原始报文的创建时间，格式为：yyyy-mm-ddThh:mm:ss报文类型MsgTypean.30必填数据交换双方对业务报文约定的标识，传输双方协定填写。5.3.5 附加信息描述报文结构见图2，附加信息描述见表4。表4 附加信息描述名称英文名称类型是否必填说明报文名FileNamean.255选填原始报文名Ic卡号IcCardan.13选填发送方电子口岸Ic卡号业务关键字BizKeycomplexType选填业务关键字列表关键字KeycomplexType选填以属性name标识该业务关键字的名称，Key节点值为其对应关键字的值。该节点有1-5个文本标识节点IsTextcomplexType选填文本标识节点，如标识为文本文件，必须说明其属性字符集，如为非文本文件，该节点可不出现接收方报文转换IDRecMapIdan.16选填接收方报文转换ID5.4 响应报文5.4.1 报文结构响应报文的结构如图3所示，包括XML根元素属性，响应报文和签名。附录A规定了响应报文的XML schema。图2 响应报文的结构5.4.2 XML根元素属性XML根元素包括ver属性。如表5所示。表5 响应节点的根元素属性名称英文名称类型是否必填说明版本veran.3必填标识响应信息的版本，当前版本为1.05.4.3 报文描述响应报文描述如表6所示。表6 响应报文名称英文名称类型是否必填说明接收方IDRecevierIdan.16必填接收方终端的标识。归属节点IdAdNodeIdan.8选填该节点不会返回，无需关心。响应信息ResponsecomplexType必填见响应节点数据签名信息SignaturecomplexType选填采用W3C标准封内签格式5.4.4 报文头描述响应报文的报文头描述如表7所示。表7 响应报文的报文头名称英文名称类型是否必填说明产生错误回执的传输节点IDNodeIdan.8选填该节点不会返回，无需关心。报文处理响应码ResponseCodean.9必填报文处理响应码报文响应信息ResponseInfoan.300选填报文响应信息的详细内容回执内容ResultscomplexType选填每个接收者的处理回执内容，见表8回执产生时间NoticeTimeDataTime必填回执产生时间，由服务器生成，格式：yyyy-mm-ddThh:mm:ss备注Notean.500选填对响应信息的说明原始头OriHeadcomplexType必填原始终端节点报文的头信息5.4.5 回执内容描述回执内容描述如表8所示。表8 回执内容描述名称英文名称类型是否必填说明响应IDRecIdan.16必填16位响应ID响应代码Codean.9必填数据交换过程中，数据交换平台返回的响应代码，具体值见5.6中的表10响应信息Infoan.300必填数据交换过程中，数据交换平台返回的响应信息，具体值见5.6中的表10注释Notean.500选填数据交换过程中，数据交换平台返回的注释内容5.5 签名如需对传输报文进行数字签名，应采用W3C颁布的XML数字签名规范（W3C XML signature recommendation on 12 February 2002）进行加签处理，采用封内签格式，报文结构见图4。 图4 签名报文结构签名报文描述见表9。表9 签名报文描述名称英文名称类型是否必填说明正规化方法CanonicalizationMethodcomplexType必填采用C14N规范，该元素的属性Algorithm的值为/TR/ 2001/REC-xml-c14n-20010315签名算法SignatureMethodcomplexType必填目前采用RSA-SHA1算法，该元素的属性Algorithm的值为/2000/09/xmldsig#rsa-sha1，随着系统的升级，其算法也相应的改变摘要算法DigestMethodcomplexType必填目前采用SHA1算法，该元素的属性Algorithm的值为/2000/09/xmldsig#sha1，随着系统的升级，其算法也相应的改变数据签名信息KeyNamean.64必填在KeyInfo节点出现的时候，该节点为必填节点。用于对此票报文加签的电子口岸CA证书序号5.6 响应代码及其信息数据交换过程中，数据交换平台应及时返回响应代码及信息。表7给出了常见的响应代码及信息。表10 响应代码及信息序号响应代码响应信息10“成功”2-1201001传输报文合法性校验失败3-1201002传输验签失败4-1201003“用户注册信息已变更，请重新发送”5-1201004“接收用户不存在”6-1201005“接收用户目前不可用”7-1201006“接收用户未注册节点”8-1201007“部分接收用户处理失败”9-1201008“接收用户信息异常，请通知接收用户联系平台客服解决”上表列出的响应代码（Code）及信息（Info），Code为0时，表示数据交换平台成功将客户端请求发送给业务系统，可以进一步等待业务系统响应回执。Code不为0时，表示数据交换平台没有将客户端请求成功发送给业务系统，此时需要根据Info具体内容进行调试，必要时联系服务商协助解决。6 安全接口定义6.1 数据安全为保证用户导入的报文是合法有效的，导入报文应包含业务签名，由业务系统对业务签名进行校验，以确定该票业务报文是该用户申报的，并且数据是完整的。若校验不通过，则不允许导入。6.2 加签要求 签名的实现可以通过电子口岸安全产品（包括智能IC卡，智能密码钥匙），也可以通过密码机实现，签名信息应符合W3C加签标准。密码机需要支持电子口岸CA系统对密码机的技术要求，具体技术要求如下：（1）应具备国家密码管理局批准的商用密码产品型号证书（在有效期内）；（2）具有数字签名和签名验证功能；（3）具有密钥对生成和管理功能；（4）支持RSA（1024位/2048位）非对称密码算法；（5）支持SHA1杂凑算法；（6）支持国产SM2非对称密码算法、SM1、SM4对称密码算法、SM3杂凑算法。（7）支持按照PKCS#10标准生成证书请求并导出请求包；（8）支持双机热备或集群部署；若采用电子口岸安全产品实现加签，电子口岸提供dll形式的控件接口，该接口采用C语言开发，可供Java或.NET应用程序调用，具体接口如下：函数原型UINT Sign(BYTE *src, UINT srcLen, BYTE *sign, UINT* signLen, const char * pwd) 使用前提extern C _declspec(dllimport) UINT Sign(BYTE *src, UINT srcLen, BYTE *sign, UINT* signLen, const char * pwd)功能简介用加密设备传入报文进行加签参数说明【in】src 待签名的原始数据【in】srcLen待签名的原始数据的长度【out】sign签名数据，至少分配128字节【in，out】signLen签名数据长度，应大于128个字节，输入时应等于 szSignData实际分配的空间大小【in】pwd进行加签的卡密码返回值说明0签名成功-1卡初始化错-2卡口令不正确-3签名失败-4PEM编码失败A附录A （规范性附录） 数据传输报文接口XML schema描述客户端传输报文客户端节点待传输数据交换平台响应报文发送给用户回执时，是否可以把其归属节点信息一并返回？产生错误回执的节点id报文处理响应码报文响应信息每个接收者的