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

1、国库信息处理系统接口报文规范 国际收支网上申报系统企业联机接口报文规范版本号：V1.0国家外汇管理局2015年2月变更履历修改编号版本修改内容修改人修改日期1 范围 22 术语和接口说明 23 要求 23.1 数据类型定义 23.2 数据处理规则 33.3 报文格式校验 34 接口格式概述 44.1 报文接口格式结构 45 报文格式具体说明 55.1 实时业务类 56 集团型企业业务规则 117 国际收支网上申报系统报文定义 117.1 涉外收入申报单服务 117.2 境内收入申报单服务 178 涉外收支交易代码表 239 报文样例 2410 Schema校验文件 2411范围国际收支网上申报

2、系统企业联机接口报文规范，规定了国家外汇管理局（以下简称“外汇局”）国际收支网上申报系统与企业自身业务系统进行联机实时业务交互时，应采用的报文格式和规范。12术语和接口说明 标识符：唯一标识报文中一个数据项或者节点项的代码。 报文：用于外汇局与联网机构间交换信息的载体。 报文头：报文通讯使用的基本信息。 XML节点TAG：某一段数据域的标识，比如报文头、用户信息等，用于组织报文中节点项的代码。 节点代码：为了方便管理，对于接入的机构，由外汇局进行编码并分配给接入单位使用。对于企业，节点代码采用“组织机构代码证”的代码，共9位。13要求13.1数据类型定义字符集X-字符集由以下87个字符组成：A

3、 B C D E F G H I J K L M N O P Q R S T U V W X Y ZA B C D E F G H I J K L M N O P Q R S T U V W X Y Z0 1 2 3 4 5 6 7 8 9 . , - ( ) / = + ? ! “ ” % & * ; #(CR) (LF) (SPACE)对于使用TCP/IP协议的系统，X-字符集的编码（字符的二进制编码）适用于ISO-2022（ASCII）符号约定符号说明STRING表示由X-字符集组成的字符串，如：PBCGKJCFCCNSTRING表示由数字0-9组成的字符串，如：000045GBSTRI

4、NG表示由GBK字符集组成的字符串，报文规范中的长度定义以字节为单位，如：商业CURRENCY表示金额，符号位可选，整数部分最长15位，小数部分固定两位，不能包含逗号等分隔符，如：8979.05INTEGER表示整数，符号位可选，数值部分最长8位，如：88888DECIMAL表示实数，如：655785.5676LONG表示日期。日期是毫秒数，毫秒数是根据1970-1-1为参照值，由参数日期减去参照值将结果转换为毫秒数得来的如：48DATE表示日期，格式为 YYYYMMDD（年月日）。如：2005-06-11TIME表示时间，格式为 HH:MM:SS（时分秒）。如：11:28:21DATETIM

5、E表示日期时间，格式为 YYYY-MM-DD HH:MM:SS（年月日时分秒）。如：2005-06-11 11:27:39 HEXBINARY表示按十六进制编码,的二进制数据，如：4F59B25ABOOLEAN表示布尔值(TRUE或FALSE)，如：TRUE13.2数据处理规则(1) 对于每个字段所填内容，在后面的章节中针对不同报文将具体说明。(2) 当“长度”是N时表示此域出现时，长度固定为N个字符；当“长度”是1,N时表示此域出现时，其最小长度为1个字符，其最大长度为N个字符。(3) 当“强制/可选”是M时，表示此要素为强制项，必须出现；当“强制/可选”是O时，表示此要素为可选项，根据业务

6、要求填制，不必须出现，但一旦出现，则其中内容必须出现，不可为空。13.3报文格式校验本规范对XML格式的请求报文提供了Schema校验文件，请求方系统在发起请求前需要根据Schema文件对请求报文进行格式校验。14接口格式概述国家外汇管理局业务信息系统与商业银行接入机构通过报文进行联机交互。14.1报文接口格式结构报文结构参考原则规范原则所有数据报文使用XML进行描述（有特殊说明的部分以说明为准）。高效性原则由于国家外汇管理局业务信息系统对报文进行实时处理，因此将追求效率作为首要目标。易读性原则在保证报文交换和处理高效的前提下，尽可能提高报文的易读性，以利于系统测试和联调。结构说明报文结构如下

7、图所示：说明：总体上，报文全部内容封装在一个XML报文中，报文分为三大部分：报文头、报文体及报文尾。 报文头部分报文头部分用于标识XML报文的基本属性，包括报文版本号、机构类型、发起节点代码、接收节点代码、发送方系统标识、接收方系统标识、用户信息、发送时间等等信息。 报文体部分报文体部分是业务信息，包括业务参数、数据集合两部分。 报文尾部分数字签名部分用于存放报文的数字签名信息，用于交易参与方的身份认证。算法对报文开始（即从行开始）至之间的全部内容（不包括报文尾信息）进行签名，并以XML注释的形式存储于原XML报文的尾部。校验和通常在通信过程中保证内容的完整性和准确性。发送端通过对报文内容运用

8、特定算法计算得出校验和，接收端接收到报文后也对报文进行同样的计算，如果结果一致则代表内容没被改变。注：标准XML报文首位字符不允许出现空格等字符，应以?XML VERSION 开始。具体格式示例如下： 报文头内容 报文体内容 报文尾 组件组件是一个逻辑概念，它用来表示一组彼此之间有一定关系的消息域的组合。这些组件在协议中都赋以相应的名称，用来更好的理解消息结构以及所应用的场景。在实际消息传送过程中，这些组件名称并不会作为信息消息中出现，可以这么说，组件的出现是起到更好让人能够理解消息结构的作用。 重复组域可以在重复组里多次重复，用以传输数组同类的数据。在协议中，重复组也同样是一个逻辑概念，它用

9、来表示一组彼此之间有一定关系的消息域的组合能够连续反复地在消息中出现。15报文格式具体说明15.1实时业务类此类报文主要包含请求报文和回执报文。请求报文格式报文格式说明：请求报文由报文头、报文体、报文尾组成。报文头包括报文通讯使用的基本信息和控制信息；报文体包括公共参数和业务数据集合，而业务数据信息又包括分页信息、业务参数信息和业务数据信息；报文尾是数字签名和校验和信息。数据项报文头XML节点TAG：MSG-HEAD标识符字段名称类型长度备注强制/可选VER报文版本号NSTRING1,4当前为2014MORGTYPE机构类型NSTRING1,41：外汇局、2：银行、3：企业。MSRC 发起节点

10、代码NSTRING4或9企业：组织机构代码 MDES接收节点代码NSTRING6外汇局：默认100000MSRCAPP发送端应用代码STRING1,100发送端应用名称，由报文的发起方自行控制ODESAPP接收端应用代码STRING1,100接收端应用名称，例如国际收支网上申报系统为BZCNMSENDTIME发送时间DATETIME 报文发送时间MCOMMON_ORG_CODE机构代码STRING1,40企业：组织机构代码 MCOMMON_USER_CODE用户代码STRING1,40用户代码MPASSWORD密码STRING1,50密码（MD5加密后的）MSERVICEPATH访问服务信息S

11、TRING5,100服务名称+“.”+方法名称MMSGNO报文参考号STRING1,33企业：组织机构代码+年月日+8位唯一代码M报文体公共参数信息XML节点TAG：MSG-BODY-PARAMETERS 说明：此节点是业务公共参数位置,主要用于非分页查询和写操作时传参，参数的详细定义见本文档报文的定义部分。数据集信息XML节点TAG ：MSG-BODY-DATASTORES-DS标识符数据项名称类型长度数据项描述强制/可选PAGESIZE每页条数NSTRING1,10最大不能超过1000条MPAGENUMBER页码NSTRING1,10当前是多少页M说明：对于分页查询，以上内容是必输，如果不

12、输入PAGESIZE值默认是1000；对于非分页查询和写操作，以上内容无需存在。XML节点TAG ：MSG-BODY-DATASTORES-DS-PARAMETERS 说明：PARAMETERS下是业务参数，此节点下的参数为非必输参数，此节点下的参数为非必输参数，此节点为分页查询和写操作入参位置。XML节点TAG ：MSG-BODY-DATASTORES-DS-ROWSET标识符数据项名称类型长度数据项描述强制/可选ROW数据集GBSTRING数据集，可循环出现O说明：ROW可以重复出现，详细定义见本文档对报文的定义部分。报文尾XML节点TAG ：MSG- TAIL标识符数据项名称类型长度数据项描述强制/可选SIGNATURE数字签名STRING0,300暂不使用OCHECKSUM预留字段STRING0,300暂不使用O回执报文格式 报文格式说明：由一个报文头、一个回执信息、报文尾构成。数据项报文头XML节点TAG：MSG-HEAD标识符字段名称类型长度备注强制/可选VER报文版本号NSTRING1,4当前为2014MSRC 发起节点代码NSTRING6外汇局：默认100000 MDES接收节点代码NSTRING4或9银行：总行代码【金融机构代码】企业：组织机构代码MSRCAPP发送端应用代码STRING1,100外汇局端应用名称，例如国际收支网上申报系统为BZCNMDESAPP