国际收支网上申报系统.docx
《国际收支网上申报系统.docx》由会员分享，可在线阅读，更多相关《国际收支网上申报系统.docx（35页珍藏版）》请在冰点文库上搜索。
国际收支网上申报系统
国际收支网上申报系统
国际收支网上申报系统
企业联机接口报文规范
版本号：
V1.0
国家外汇治理局
2018年2月
变更履历
修改编号
版本
修改内容
修改人
修改日期
11 范围
《国际收支网上申报系统企业联机接口报文规范》，规定了国家外汇治理局〔以下简称“外汇局”〕国际收支网上申报系统与企业自身业务系统进行联机实时业务交互时，应采纳的报文格式和规范。
12 术语和接口说明
●标识符：
唯一标识报文中一个数据项或者节点项的代码。
●报文：
用于外汇局与联网机构间交换信息的载体。
●报文头：
报文通讯使用的差不多信息。
●XML节点TAG：
某一段数据域的标识，比如报文头、用户信息等，用于组织报文中节点项的代码。
●节点代码：
为了方便治理，关于接入的机构，由外汇局进行编码并分配给接入单位使用。
关于企业，节点代码采纳“组织机构代码证”的代码，共9位。
13 要求
13.1 数据类型定义
字符集
X-字符集由以下87个字符组成：
ABCDEFGHIJKLMNOPQRSTUVWXYZ
ABCDEFGHIJKLMNOPQRSTUVWXYZ
0123456789
.,-（）/=‘’+?
!
“”%&*<>;@#
（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为参照值，由参数日期减去参照值将结果转换为毫秒数得来的如：
133********48
DATE
表示日期，格式为YYYYMMDD〔年月日〕。
如：
2005-06-11
TIME
表示时间，格式为HH:
MM:
SS〔时分秒〕。
如：
11:
28:
21
DATETIME
表示日期时间，格式为YYYY-MM-DDHH:
MM:
SS〔年月日时分秒〕。
如：
2005-06-1111:
27:
39
HEXBINARY
表示按十六进制编码,的二进制数据，如：
4F59B25A
BOOLEAN
表示布尔值（TRUE或FALSE），如：
TRUE
13.2 数据处理规那么
（1）关于每个字段所填内容，在后面的章节中针对不同报文将具体说明。
（2）当“长度”是N时表示此域出现时，长度固定为N个字符；当“长度”是[1,N]时表示此域出现时，其最小长度为1个字符，其最大长度为N个字符。
（3）当“强制/可选”是M时，表示此要素为强制项，必须出现；当“强制/可选”是O时，表示此要素为可选项，依照业务要求填制，不必须出现，但一旦出现，那么其中内容必须出现，不可为空。
13.3 报文格式校验
本规范对XML格式的请求报文提供了Schema校验文件，请求方系统在发起请求前需要依照Schema文件对请求报文进行格式校验。
14 接口格式概述
国家外汇治理局业务信息系统与商业银行接入机构通过报文进行联机交互。
14.1 报文接口格式结构
报文结构
参考原那么
规范原那么
所有数据报文使用XML进行描述〔有特别说明的部分以说明为准〕。
高效性原那么
由于国家外汇治理局业务信息系统对报文进行实时处理，因此将追求效率作为首要目标。
易读性原那么
在保证报文交换和处理高效的前提下，尽可能提高报文的易读性，以利于系统测试和联调。
结构说明
报文结构如下图所示：
说明：
总体上，报文全部内容封装在一个XML报文中，报文分为三大部分：
报文头、报文体及报文尾。
⏹报文头部分
报文头部分用于标识XML报文的差不多属性，包括报文版本号、机构类型、发起节点代码、接收节点代码、发送方系统标识、接收方系统标识、用户信息、发送时间等等信息。
⏹报文体部分
报文体部分是业务信息，包括业务参数、数据集合两部分。
⏹报文尾部分
数字签名部分用于存放报文的数字签名信息，用于交易参与方的身份认证。
算法对报文开始〔即从
XMLVERSION=="1.0"ENCODING="GBK"?
>行开始〕至之间的全部内容〔不包括报文尾信息〕进行签名，并以XML注释的形式存储于原XML报文的尾部。
校验和通常在通信过程中保证内容的完整性和准确性。
发送端通过对报文内容运用特定算法计算得出校验和，接收端接收到报文后也对报文进行同样的计算，假如结果一致那么代表内容没被改变。
注：
标准XML报文首位字符不同意出现空格等字符，应以
XMLVERSION开始。
具体格式例如如下：
XMLVERSION="1.0"ENCODING="GBK"?
>
报文头内容
报文体内容
报文尾
⏹组件
组件是一个逻辑概念，它用来表示一组彼此之间有一定关系的消息域的组合。
这些组件在协议中都赋以相应的名称，用来更好的理解消息结构以及所应用的场景。
在实际消息传送过程中，这些组件名称并可不能作为信息消息中出现，能够这么说，组件的出现是起到更好让人能够理解消息结构的作用。
⏹重复组
域能够在重复组里多次重复，用以传输数组同类的数据。
在协议中，重复组也同样是一个逻辑概念，它用来表示一组彼此之间有一定关系的消息域的组合能够连续反复地在消息中出现。
15 报文格式具体说明
15.1 实时业务类
此类报文要紧包含请求报文和回执报文。
请求报文格式
报文格式
说明：
请求报文由报文头、报文体、报文尾组成。
报文头包括报文通讯使用的差不多信息和操纵信息；报文体包括公共参数和业务数据集合，而业务数据信息又包括分页信息、业务参数信息和业务数据信息；报文尾是数字签名和校验和信息。
数据项
报文头
XML节点TAG：
MSG->HEAD
标识符
字段名称
类型
长度
备注
强制/可选
VER
报文版本号
NSTRING
[1,4]
当前为2018
M
ORGTYPE
机构类型
NSTRING
[1,4]
1：
外汇局、2：
银行、3：
企业。
M
SRC
发起节点代码
NSTRING
4或9
企业：
组织机构代码
M
DES
接收节点代码
NSTRING
6
外汇局：
默认100000
M
SRCAPP
发送端应用代码
STRING
[1,100]
发送端应用名称，由报文的发起方自行操纵
O
DESAPP
接收端应用代码
STRING
[1,100]
接收端应用名称，例如国际收支网上申报系统为BZCN
M
SENDTIME
发送时间
DATETIME
报文发送时间
M
COMMON_ORG_CODE
机构代码
STRING
[1,40]
企业：
组织机构代码
M
COMMON_USER_CODE
用户代码
STRING
[1,40]
用户代码
M
PASSWORD
密码
STRING
[1,50]
密码〔MD5加密后的〕
M
SERVICEPATH
访问服务信息
STRING
[5,100]
服务名称+“.”+方法名称
M
MSGNO
报文参考号
STRING
[1,33]
企业：
组织机构代码+年月日+8位唯一代码
M
报文体
公共参数信息
XML节点TAG：
MSG->BODY->PARAMETERS
说明：
此节点是业务公共参数位置,要紧用于非分页查询和写操作时传参，参数的详细定义见本文档报文的定义部分。
数据集信息
XML节点TAG：
MSG->BODY->DATASTORES->DS
标识符
数据项名称
类型
长度
数据项描述
强制/可选
PAGESIZE
每页条数
NSTRING
[1,10]
最大不能超过1000条
M
PAGENUMBER
页码
NSTRING
[1,10]
当前是多少页
M
说明：
关于分页查询，以上内容是必输，假如不输入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
数字签名
STRING
[0,300]
暂不使用
O
CHECKSUM
预留字段
STRING
[0,300]
暂不使用
O
回执报文格式
报文格式
说明：
由一个报文头、一个回执信息、报文尾构成。
数据项
报文头
XML节点TAG：
MSG->HEAD
标识符
字段名称
类型
长度
备注
强制/可选
VER
报文版本号
NSTRING
[1,4]
当前为2018
M
SRC
发起节点代码
NSTRING
6
外汇局：
默认100000
M
DES
接收节点代码
NSTRING
4或9
银行：
总行代码【金融机构代码】
企业：
组织机构代码
M
SRCAPP
发送端应用代码
STRING
[1,100]
外汇局端应用名称，例如国际收支网上申报系统为BZCN
M
DESAPP
接收端应用代码
STRING
[1,100]
接收端应用名称，对应请求报文中的发送端应用代码
O
SENDTIME
发送时间
DATETIME
报文发送时间
M
MSGNO
报文参考号
STRING
[1,32]
对应请求报文中的报文参考号
M
CODE
状态码
NSTRING
[1,6]
处理成功是00000，假如错误返回错误码
M
DETAIL
错误详细信息
GBSTRING
[1,200]
错误详细信息
O
报文体
XML节点TAG：
MSG->BODY->DATASTORES->DS
标识符
数据项名称
类型
长度
数据项描述
强制/可选
PAGESIZE
每页条数
NSTRING
[1,10]
最大值为1000
M
PAGENUMBER
页码
NSTRING
[1,10]
当前是多少页
M
RECORDCOUNT
记录总条数
NSTRING
[1,10]
记录总条数
M
说明：
DS为重复组，能够重复出现，但有多个时要有编号，即DS+I,I从1开始，如,。
关于分页查询以上三项为必输项，关于非分页查询以上三项无需存在。
XML节点TAG：
MSG->BODY->DATASTORES->DS->PARAMETERS
说明：
PARAMETERS下是业务参数，此节点下的参数为非必输参数，用于分页查询和写操作时存放入参，详细定义见本文档对报文的定义部分。
XML节点TAG：
MSG->BODY->DATASTORES->DS->ROWSET
标识符
数据项名称
类型
长度
数据项描述
强制/可选
ROW
数据集
STRING
数据集，可循环出现
O
说明：
ROW能够重复出现，详细定义见本文档对报文的定义部分。
报文尾
XML节点TAG：
MSG->TAIL
标识符
数据项名称
类型
长度
数据项描述
强制/可选
SIGNATURE
数字签名
STRING
[0,300]
暂不使用
O
CHECKSUM
预留字段
STRING
[0,300]
暂不使用
O
公共参数信息
XML节点TAG：
MSG->BODY->PARAMETERS
标识符
字段名称
类型
长度
备注
强制/可选
ORGTYPE
机构类型
NSTRING
[1,4]
1：
外汇局、2：
银行、3：
企业。
M
COMMON_ORG_CODE
机构代码
STRING
[1,40]
企业：
组织机构代码
M
COMMON_USER_CODE
用户代码
STRING
[1,40]
M
COMMON_USER_NAME
用户名称
GBSTRING
[1,128]
M
SERVICEPATH
访问服务信息
STRING
[5,100]
服务名称+“.”+方法名称
M
MSGNO
报文参考号
STRING
[1,32]
企业：
组织机构代码+年月日+8位唯一代码
M
16 集团型企业业务规那么
关于集团型企业，主办企业能够查询成员企业的业务数据，然而收入申报等交易业务仍需要以成员企业的身份进行报告。
当主办企业调用查询类服务查询成员企业的业务数据时，需要在报文体中填写对应企业的企业代码。
集团企业的关联关系需要由主办企业所在外汇局报总局通过“集团企业治理”模块进行登记。
17 国际收支网上申报系统报文定义
业务领域
服务
服务名称
涉外收入申报单服务
SafeRCVBOPGService
doUpdateRCVBOPGInfo
涉外申报信息更新
doResponseRCVBOPGInfo
涉外申报单信息反馈
doQueryRCVBOPGInfo
涉外申报单查询
境内收入申报单服务
SafeRCVBOPRService
doUpdateRCVBOPGInfo
境内申报信息录入及修改
doResponseRCVBOPRInfo
境内申报单信息反馈
doQueryRCVBOPRInfo
境内申报单查询
17.1 涉外收入申报单服务
涉外申报单查询
名称
申报单查询
描述
按照企业申报的业务办理情况分为待申报信息查询、已申报〔待审核〕信息查询和已申报〔已审核〕信息查询相应申报单信息
请求报文
XML节点TAG：
MSG->BODY->DATASTORES->DS1->PARAMETERS
标识符
字段名称
类型
长度
强制/可选
备注
CORPID
组织机构代码
STRING
9
M
RPTNO
申报号码
STRING
22
O
申报单号作为查询条件，同时在不为空时，忽略掉其他查询条件
STARTDATE
收汇起始日期
DATE
O
ENDDATE
收汇截止日期
DATE
O
QUERYTYPE
查询类型
STRING
1
O
0-全部
1-待申报
2-已申报〔待审核〕
3-已申报〔已审核〕
回执报文
XML节点TAG：
MSG->BODY->DATASTORES->DS1->ROWSET->ROW
标识符
字段名称
类型
长度
强制/可选
备注
RPTNO
申报号码
STRING
22
M
应与基础数据一致
BUSICODE
银行业务编号
STRING
22
M
RPTDATE
申报日期
STRING
20
M
按申报主体真实申报日期填写
CUSTNAME
收款人名称
STRING
128
M
UNITCODE
收款人代码
STRING
20
M
COUNTRY
付款人常驻国家/地区代码
STRING
3
M
使用国家/地区代码表中的3位字母代码
PAYMETHOD
结算方式
STRING
1
M
L-信用证
G-保函
C-托收
T-电汇
D-票汇
M-信汇
O-其他
TXCCY
收入款币种代码
STRING
3
M
TXAMT
收入款金额
DECIMAL
M
USDAMT
收入款金额〔折美金额〕
DECIMAL
M
ISREF
是否保税货物项下收汇
STRING
1
M
Y－是
N－否
TXCODE
交易编码1
STRING
6
O
必须在国际收支交易编码表中存在
TC1AMT
交易金额1
DECIMAL
M
TXREM
交易附言1
STRING
50
M
TXCODE2
交易编码2
STRING
6
O
必须在涉外收支交易代码表中存在
不能与交易编码1相同，
没有输入交易编码时，相应金额及交易附言不应该填写。
有交易金额2或交易附言2时必填。
TC2AMT
交易金额2
DECIMAL
O
有交易编码2时必填。
两个交易编码对应的金额之和必须等于收入款金额。
TX2REM
交易附言2
STRING
50
O
有交易编码2时必填。
RPTSOURCE
申报来源
STRING
1
M
1-纸质申报〔银行版录入〕
2-网上申报
3-接口导入〔银行业务系统接口文件导入〕
SAFERMKS
外汇局留言
STRING
256
O
BANKRMKS
银行留言
STRING
256
O
ENTRMKS
企业意见
STRING
256
O
RPTSTS
申报单状态
STRING
2
M
申报单状态：
00-待申报
01-待审核〔已申报〕
02-审核未通过
03-待重新申报
04-待审核〔已修改/确认〕
05-待审核〔拒绝〕
06-已审核
申报单状态说明：
00-待申报：
银行端录入基础信息后为此状态。
待企业端申报，如今企业端可进行查询和申报录入
01-待审核〔已申报〕：
企业端做过申报录入后的状态，待银行端审核；如今企业端也能够主动修改
02-审核未通过：
银行端对企业端的申报信息审核未通过，置为此状态。
如今，企业端能够修改申报信息，也能够拒绝，并进行反馈
03-待重新申报：
企业录入申报信息后，银行端对基础信息进行了修改后的状态。
如今企业端之前的申报信息作废，需要重新申报
04-待审核〔已修改/确认〕：
企业端修改审核信息后的状态，待银行端审核
05-待审核〔拒绝〕：
银行端审核未通过的情况下，企业进行审核疑问反馈后的状态。
如今企业端不能再修改申报信息，只能查询
06-已审核：
银行端对企业的申报信息审核通过的状态，如今企业端不能再修改申报信息，只能查询
涉外申报信息录入及修改
名称
涉外申报信息更新
描述
企业用户通过申报信息更新来填写本企业的申报信息。
申报信息更新后申报单状态为待审核状态
请求报文
XML节点TAG：
MSG->BODY->DATASTORES->DS1->PARAMETERS
标识符
字段名称
类型
长度
强制/可选
备注
CORPID
组织机构代码
STRING
9
M
RPTNO
申报单号
STRING
22
M
应与基础数据一致
COUNTRY
付款人常驻国家/地区代码
STRING
3
M
指付款人所在国家〔地区〕对应的代码。
RPTDATE
申报日期
DATE
M
按申报主体真实申报日期填写。
PAYTYPE
收款性质
STRING
1
M
A－预收货款
R－退款
O－其它
ISREF
是否保税货物项下收汇
STRING
1
M
Y－是
N－否
BILLNO
外汇局批件号/备案表号/业务编号
STRING
50
O
TXCODE
交易编码1
STRING
6
M
必须在国际收支交易编码表中存在
TC1AMT
相应金额1
DECIMAL
M
TXREM
交易附言1
STRING
50
M
申报主体对交易编码1所对应的交易性质进行的详细描述。
TXCODE2
交易编码2
STRING
6
O
必须在国际收支交易编码表中存在；
不能与交易编码1相同，
没有输入交易编码时，相应金额及交易附言不应该填写；
有交易金额2或交易附言2时必填。
TC2AMT
相应金额2
DECIMAL
O
有交易编码2时必填。
两个交易编码对应的金额之和必须等于收入款金额。
TX2REM
交易附言2
STRING
50
O
有交易编码2时必填。
PAYATTR
收入类型
STRING
1
O
F-福费廷
T-出口保理
N-出口押汇
D-出口贴现
O-其它
INPTELC
STRING
20
M
CRTUSER
填报人
STRING
20
M
业务规那么：
1）申报日期要求大于等于收付汇日期，小于等于当前系统日期。
2）交易编码1必输，交易编码2选输。
其中交易编码1代表最大金额的交易对应的国际收支交易性质。
另外，两个交易编码对应金额之和必须等于收入款金额。
3）修改时，假如申报来源不是网上申报，就不同意做申报修改
4）假如申报单差不多请示删除或者已逻辑删除，不同意做录入和修改
回执报文
XML节点TAG：
MSG->HEAD
code等于00000表示操作成功，否那么参见返回码与提示信息
涉外申报信息反馈
名称
申报信息反馈
描述
企业对银行审核不通过的申报信息进行反馈，假如企业认为银行审核有误，可将拒绝修改的缘故列明返回给银行。
请求报文
XML节点TAG：
MSG->BODY->DATASTORES->DS1->PARAMETERS
标识符
字段名称
类型
长度
强制/可选
备注
CORPID
升级会员 