PDF《国际收支网上申报系统》

国际收支网上申报系统企业联机接口报文规范版本号:V1.

0国家外汇管理局2015 年2月国际收支网上申报系统 企业联机接口报文规范 变更履历 修改编号 版本 修改内容 修改人 修改日期 国际收支网上申报系统 企业联机接口报文规范 第1页目录1范围.2

2 术语和接口说明.2

3 要求.2 3.1 数据类型定义

2 3.2 数据处理规则

3 3.3 报文格式校验

3 4 接口格式概述.4 4.1 报文接口格式结构.4

5 报文格式具体说明.5 5.1 实时业务类.5

6 集团型企业业务规则

11 7 国际收支网上申报系统报文定义

11 7.1 涉外收入申报单服务.11 7.2 境内收入申报单服务.17

8 涉外收支交易代码表

23 9 报文样例.24

10 SCHEMA 校验文件

24 国际收支网上申报系统 企业联机接口报文规范 第2页1范围 《国际收支网上申报系统企业联机接口报文规范》 , 规定了国家外汇管理局 (以下简称 "外汇局" ) 国际收支网上申报系统与企业自身业务系统进行联机实时业务交互时,应采用的报文格式和规范.

2 术语和接口说明 l 标识符:唯一标识报文中一个数据项或者节点项的代码. l 报文:用于外汇局与联网机构间交换信息的载体. l 报文头:报文通讯使用的基本信息. l XML节点TAG:某一段数据域的标识,比如报文头、用户信息等,用于组织报文中节点项的代 码. l 节点代码:为了方便管理,对于接入的机构,由外汇局进行编码并分配给接入单位使用.对 于企业,节点代码采用"组织机构代码证"的代码,共9位.

3 要求 3.1 数据类型定义 3.1.1 字符集 X-字符集由以下87个字符组成: A B C D E F G H I J K L M N O P Q R S T U V W X Y Z A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

0 1

2 3

4 5

6 7

8 9 (CR)(LF)(SPACE) 对于使用TCP/IP协议的系统,X-字符集的编码(字符的二进制编码)适用于ISO-2022(ASCII) 3.1.2 符号约定 符号 说明 STRING 表示由 X-字符集组成的字符串,如:PBCGKJCFCC 国际收支网上申报系统 企业联机接口报文规范 第3页NSTRING 表示由数字[0-9]组成的字符串,如:000045 GBSTRING 表示由 GBK 字符集组成的字符串,报文规范中的长度定义以字节为单位,如:商业 CURRENCY 表示金额,符号位可选,整数部分最长

15 位,小数部分固定两位,不能包含逗号等分 隔符,如:8979.05 INTEGER 表示整数,符号位可选,数值部分最长

8 位,如:88888 DECIMAL 表示实数,如:655785.5676 LONG 表示日期.日期是毫秒数,毫秒数是根据 1970-1-1 为参照值,由参数日期减去参照值将 结果转换为毫秒数得来的如:1333248494648 DATE 表示日期,格式为 YYYYMMDD(年月日) .如:2005-06-11 TIME 表示时间,格式为 HH:MM:SS(时分秒) .如:11:28:21 DATETIME 表示日期时间,格式为 YYYY-MM-DD HH:MM:SS(年月日时分秒) . 如:2005-06-11 11:27:39 HEXBINARY 表示按十六进制编码,的二进制数据,如:4F59B25A BOOLEAN 表示布尔值(TRUE 或FALSE),如:TRUE 3.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 结构说明 报文结构如下图所示: 说明:总体上,报文全部内容封装在一个 XML 报文中,报文分为三大部分:报文头、报文体及报 文尾. n 报文头部分 报文头部分用于标识 XML 报文的基本属性,包括报文版本号、机构类型、发起节点代码、接收节 点代码、发送方系统标识、接收方系统标识、用户信息、发送时间等等信息. 国际收支网上申报系统 企业联机接口报文规范 第5页n报文体部分 报文体部分是业务信息,包括业务参数、数据集合两部分. n 报文尾部分 数字签名部分用于存放报文的数字签名信息,用于交易参与方的身份认证.算法对报文开始(即从行开始)至之间的全部内容(不包括报文尾信息) 进行签名,并以 XML 注释的形式存储于原 XML 报文的尾部.校验和通常在通信过程中保证内容的完整 性和准确性.发送端通过对报文内容运用特定算法计算得出校验和,接收端接收到报文后也对报文进 行同样的计算,如果结果一致则代表内容没被改变. 注:标准 XML 报文首位字符不允许出现空格等字符,应以