企业联机接口报文规范.doc

国际收支网上申报系统 企业联机接口报文规范 版本号：V1.0 国家外汇管理局 2015年2月 变更履历 修改编号 版本 修改内容 修改人 修改日期 目 录 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 范围 《国际收支网上申报系统企业联机接口报文规范》，规定了国家外汇管理局（以下简称“外汇局”）国际收支网上申报系统与企业自身业务系统进行联机实时业务交互时，应采用的报文格式和规范。 术语和接口说明 标识符：唯一标识报文中一个数据项或者节点项的代码。 报文：用于外汇局与联网机构间交换信息的载体。 报文头：报文通讯使用的基本信息。 XML节点TAG：某一段数据域的标识，比如报文头、用户信息等，用于组织报文中节点项的代码。 节点代码：为了方便管理，对于接入的机构，由外汇局进行编码并分配给接入单位使用。对于企业，节点代码采用“组织机构代码证”的代码，共9位。 要求 数据类型定义 字符集 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） 符号约定 符号 说明 STRING 表示由X-字符集组成的字符串，如：PBCGKJCFCC 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 数据处理规则 对于每个字段所填内容，在后面的章节中针对不同报文将具体说明。 当“长度”是N时表示此域出现时，长度固定为N个字符；当“长度”是[1,N]时表示此域出现时，其最小长度为1个字符，其最大长度为N个字符。 当“强制/可选”是M时，表示此要素为强制项，必须出现；当“强制/可选”是O时，表示此要素为可选项，根据业务要求填制，不必须出现，但一旦出现，则其中内容必须出现，不可为空。 报文格式校验 本规范对XML格式的请求报文提供了Schema校验文件，请求方系统在发起请求前需要根据Schema文件对请求报文进行格式校验。 接口格式概述 国家外汇管理局业务信息系统与商业银行接入机构通过报文进行联机交互。 报文接口格式结构 报文结构 参考原则 规范原则 所有数据报文使用X