-
国
际
p>
收
支
网
上
申
报
系
统
企
业
联
< br>机
接
口
报
文
规
范
p>
版
本
号
:
V
1
.
0
国
家
外
< br>汇
管
理
局
2015
年
2
月
国际收支网上申报系统
企业联机接口报文规范
变更履历
修改编号
版本
修改内容
修改人
修改日期
国际收支网上申报系统
企业联机接口报文规范
目
录
1
范围
.
..
..................................................
..................................................
..................................................
.............. 2
2
术语和接口说明
.
< br>............................................... .................................................. ................................................. 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
S
CHEMA
校验文件
..................................................
..................................................
.........................................
24
第
1
页
国际收支网上申报系统
企业联机接口报文规范
1
范围
《国际收支网上申报系统企业联
机接口报文规范》
,
规定了国家外汇管理局
(以下简称
“外汇局”
)
国际收支
网上申报系统与企业自身业务系统进行联机实时业务交互时,应采用的报文格式和规范。
2
术语和接口说明
?
标识符
:
唯一标识报文中一个数据项或者节点项的代码。
?
报文:
用
于外汇局与联网机构间交换信息的载体。
?
报文头
:报文通讯使用的基本信息。
?
XML
节
点
TAG
:某一段数据域的标识,比如报文头、用户信息等,用
于组织报文中节点项的代
码。
?
节点代码
:为了方便管理,对于接入的机构,由外汇局进行编码并分配给接入单位使用。对
于企业
,节点代码采用“组织机构代码证”的代码,共
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) (SP
ACE)
对于使用
TCP/IP
协议的系统,
X-
字符集的编码(字符的二进制编码)适用于
ISO-202
2
(
ASCII
)
3.1.2
符号约定
符号
STRING
说明
表示由
X-
字符集组成的字符串,如:
PBCGKJCFCC
第
2
页
国际收支网上申报系统
企业联机接口报文规范
NSTRING
GBSTRING
CURRENCY
表示由数字
[0-
9]
组成的字符串,如:
000045
表示由
GBK
字符集组成的字符串,报文规范中的长度定义以
字节为单位,如:商业
表示金额,符号位可选,整数部分最长
15
位,小数部分固定两位,不能包含逗号等分
隔符,如:
8979.05
INTEGER
DECIMAL
LONG
表示整数
,符号位可选,数值部分最长
8
位,如:
88888
表示实数,如:
655785.5676
p>
表示日期。
日期是毫秒数,
毫秒数是根据<
/p>
1970-1-1
为参照值,
由参数日期
减去参照值将
结果转换为毫秒数得来的如:
48
DA
TE
TIME
DA
TETIME
表示日期,格式为
YYYYMMDD
(年月日)
。如:
2005-06-1
1
表示时间,格式为
HH:MM:
SS
(时分秒)
。如:
11:28:2
1
表示日期时间,格式为
YYYY-MM-DD
HH:MM:SS
(年月日时分秒)
。
如:
2005-06-11 11:27:39
HEXBINARY
表示按十六进
制编码
,
的二进制数据,如:
4F59
B25A
BOOLEAN
表示布
尔值
(TRUE
或
FALSE)
,如:
TRUE
3.2
数据处理规则
(1)
对于每个字段所填内容,在后
面的章节中针对不同报文将具体说明。
(2)
当“长度”是
N
时表示此域出现时,长度固定为
N
< br>个字符;当“长度”是
[1,N]
时表示此域出现
时,其最小长度为
1
个字符,其最大长度为<
/p>
N
个字符。
(3)
当“强制
/
可选”是
M
时,表示此要素为强
制项,必须出现;当“强制
/
可选”是
O
时,表示此
要素为可选项,根据业务要求填制,不必须出现,
但一旦出现,则其中内容必须出现,不可
为空。
3.3
报文格式校验
本规范对
XML
格式的请求报文提供了
Schema
校验文件,请求方系统在发起请求前需要根据
< br>Schema
文件对请求报文进行格式校验。
第
3
页
国际收支网上申报系统
企业联机接口报文规范
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
易读性原则
<
/p>
在保证报文交换和处理高效的前提下,尽可能提高报文的易读性,以利于系统测试和联调。
4.1.1.2
结构说明
报文结构如下图所示:
域
1
Header
报文头
域
2
域
3
域块
域块
Message
报文
Body
报文体
Compoent
< br>组件
域块
域
域
< br>:表示某个域
Repeating
Group
重复组
Group Block
1
组块
1
域块
域
域块
重复组
组块
< br>:表示多个域集合
:表示重复组,可由
多个重复组块组成
:表示重复组中每块
重复部分,也是由域
块组成
:表示多个域的集
合,这些域所代表
< br>的含义之间具有关
联性
域块
Ta
il
报文尾
域
10
Group Block 2
组块
2
域块
域
组件
Group
Block n
组块
n
域块
说明
:总体上,报文全部内容封装在一个
XML
报文中,报文分为三
大部分:报文头、报文体及报
文尾。
?
报文头部分
报文头部分用于标识
p>
XML
报文的基本属性,包括报文版本号、机构类型、发起节点代码
、接收节
点代码、发送方系统标识、接收方系统标识、用户信息、发送时间等等信息。<
/p>
第
4
页
国际收支网上申报系统
企业联机接口报文规范
?
报文体部分
报文体部分是业务信息,包括业务参数、数据集合两部分。
?
报文尾部分
数字签名部分用于存放报
文的数字签名信息,用于交易参与方的身份认证。算法对报文开始(即
从
行开始)至
之间的全部内容(不包括报文尾信息)
进行签名,并以
p>
XML
注释的形式存储于原
XML
报文的尾部。校验和通常在通信过程中保证内容的完整
性和准确性。发送
端通过对报文内容运用特定算法计算得出校验和,接收端接收到报文后也对报文进
行同样
的计算,如果结果一致则代表内容没被改变。
注:标准
XML
报文首位字符不允许出现空格等字符,应以
开始。
具体格式示例如下:
报文头内容
报文体内容
报文尾
?
组件
组件是一个逻辑概念,
它用来表示一组彼此之间有一定关系的消息域的组合。
这些组件在协议中
都赋以相应的名称,用来更好的理解消息结构以及所应用的场景。在实际消息传送过程中
,这些组件
名称并不会作为信息消息中出现,
可以这么说,
p>
组件的出现是起到更好让人能够理解消息结构的作用。
?
重复组
域可以在重复组里多次重复,用以传输数组同类的数据。在协议中,重复组也同样是一个
逻辑概
念,它用来表示一组彼此之间有一定关系的消息域的组合能够连续反复地在消息中
出现。
5
报文格式具体说明
5.1
实时业务类
此类报文主要包含请求报文和回执报文。
第
5
页
国际收支网上申报系统
企业联机接口报文规范
5.1.1
请求报文格式
5.1.1.1
报文格式
报文头
通讯基本信息
控制信息
报文体
公共
参数信息
业务数据集合
报文尾
分页信息
业务参数信息
业务数据信息(
0,N<
/p>
)
说明
:请求
报文由报文头、报文体、报文尾组成。报文头包括报文通讯使用的基本信息和控制信
息;
报文体包括公共参数和业务数据集合,而业务数据信息又包括分页信息、业务参数信息和业务数
< br>据信息;报文尾是数字签名和校验和信息。
5.1.1.2
数据项
5.1.1.2.1
报文头
XML
节点
TAG
:
MSG->HEAD
标识符
VER
ORGTYPE
字段名称
报文版本号
机构类型
类型
NSTRING
NSTRING
长度
[1,4]
[1,4]
备注
当前为
2014
1
< br>:
外汇局、
2
:
银行、
3
:
企业。
SRC
发
起
节
点
代
码
DES
接
收
节
点
代
码
SRCAPP
发
送
p>
端
应
用
代码
DESAPP
接
收
端
应
用
代码
STRING
[1
,
100]
STRING
[1
,
100]
发送端应用名称,由报
文的发起方自行控制
接收端应用名称,例如
国际收支网上申报系统
为
p>
BZCN
SENDTIME
发送时间
DATETIM
E
报文发送时间
M
M
O
NSTRING
6
外汇局:默认
100000
M
NSTRING
4
或
9
企业:组织机构代码
M
强制
/
可选
M
M
第
6
页
国际收支网上申报系统
企业联机接口报文规范
COMMON_ORG_C
ODE
COMMON_USER_
CODE
PASSWORD
SERVICEPATH
机构代码
STRING
[1,40]
企业:组织机构代码
M
用户代码
STRING
[1,40]
用户代码
M
密码
访
问
服
务
信
p>
息
STRING
STRING
[1,50]
[5,100]
密码(
MD5
加密后的)
服务名称
+
“
.
”
+
方法名
称
M
M
MSGNO
报文参考号
STRING
[1,33]
企业:
组织机构代码<
/p>
+
年
月日
+8<
/p>
位唯一代码
M
5.1.1.2.2
报文体
公共参数信息
XML
节点
TAG
:
MSG->BO
DY->PARAMETERS
说明:
此节点是业务公共参数位置
,
主要用于非分页查询和写操作
时传参,参数的详细定义见本文
档报文的定义部分。
数据集信息
XML
节点
TAG
:
MSG->BODY->DATASTORES->DS
强制
/
标识符
PAGESIZE
PAGENUMBER
数据项名称
每页条数
页码
类型
NSTRING
NSTRING
长度
[1,10]
[1,10]
数据项描述
可选
最大不能超过
< br>1000
条
当前是多少页
M
M
说明:
对于分页查询,以上内容是
必输,如果不输入
PAGESIZE
值默认是
< br>1000
;对于非分页查询
和写操作,以上内容无需存在
。
XML
节点
TAG
< br>:
MSG->BODY->DATASTORES->DS->PARAMETE
RS
说明:
PARAMETERS
下是业务参数,此节点下的参数为非必输参数,此节点下的参数为非必输
参数,此节点为分页查询和写操作入参位置。
XML
节点
TAG
< br>:
MSG->BODY->DATASTORES->DS->ROWSET
第
7
页
国际收支网上申报系统
企业联机接口报文规范
强制
/
标识符
ROW
数据项名称
数据集
类型
GBSTRING
长度
数据项描述
可选
数据集,可循环出现
O
说明:
ROW
可以重复出现,详细定义见本文档对
报文的定义部分。
5.1.1.2.3
报文尾
XML
节点
TAG
:
MSG-> TAIL
强制
/
标识符
SIGNATURE
CHECKSUM
数据项名称
数字签名
预留字段
类型
STRING
STRING
长度
[0,300]
[0,300]
数据项描述
可选
暂不使用
暂不使用
O
O
5.1.2
回执报文格式
5.1.2.1
报文格式
报文头
通讯基本信息
请求状态信息
报文体
公共参数信息
业务数据集合
< br>报文尾
分页信息
业务参数信息
业
务数据信息(
0,N
)
说明
:由一个报文头、一个回执信息、报文尾构成。
5.1.2.2
数据项
5.1.2.2.1
报文头
XML
节点
TAG
:
MSG->HEAD
标识符
VER
SRC
字段名称
报文版本号
发
起
节
点
代
码
类型
NSTRING
NSTRING
长度
[1,4]
6
备注
当前为
2014
外汇局:默认
100000
强制
/
可选
M
M
第
8
页
国际收支网上申报系统
企业联机接口报文规范
DES
接
收
节
点
代
码
p>
NSTRING
4
或
9
银行:总行代码【金融
机构代码】
企业:组织机构代码
M
SRCAPP
发
送
端
应
用
代码
STRING
[1
,
100]
外汇局端应用名称,例
如国际收支网上申报系
统为
BZCN
M
DESAPP
接
收
端
应
用
代码
STRING
[1
,
100]
接收端应用名称,对应
请求报文中的发送端应
用代码
O
SENDTIME
发送时间
DATETIM
E
报文发送时间
M
MSGNO
报文参考号
STRING
[1,32]
对应请求报文中的报文
参考号
M
CODE
状态码
NSTRING
[1,6]
处理成功是
00000<
/p>
,
如果
错误返回错误码
< br>
M
DETAIL
错
误
详
细
信
息
GBSTRIN
G
[1,200]
错误详细信息
O
5.1.2.2.2
报文体
XML
节点
TAG
< br>:
MSG->BODY->DA
TASTORES->D
S
强制
/
标识符
PAGESIZE
PAGENUMBER
RECORDCOUNT
数据项名称
每页条数
页码
记录总条数
类型
NSTRING
NSTRING
NSTRING
长度
[1,10]
[1,10]
[1,10]
数据项描述
可选
最大值为
1000
当前是多少页
记录总条数
M
M
M
说
明:
DS
为重复组,可以重复出现,但有多个时要有编号,
p>
即
DS+I,I
从
1
开
始,
如
<
DS1>,
。对于分页查询以上三项为必输项,对
于非分页查询以上三项无需存在。
XML
节点
TAG
< br>:
MSG->BODY->DATASTORES->DS->PARAMETE
RS
第
9
页
国际收支网上申报系统
企业联机接口报文规范
说明:
PARAMETERS
下是业务参数,此节点下的参数为非必输参数,
用于分页查询和写操作时
存放入参,详细定义见本文档对报文的定义部分。
XML
节点
TAG
p>
:
MSG->BODY->DATASTORES->DS->RO
WSET
强制
/
标识符
ROW
数据项名称
数据集
类型
STRING
长度
数据项描述
可选
数据集,可循环出现
O
说明:
ROW
可以重复出现,详细定义见本文档对
报文的定义部分。
5.1.2.2.3
报文尾
XML
节点
TAG
:
MSG-> TAIL
强制
/
标识符
SIGNATURE
CHECKSUM
公共参数信息
XML
节点
TAG
:
MSG->BO
DY->PARAMETERS
标识符
ORGTYPE
字段名称
机构类型
类型
NSTRING
长度
[1,4]
备注
1
:<
/p>
外汇局、
2
:
银
行、
3
:
企业。
COMMON_ORG_C
ODE
COMMON_USER_
CODE
COMMON_USER_
NAME
SERVICEPATH
访
问
服
务
信
息
MSGNO
报文参考号
STRING
[1,32]
用户名称
GBSTRIN
G
STRING
[5,100]
服务名称
+
“
.
”
+
方法名
称
企业:
组织机构代码
+
年
月日
+8
位唯一代码
M
M
[1,128]
M
用户代码
STRING
[1,40]
M
机构代码
STRING
[1,40]
企业:组织机构代码
M
强制
/
可选
M
数据项名称
数字签名
预留字段
类型
STRING
STRING
长度
[0,300]
[0,300]
数据项描述
可选
暂不使用
暂不使用
O
O
第
10
页
国际收支网上申报系统
企业联机接口报文规范
6
集团型企业业务规则
对于集团型企业
,
主办企业可以查询成员企业的业务数据,
但是收入申报等交易
业务仍需要以成
员企业的身份进行报告。当主办企业调用查询类服务查询成员企业的业务
数据时,需要在报文体中填
写对应企业的企业代码。
集团企业的关联关系需要由主办企业所在外汇局报总局通过“集团企业管理”模块进行登记。
p>
7
国际收支网上申报系统报文定义
业务领域
涉外收入申报单服务
SafeRCVBOPGService
服务
服务名称
涉外申报信息更新
涉外申报单信息反馈
涉外申报单查询
境内申报信息录入及修改
境内申报单信息反馈
境内申报单查询
doUpdateRCVBOPGInfo
do
Response
RCVBOPGInfo
doQueryRCVBOPGInfo
doUpdateRCVBOPGInfo
境内收入申报单服务
do
Response
RCVBOPRInfo
SafeRCVBOPRService
doQueryRCVBOPRInfo
7.1
涉外收入申报单服务
7.1.1
涉外申报单查询
名称
描述
申报单查询
按照企业申报的业务办理
情况分为待申报信息查询、已申报(待审核)信息
查询和已申报(已审核)信息查询相应
申报单信息
7.1.1.1
请求报文
XML
节点
TAG
< br>:
MSG->BODY->DATASTORES->DS1->PARAMET
ERS
标识符
CORPID
RPTNO
字段名称
组织机构代码
申报号码
类型
STRING
STRING
长度
强制
/
可选
9
22
M
O
申报单号作为查询条件,
并
且在不为空时,
忽略掉其他
查询条件
STARTDA
收汇起始日期
DA
TE
O
备注
第
11
页
-
-
-
-
-
-
-
-
-
上一篇:商务电话英语常用口语
下一篇:中国音乐学院乐理考级大纲(三级)