个人外汇业务监测系统外围接口需求说明书

个人外汇业务监测系统
目录
1导言 (6)
1.1文档目的 (6)
1.2文档范围 (6)
1.3读者对象 (6)
1.4参考资料 (6)
2术语解释 (6)
3要求 (7)
3.1数据类型定义 (7)
3.1.1字符集 (7)
3.1.2 3.1.2. 符号约定 (7)
3.2数据处理规则 (8)
4需求模块概述 (8)
4.1功能描述 (8)
4.2主要外围系统 (9)
4.3外围系统接口列表(SERVICEPA TH) (9)
5报文格式说明 (10)
5.1请求报文 (10)
5.1.1根节点 (10)
5.1.2报文头 (10)
5.1.3报文体 (12)
5.2回执报文 (12)
5.2.1根节点 (12)
5.2.2报文头 (13)
5.2.3报文体 (14)
6报文定义 (14)
6.1个人结汇信息和分类查询 (15)
6.1.1请求报文： (15)
6.1.2回执报文 (15)
6.1.3业务规则： (16)
6.2占用额度的个人结汇信息录入 (17)
6.2.1请求报文 (17)
6.2.2回执报文 (18)
6.2.3业务规则 (19)
6.3不占额度的个人结汇信息录入 (21)
6.3.1请求报文 (21)
6.3.2回执报文 (23)
6.3.3业务规则 (23)
6.4个人结汇信息查询 (26)
6.4.1请求报文 (26)
6.4.2回执报文 (27)
6.4.3业务规则 (29)
6.5个人结汇信息修改 (30)
6.5.1请求报文 (30)
6.5.2回执报文 (32)
6.5.3业务规则 (32)
6.6个人结汇信息撤销 (33)
6.6.1请求报文 (33)
6.6.2回执报文 (33)
6.6.3业务规则 (33)
6.7占用额度的个人结汇信息补录 (33)
6.7.1请求报文 (33)
6.7.2回执报文 (35)
6.7.3业务规则 (35)
6.8不占额度的结汇信息补录 (36)
6.8.2回执报文 (38)
6.8.3业务规则 (38)
6.9个人购汇信息分类和查询 (39)
6.9.1请求报文 (39)
6.9.2回执报文 (39)
6.9.3业务规则 (40)
6.10占用额度的个人购汇信息录入 (41)
6.10.1请求报文 (41)
6.10.2回执报文 (43)
6.10.3业务规则 (43)
6.11不占额度的购汇信息录入 (45)
6.11.1请求报文 (45)
6.11.2回执报文 (47)
6.11.3业务规则 (48)
6.12个人购汇信息查询 (51)
6.12.1请求报文 (51)
6.12.2回执报文 (52)
6.12.3业务规则 (54)
6.13个人购汇数据修改 (55)
6.13.1请求报文 (55)
6.13.2回执报文 (56)
6.13.3业务规则 (57)
6.14个人购汇信息撤销 (57)
6.14.1请求报文 (57)
6.14.2回执报文 (58)
6.14.3业务规则 (58)
6.15占用额度的个人购汇信息补录 (58)
6.15.1请求报文 (58)
6.15.3业务规则 (60)
6.16不占额度的购汇信息补录 (60)
6.16.1请求报文 (60)
6.16.2回执报文 (63)
6.16.3业务规则 (63)
6.17重点关注对象客户确认书签署 (63)
6.17.1请求报文 (63)
6.17.2回执报文 (64)
6.17.3业务规则 (64)
6.18美元折算率查询 (64)
6.18.1请求报文 (64)
6.18.2回执报文 (65)
6.18.3业务规则 (65)
6.19FEMS报送状态查询 (65)
6.19.1请求报文 (65)
6.19.2回执报文 (66)
6.19.3业务规则 (66)
7其他不开放接口功能 (67)
7.1个人结汇信息修改 (67)
7.2个人结汇信息撤销 (68)
7.3占用额度个人结汇信息补录 (69)
7.4不占额度个人结汇信息补录 (70)
7.5个人购汇信息修改 (71)
7.6个人购汇信息撤销 (71)
7.7占用额度个人购汇信息补录 (71)
7.8不占额度个人购汇信息补录 (71)
8数据字典 (72)
8.2业务类型代码表 (72)
8.3操作类型代码表 (72)
8.4币种 (72)
8.5国家/地区 (73)
8.6结汇资金属性 (73)
8.7结汇资金属性限定参数表 (73)
8.8结汇资金形态代码表 (75)
8.9购汇资金属性 (75)
8.10购汇资金属性限定参数表 (76)
8.11个人主体分类状态代码表 (78)
8.12业务办理渠道代码表 (78)
8.13购汇数据修改原因 (79)
8.14结汇数据修改原因 (79)
8.15结售汇数据撤销原因 (79)
8.16结售汇数据补录原因 (79)
8.17证件类型 (80)
8.18发布原因代码表 (80)
9异常处理机制 (80)
1导言
1.1文档目的
本需求规格说明书包含了友田公司个人外汇业务监测系统相关的业务需求规格说明，是产品开发、测试案例编写的重要依据。

1.2文档范围
本文档是公司产品需求设计、需求确定的总结文档，同时作为代码开发、测试的依据，以及产品操作使用的界定。

1.3读者对象
用户、需求人员、开发人员、测试人员及验收人员。

1.4参考资料
2术语解释
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.23.1.2. 符号约定
3.2数据处理规则
(1) 对于每个字段所填内容，在后面的章节中针对不同报文将具体说明。

(2) 当“长度”是n时表示此域出现时，长度固定为n个字符；当“长度”是[1,n]时表示此域出现时，其最小长度为1个字符，其最大长度为n个字符。

(3) 当“强制/可选”是M时，表示此要素为强制项，必须出现，内容不可为空；当“强制/可选”是O时，表示此要素为可选项，根据业务要求填制，必须出现，内容可以为空。

4需求模块概述
4.1功能描述
1、外围系统向个人外汇业务监测系统提交客户基本信息，发起客户结汇/购汇信息和分类查询。

2、个人外汇业务系统内根据查询结果录入占用额度的个人结汇/购汇，并反馈至对应的外围系统。

3、外围业务系统通过输入业务代码向个人外汇业务监测系统提交不占额度的个人结汇/购汇的录入信息。

4、在个人外汇业务监测系统扣减额度完成外管局报送后，如规定时间内未收到反馈，则个人外汇业务监测系统会向外管局发起个人结汇/购汇信息查询交易，并将查询结果直接推送至外围业务系统。

5、外管局每月更新一次美元折算率，个人外汇业务监测系统查询完成后会在系统内保存，并支持外围系统查询该信息。

6、外围系统需查询个人重点客户，如需签署重点关注对象客户确认书，则需调用接口在系统内打印并签署。

4.2主要外围系统
国际结算系统
柜面系统
网上银行系统
手机银行系统
其他电子渠道
4.3外围系统接口列表(SERVICEPATH)
下表为全部18个接口列表，且在采用SOCKET通信方式时候，作为必填项SERVICEPATH 数据字典。

SERVICEPATH列表
5报文格式说明
5.1请求报文
5.1.1根节点
如果采用WEBSERVICE通信方式：根节点为INPUT 如果采用SOCKET通信方式：根节点为MSG
5.1.2报文头
XML节点TAG：根节点->HEAD
5.1.3报文体
5.1.3.1PARAMETERS节点
XML节点TAG ：根节点->BODY->DA TASTORES->DS->PARAMETERS 说明：业务参数，详细定义见各报文定义
5.1.3.2ROWSET节点
用于发送数据集
XML节点TAG ：根节点->BODY->DA TASTORES->DS->ROWSET
其子节点：
说明：ROW可以重复出现，详细定义见本文档对报文的定义部分。

5.2回执报文
5.2.1根节点
如果采用WEBSERVICE通信方式：根节点为RET
如果采用SOCKET通信方式：根节点为MSG
5.2.2报文头根节点->HEAD
5.2.3报文体
5.2.3.1ROWSET节点
返回数据集
XML节点TAG ：根节点->BODY->DA TASTORES->DS->ROWSET
其子节点：
说明：ROW可以重复出现，详细定义见本文档对报文的定义部分。

6报文定义
说明：
以下包含18个接口所有报文，在编写各银行需求书时候，根据各银行不同进行删减，且根
据通信方式，将根节点进行变更。

6.1个人结汇信息和分类查询
6.1.1请求报文：
XML节点TAG ：根节点->BODY->DA TASTORES->DS->PARAMETERS
6.1.2回执报文
XML节点TAG ：根节点->BODY->DA TASTORES->DS->ROWSET->ROW
6.1.3业务规则：
证件类型与国家/地区对应关系及相应的证件号码校验规则
6.2占用额度的个人结汇信息录入
6.2.1请求报文
XML节点TAG ：根节点->BODY->DA TASTORES->DS->PARAMETERS
6.2.2回执报文
XML节点TAG ：根节点->BODY->DA TASTORES->DS->ROWSET->ROW
6.2.3业务规则
1）结汇金额折算美元后不能大于本年额度内剩余可结汇金额折美元。

2）当结汇资金形态为“外币现钞”，且当日累计外币现钞结汇金额超过等值5000美元（目前设定值，根据法规调整）时，备注栏不能为空，需要在备注栏注明现钞来源证明材料。

此种情况返回的回执报文中的状态码为“450004”，错误详细信息为“当日累计现钞结汇金额超过等值5000美元，请审核现钞来源证明材料，并在备注栏注明！”。

3）查询个人主体分类状态，如果个人主体分类状态为“重点关注对象”且未签署确认书，需要通过“确认书状态更新”服务实现签署确认书。

此种情况返回的回执报文中的状态码为“450001”，错误详细信息为“确认书未签署，不能提交”。

4）币种列表为银行币种专用代码表。

如果当月外汇局没有折算率，则查找上一个月的折算率（月份递减查询），如果外汇局没有该币种折算率，系统提示“外汇局没有该币种的折算率，请按美元录入，并在备注中说明实际币种”。

5）证件类型与国家/地区及交易主体对应关系
姓名格式要求：只允许录入汉字、字母（半角）或符号（仅支持半角格式的点“.”）中间允许有空格
证件类型及相应的校验规则
6) 交易主体对应结汇资金属性限定如下表所示：
6.3不占额度的个人结汇信息录入
6.3.1请求报文
XML节点TAG ：根节点->BODY->DA TASTORES->DS->PARAMETERS
XML节点TAG ：根节点->BODY->DA TASTORES->DS->ROWSET->ROW
6.3.2回执报文
XML节点TAG ：根节点->BODY->DA TASTORES->DS->ROWSET->ROW
6.3.3业务规则
1）结汇资金形态为“账户资金时”或者业务类型为“02个人贸易结汇”时，个人外汇账户账号输入项必填。

2）当结汇资金形态为“外币现钞”，当日累计外币现钞结汇金额超过等值5000美元（目前设定值，根据法规调整）时，备注栏不能为空，需要在备注栏注明现钞来源证明材料。

此种情况返回的回执报文中的状态码为“450004”，错误详细信息为“当日累计现钞结汇金额超过5000美元，请审核现钞来源证明材料，并在备注栏注明！”。

3）证件类型为“外交官证”时，不校验现钞结汇累计金额。

4) 业务类型为通过支付机构的结汇时，结汇资金形态限定为“02-汇入资金（包括
外汇票据）”。

5）系统对支付机构组织机构代码进行校验，支付机构代码必须存在于支付机构准入表中；
通过支付机构的结汇目前仅限于境内个人。

后台参数设置，如以后政策调整，可调整参数。

6）币种列表为银行币种专用代码表。

如果当月外汇局没有折算率，则查找上一个月的折算率（月份递减查询），如果外汇局没有该币种折算率，系统提示“外汇局没有该币种的折算率，请按美元录入，并在备注中说明实际币种”。

7）证件类型与国家/地区及交易主体对应关系
姓名格式要求：只允许录入汉字、字母（半角）或符号（仅支持半角格式的点“.”）中间允许有空格
证件类型及相应的校验规则
8) 结汇资金属性限定
9）业务类型为“通过支付机构的结汇”时，业务办理渠道必须为“32支付机构”。

10）银行应根据支付机构的数据，对于单笔金额等值500美元以上的逐笔录入系统，对于单笔金额等值500美元（含）以下的区分币种和结汇资金属性汇总后以支付机构名义（证件号码输入“000000000”+支付机构组织机构代码，姓名输入支付机构简称）逐笔录入系统。

6.4个人结汇信息查询
6.4.1请求报文
XML节点TAG ：根节点->BODY->DA TASTORES->DS->PARAMETERS
6.4.2回执报文
XML节点TAG ：根节点->BODY->DA TASTORES->DS->ROWSET->ROW
6.4.3业务规则
1）只能查询本银行网点的结汇信息。

2）只能查询本年内的未撤销的交易记录。

3）只传入业务参号，查询特定一笔结汇交易信息。

4）只传入证件类型、证件号码、国家/地区三个数据项，查询某个特定个人的结汇信息。

5）只传入业务办理日期,查询某特定日期的结汇信息。

6) 查询条件可以组合。

组合方式为传入证件类型、证件号码、国家/地区、业务办理日期，查询某个特定个人在某特定日期的结汇信息。

7) 证件类型、证件号码、国家/地区三项中如输入一项，其他两项都不能为空。

8）查询条件不能全部为空。

9）证件类型与国家/地区对应关系及相应的证件号码校验规则
10)业务类型为05的业务信息，只能通过业务参号或者业务办理日期进行查询，不能通过证件号码进行查询。

6.5个人结汇信息修改
6.5.1请求报文
XML节点TAG ：根节点->BODY->DA TASTORES->DS->PARAMETERS
6.5.2回执报文
XML节点TAG ：根节点->BODY->DA TASTORES->DS->ROWSET->ROW
6.5.3业务规则
1）只能修改本银行网点的结汇信息。

2）约束及校验参照不占额度结汇信息录入。

3）撤销后的交易不能再进行修改和撤销。

4）业务类型、证件类型、国别/地区、证件号码、业务办理日期、业务办理渠道不能修改。

5）当结汇资金形态为“外币现钞”，且单笔外币现钞结汇金额超过等值5000美元（目前设定值，根据法规调整）时，备注栏不能为空，需要在备注栏注明现钞来源证明材料。

此种情况返回的回执报文中的状态码为“450020”，错误详细信息为“单笔现钞结汇金额超过等值5000美元，请审核现钞来源证明材料，并在备注栏注明！”。

6.6个人结汇信息撤销
6.6.1请求报文
XML节点TAG ：根节点->BODY->DA TASTORES->DS->PARAMETERS
6.6.2回执报文
XML节点TAG ：MSG->HEAD
code等于00000表示操作成功，否则参见返回码与提示信息
6.6.3业务规则
1）只能撤销本银行网点的结汇信息。

2）撤销后的交易不能再进行修改和撤销。

6.7占用额度的个人结汇信息补录
6.7.1请求报文
XML节点TAG ：根节点->BODY->DA TASTORES->DS->ROWSET->ROW
6.7.2回执报文
XML节点TAG ：根节点->BODY->DA TASTORES->DS->ROWSET->ROW
6.7.3业务规则
1）校验及约束参照占额度个人结汇信息录入。

2）结汇金额折算美元后可以大于剩余可结汇额度。

3）当结汇资金形态为“外币现钞”，且单笔外币现钞结汇金额超过等值5000美元（目前设定值，根据法规调整）时，备注栏不能为空，需要在备注栏注明现钞来源证明材料。

此种情
况返回的回执报文中的状态码为“450020”，错误详细信息为“单笔现钞结汇金额超过等值5000美元，请审核现钞来源证明材料，并在备注栏注明！”。

6.8不占额度的结汇信息补录
6.8.1请求报文
XML节点TAG ：根节点->BODY->DA TASTORES->DS->PARAMETERS
XML节点TAG ：MSG->BODY->DATASTORES->DS->ROWSET->ROW
6.8.2回执报文
XML节点TAG ：MSG->BODY->DATASTORES->DS->ROWSET->ROW
6.8.3业务规则
1）校验及约束参照不占额度个人结汇信息录入。

2）当结汇资金形态为“外币现钞”，且单笔外币现钞结汇金额超过等值5000美元（目前设定值，根据法规调整）时，备注栏不能为空，需要在备注栏注明现钞来源证明材料。

此种情况返回的回执报文中的状态码为“450020”，错误详细信息为“单笔现钞结汇金额超过等值5000美元，请审核现钞来源证明材料，并在备注栏注明！”。

6.9个人购汇信息分类和查询
6.9.1请求报文
XML节点TAG ：根节点->BODY->DA TASTORES->DS->PARAMETERS
6.9.2回执报文
XML节点TAG ：根节点->BODY->DA TASTORES->DS->ROWSET->ROW
6.9.3业务规则
证件类型与国家/地区对应关系及相应的证件号码校验规则
6.10占用额度的个人购汇信息录入
6.10.1请求报文
XML节点TAG ：根节点->BODY->DA TASTORES->DS->PARAMETERS
6.10.2回执报文
XML节点TAG ：根节点->BODY->DA TASTORES->DS->ROWSET->ROW
6.10.3业务规则
1）证件类型与国家/地区及交易主体对应关系
姓名格式要求：只允许录入汉字、字母（半角）或符号（仅支持半角格式的点“.”）中间允许有空格
证件类型及相应的校验规则
2）购汇金额应大于零。

3）购汇提钞金额+汇出资金（包括外汇票据）金额+存入个人外汇账户金额+旅行支票金额=购汇金额。

4）购汇金额折美元小于等于年度剩余可购汇折美元金额。

5）提钞金额当日累计超过等值1万美元，备注栏不能为空，需要在备注栏注明提钞用途。

此种情况返回的回执报文中的状态码为“450010”，错误详细信息为“当日累计提钞超过等值10000
美元，请在备注栏注明提钞备案表号”。

6）查询个人主体分类状态，如果个人主体分类状态为“重点关注对象”且未签署确认书，需要通过“确认书状态更新”服务实现签署确认书。

此种情况返回的回执报文中的状态码为“450001”，错误详细信息为“确认书未签署，不能提交”。

7）币种列表为银行币种专用代码表。

如果当月外汇局没有折算率，则查找上一个月的折算率（月份递减查询），如果外汇局没有该币种折算率，系统提示“外汇局没有该币种的折算率，请按美元录入，并在备注中说明实际币种”。

8）交易主体对应的购汇资金属性限定如下表所示：
6.11不占额度的购汇信息录入
6.11.1请求报文
XML节点TAG ：根节点->BODY->DA TASTORES->DS->PARAMETERS
XML节点TAG ：根节点->BODY->DA TASTORES->DS->ROWSET->ROW
6.11.2回执报文
XML节点TAG ：根节点->BODY->DA TASTORES->DS->ROWSET->ROW
6.11.3业务规则
1) 业务类型与证件类型、国家/地区对应关系
姓名格式要求：只允许录入汉字、字母（半角）或符号（仅支持半角格式的点“.”）中间允许有空格
证件类型及相应的校验规则
如果业务类型为“提供凭证的经常项目其他购汇”，通过对应交易主体是境外个人的证件类型（对应关系见第一条）办理购汇金额小于“境外个人小额购汇单笔限额”（目前设定500美元，根据法规调整），备注栏可以为空；超过此限额，备注栏不能为空。

此种情况返回的回执报文中的状态码为“450019”，错误详细信息为“境外个人购汇金额单笔超过500美元，备注栏不能为空，需要在备注栏填写凭证信息”。

3）如果业务类型“提供凭证的经常项目其他购汇”并且对应交易主体是境内个人，备注栏不允许为空。

4）购汇提钞金额+汇出资金（包括外汇票据）金额+存入个人外汇账户金额+旅行支票金额=购汇金额
5）证件类型为外交官证时，不校验购汇提钞汇累计金额和境外个人小额购汇单笔限额。

6）证件类型不是外交官证件时，购汇提钞金额折美元当日累计超过1万美元（目前设定值，根据法规调整），备注栏不允许为空，需填写备注栏注明提钞用途，此种情况返回的回执报文中的状态码为“450010”，错误详细信息为“当日累计提钞超过10000美元，请在备注栏注明提钞备案表号”。

7）系统对支付机构组织机构代码进行校验，支付机构代码必须存在于支付机构准入表中；通过支付机构的结汇目前仅限于境内个人。

后台参数设置，如以后政策调整，可调整参数。