国库信息处理系统接口报文规范

国际收支网上申报系统企业联机接口报文规范版本号：V1.0国家外汇管理局2015年2月国际收支网上申报系统企业联机接口报文规范变更履历修改编号版本修改内容修改人修改日期国际收支网上申报系统企业联机接口报文规范第1页目录1范围.......................................................................................................................................................................22术语和接口说明...................................................................................................................................................23要求.......................................................................................................................................................................23.1数据类型定义..............................................................................................................................................23.2数据处理规则..............................................................................................................................................33.3报文格式校验..............................................................................................................................................34接口格式概述.......................................................................................................................................................44.1报文接口格式结构......................................................................................................................................45报文格式具体说明...............................................................................................................................................55.1实时业务类..................................................................................................................................................56集团型企业业务规则.........................................................................................................................................117国际收支网上申报系统报文定义.....................................................................................................................117.1涉外收入申报单服务................................................................................................................................117.2境内收入申报单服务................................................................................................................................178涉外收支交易代码表.........................................................................................................................................239报文样例.............................................................................................................................................................2410SCHEMA校验文件.............................................................................................................................................24国际收支网上申报系统企业联机接口报文规范第2页1范围《国际收支网上申报系统企业联机接口报文规范》，规定了国家外汇管理局（以下简称“外汇局”）国际收支网上申报系统与企业自身业务系统进行联机实时业务交互时，应采用的报文格式和规范。2术语和接口说明标识符：唯一标识报文中一个数据项或者节点项的代码。报文：用于外汇局与联网机构间交换信息的载体。报文头：报文通讯使用的基本信息。XML节点TAG：某一段数据域的标识，比如报文头、用户信息等，用于组织报文中节点项的代码。节点代码：为了方便管理，对于接入的机构，由外汇局进行编码并分配给接入单位使用。对于企业，节点代码采用“组织机构代码证”的代码，共9位。3要求3.1数据类型定义3.1.1字符集X-字符集由以下87个字符组成：ABCDEFGHIJKLMNOPQRSTUVWXYZABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789.,-()/=‘’+?!“”%&*;@#(CR)(LF)(SPACE)对于使用TCP/IP协议的系统，X-字符集的编码（字符的二进制编码）适用于ISO-2022（ASCII）3.1.2符号约定符号说明STRING表示由X-字符集组成的字符串，如：PBCGKJCFCC国际收支网上申报系统企业联机接口报文规范第3页NSTRING表示由数字[0-9]组成的字符串，如：000045GBSTRING表示由GBK字符集组成的字符串，报文规范中的长度定义以字节为单位，如：商业CURRENCY表示金额，符号位可选，整数部分最长15位，小数部分固定两位，不能包含逗号等分隔符，如：8979.05INTEGER表示整数，符号位可选，数值部分最长8位，如：88888DECIMAL表示实数，如：655785.5676LONG表示日期。日期是毫秒数，毫秒数是根据1970-1-1为参照值，由参数日期减去参照值将结果转换为毫秒数得来的如：1333248494648DATE表示日期，格式为YYYYMMDD（年月日）。如：2005-06-11TIME表示时间，格式为HH:MM:SS（时分秒）。如：11:28:21DATETIME表示日期时间，格式为YYYY-MM-DDHH:MM:SS（年月日时分秒）。如：2005-06-1111:27:39HEXBINARY表示按十六进制编码,的二进制数据，如：4F59B25ABOOLEAN表示布尔值(TRUE或FALSE)，如：TRUE3.2数据处理规则(1)对于每个字段所填内容，在后面的章节中针对不同报文将具体说明。(2)当“长度”是N时表示此域出现时，长度固定为N个字符；当“长度”是[1,N]时表示此域出现时，其最小长度为1个字符，其最大长度为N个字符。(3)当“强制/可选”是M时，表示此要素为强制项，必须出现；当“强制/可选”是O时，表示此要素为可选项，根据业务要求填制，不必须出现，但一旦出现，则其中内容必须出现，不可为空。3.3报文格式校验本规范对XML格式的请求报文提供了Schema校验文件，请求方系统在发起请求前需要根据Schema文件对请求报文进行格式校验。国际收支网上申报系统企业联机接口报文规范第4页4接口格式概述国家外汇管理局业务信息系统与商业银行接入机构通过报文进行联机交互。4.1报文接口格式结构4.1.1报文结构4.1.1.1参考原则4.1.1.1.1规范原则所有数据报文使用XML进行描述（有特殊说明的部分以说明为准）。4.1.1.1.2高效性原则由于国家外汇管理局业务信息系统对报文进行实时处理，因此将追求效率作为首要目标。4.1.1.1.3易读性原则在保证报文交换和处理高效的前提下，尽可能提高报文的易读性，以利于系统测试和联调。4.1.1.2结构说明报文结构如下图所示：域1Compoent组件Message报文Header报文头Body报文体Tail报文尾域2域3域块域块域10域块RepeatingGroup重复组GroupBlock1组块1GroupBlock2组块2GroupBlockn组块n域域块域块域域块域域块组块：表示重复组中每块重复部分，也是由域块组成域：表示某个域域块：表示多个域集合重复组：表示重复组，可由多个重复组块组成组件：表示多个域的集合，这些域所代表的含义之间具有关联性说明：总体上，报文全部内容封装在一个XML报文中，报文分为三大部分：报文头、报文体及报文尾。报文头部分报文头部分用于标识XML报文的基本属性，包括报文版本号、机构类型、发起节点代码、接收节点代码、发送方系统标识、接收方系统标识、用户信息、发送时间等等信息。国际收支网上申报系统企业联机接口报文规范第5页报文体部分报文体部分是业务信息，包括业务参数、数据集合两部分。报文尾部分数字签名部分用于存放报文的数字签名信息，用于交易参与方的身份认证。算法对报文开始（即从?XMLVERSION==1.0ENCODING=GBK?行开始）至/MSG之间的全部内容（不包括报文尾信息）进行签名，并以XML注释的形式存储于原XML报文的尾部。校验和通常在通信过程中保证内容的完整性和准确性。发送端通过对报文内容运用特定算法计算得出校验和，接收端接收到报文后也对报文进行同样的计算，如果结果一致则代表内容没被改变。注：标准XML报文首位字符不允许出现空格等字符，应以?XMLVERSION开始。具体格式示例如下：?XMLVERSION=1.0ENCODING=GBK?MSGHEAD报文头内容/HEAD