《2_广东机关事业单位养老保险系统职业年金子系统与受托人系统对接需求规格说明书【2018.08更新稿】农行.docx》由会员分享，可在线阅读，更多相关《2_广东机关事业单位养老保险系统职业年金子系统与受托人系统对接需求规格说明书【2018.08更新稿】农行.docx（101页珍藏版）》请在三一办公上搜索。
1、广东机关事业单位养老保险系统职业年金子系统与受托人系统对接需求规格说明书2016年4月1.1 目的41.2 适用范围42.1 产品描述42.1.1 产品要解决的问题42.1.2 业务范围42.1.3 涉及角色52.2 产品功能62.2.1 数据交换流程图62.2.2 系统间数据传输链路72.2.3 业务总体流程图83.1 数据文件格式约定93.2 SOCKET报文格式约定103.2.1 报文的签名与加密103.2.2 报文构成103.2.3 消息体语法113.2.4 消息报文示例123.2.5 XML格式约定143.2.6 交易列表143.2.7 文件类型代码164, 管理类交易164.1 连
2、通性测试164.2 通用交易查ifU17功能性需求195.1 基础信息管理195.1.1 流程图195. 1.1.1计划信息195.1.2 计划管理195. 1.2.1计划管理业务描述196. 1.2.2计划管理业务规则207. 1.2.3计划管理数据指标说明205.1.3 定价日管理305.1. 3.1定价日业务描述305.1.3.2定价日业务规则305.1.3.3定价日信息推送305.2投资运营管理315.2.1 社保划款（受托人收款）315.2.1.1社保划款流程图321. 2.1.2划款指令（徽费信息传递）335. 2.1.3划款到账反馈385.2.2投资成交管理405. 2.2.1投
3、资成交管理数据交互图406. 2.2.2投资管理业务场景描述407. 2.2.3投资管理明细数据交互图428. 2.2.4投资管理业务校验规则439. 2.2.5投资管理数据指标说明445.3待遇支付535.3.1 待遇支付数据交互图535.3.2 待遇支付业务场景描述535.3.3 待遇支付流程明细数据交互图555.3.4 待遇支付业务校验规则565.3.4.1接口一待遇支付文件就绪校验规则565.3.4.2接口一待遇支付文件内容与消息进行匹配校验规则565.3.4.3接口二待遇支付文件就绪校验规则575.3.4.4接口二待遇支付文件内容与消息进行匹配校验规则585.3.5待遇支付数据指标说
4、明595. 3.5.1接口一待遇支付发送数据文件596. 3.5.2接口一待遇支付文件就绪消息607. 3.5.3接口一待遇支付文件处理消息638. 3.5.4接口二待遇支付回执数据文件649. 3.5.5接口二待遇支付回执文件就绪消息6510. 3.5.6接口二待遇支付回执文件处理消息665.4投资监督统计信息665.4.1 投资监督统计信息场景描述665.4.2 投资监督统计信息校验规则665.4.3 投资监督统计信息指标说明665.4.3.1基础投资信息上传665.4.3.2资产配置分析信息上传69叁数定义841.1 交易类别841.2 计划类别841.3 计划属性841.4 资格类型8
5、41.5 币种851.6 尾数处理方式851.7 交易周期851.8 投资组合状态851.9 单位类型861.10 行业类别861.11 职业年金计划备案地代码861.12 银行行号871.13 证件类型871.14 资金划拨类型881.15 性别881.16 转移类型881.17 支付类型881.18 损益标志891.19 支付方式891.20 支付周期891.21 职业年金基金管理机构代码891.22 短溢缴处理方式921.23 23收支类型921.24 受托户科目余额表科目代码921.25 受托户资产负债表项目代码931.26 受托户净资产变动表项目代码931.27 受托户核算对账类型9
6、41.28 划款收账类型941.29 经费来源941.31 职业年金计划登记号951.32 统一计划代码951.33 投资组合代码951.34 交易序列号961.35 35组合类型961.36 估值信息类型961.37 机构类型967. 性能需求978. 安全管理需求979. 附录989.1 编码对照表981.引言1.l目的编写此文档的目的是进一步定制软件开发的细节问题,希望能使本软件开发工作更具体，是为使用户、软件开发者及分析人员对该软件的初始规定有一个共同的理解,它说明了本产品的各项功能需求、性能需求和数据要求,明确标识各功能的实现过程，阐述实用背景及范围，提供客户解决问题或达到目标所需的
7、条件或权能，提供一个度量和遵循的基准。1.2适用范围本需求适用于广东省机关事业单位养老保险系统职业年金管理方作为代理人（含账管人）与参与年金运营管理的受托人系统间日常业务的联网对接。2.概述2.1 产品描述2.1.1 产品要解决的问题通过联网接口实现职业年金系统与受托人系统间日常业务的衔接、互动及数据同步等，以提高运营效率与管理水平，减少人为失误，降低人力成本。2.1.2 业务范围基础信息管理：指在代理人与受托人签订合同后，在代理人系统与受托系统间进行计划基本信息、年金管理人基本信息、定价Fl信息的同步与业务联动；划款（缴费）管理：指代理人完成对单位缴费（含个人缴费）的归集，并从归集户向托管户
8、划款，之后代理人向受托人发送收款指令并由受托人确认收款。成交管理：指代理人根据单位缴费、年金转入、年金待遇支出（含一次性及分期）、年金转出等账户变动信息，按当前有效的单位净值生成包含申购、赎回、净成交等信息的成交表，并提交给受托人。受托人根据成交表发起执行相应的中购、赎回等业务。支付管理：指代理人在生成年金待遇支付（含报税）信息后，将人员支付明细、支付数据汇总等信息发送给受托人，由受托人向托管人发送执行支付指令，支付完成后，由受托人向代理人反馈支付结果。投资监督及信息报告：指受托人定期将年金计划的投资运行的相关信息汇总发送给代理人，代理人对运营数据进行监督和信息披露。2 .L3涉及角色社保（委
9、托与账管人）、受托人、托管人、投资管理人2.2产品功能221数据交换流程图222系统间数据传输链路机关保职业年金端职业年金机构受托人端机保甲亚年金系战机保侨置机含 SoCkeiaSftP 脓务0业年金机构费托人前置机职业隼金机构受托人 含SOCka服务核心系优社保中心职业年金账管系统与受托管理人通过建立专用的传输链路实现双方的系统对接和数据交换。223业务总体流程图职业年金委托人与受托人业务对接总体流程示意图社保业务社保财务对接接口（委托人修）对接接口（受托人端）（划款指令卜一（财务对账划款确认L三（设置定价日估值信息L管理r彳成交%理）赎回T定价日信息下载）J单位净值信息上传）成交汇总报表上
10、传待遇赎回投成交年金待遇支付计划投资分配指令发送给托管.投管资产划款指令发送给托管，投管接收待遇F付信息）待遇支付通知代发请求文件J待遇支付结果信息待遇发放结果文件生成待遇支付指令并发给托管根据托管发放情况生成待遇发放结果3 .通讯方式广东机关事业单位职业年金系统与受托人系统之间划款指令、单位净值、投资成交、支付通知等业务数据交换包括数据文件传输和文件就绪通知。广东机关事业单位系统建立SFrP服务，双方系统均建立SoCKET服务，数据文件发送方采用SFTP协议向SFTP服务器传输数据文件.在传输完成后，发送方再向接收方采用短连接的SOCKET通讯方式发送报文通知文件就绪，接收方给予回应报文。S
11、FTP服务用于数据文件的传输，主要适用于单笔交易包含大量数据的情形。目前需要按文件进行数据传输的主要是代发请求文件和代发结果文件。SFTP服务器设在委托方内网。其他的数据传输及交互采用SOCKET报文。系统采用SHAlWithRSA算法进行签名。双方首先各自以1024位的RSA算法生成自己的密钥对，并招X509格式的公钥提供给对方用丁数据文件加密以及报文的数字签名验证。此外委托方将受托人提供的公钥导入SFTP服务,受托人访问SFTP服务时要采用私钥进行认证。为避免出现字符编码错误，数据文件和SOCKET报文均采用UTF-8编码。发送方接收到回应后负责断开SOCKET连接。3.1 数据文件格式约
12、定1 .原始数据文件为纯文本文件。2 .数据文件内主体采用定长报文格式，字符型数据不足位,则在字符串后用空格补齐，数字型数据不足位则在前面补0,没有分隔符。3 .金额是以分为单位的整数，无小数点。4 .日期的格式为YYYYMMDD,时间格式为HH24MISS。5 .文件命名规则如下：aa+XXXXXXXX+To+bb+YYYYYY11+nnnnnnn+YYYYMMDD+BATCHNO+.txt其中：aa：表示文件发送方：，RS，一人社；，ST受托人系统。bb：表示文件接收方：RS一人社；SV受托人系统。XXXXXXXX：表示文件发送方代码，即受托人系统、社保等机构的代码。YYY11YYY:表示
13、文件接收方代码，即受托人系统、社保等机构的代码。nnnnnnnn：文件类型代码。YYYWfDD:发送文件的年月日。BATCHNO：数据批次号。该批次号为不重旦的流水号。例如，“RS12345678ToST87654321_NJF01001_20120205_432094830284734.txt”表示社保机构12345678发送给受托人系统87654321的类型为NJF01001的文件，该文件是2012年2月5日发送，数据批次号为432094830284734。6、文件的正文需逐行加密，加密采用AES算法的ECB模式。AES密钥为保护数字、大小写字母、特殊符号等在内的随机字符串。加密后需转换为
14、base64编码并去除其中的换行与回车符。文件发送前采用gzip算法进行压缩，压缩文件名在原文本文件名后宜接添加扩展名.gz。例如：rtRS12345678ToST87654321_NJF0100l_20120205_432094830284734.txt.gzw数据的签名和解密密钥通过SOCKET报文传输(参见交易“文件就绪通知”文件的签名是通过RSA算法对压缩文件的签名.3.2SOeKET报文格式约定3.2.1 报文的签名与加密报文数据的签名算法采用SHAlWithRSAe加密算法采用AES的ECB模式。SOCKET报文的正文采用AES加密算法的ECB模式，签名与加密规则如下：(1)木地随
15、机生成16位长的AES密钥(2) AES密钥采用对方RSA公钥加密后附加在报文中(3)用本方私钥对报文正文的明文进行签名后附加在报文中(4)用AES密钥对报文正文(即消息体)进行加密3.2.2 报文构成SOCKET消息格式分为消息头、消息体两部分。其中消息头由报文长度、AES密钥域、签名域三个固定长度的子项组成。消息格式完整定义如下:消息头消息体报文长度AES密阴域消息正文明文的签名消息正文4字节、明文128字节、RSA加密密文128字节、RSA签名不定长、AES加密密文1、报文长度域：由4个字节组成的16进制数字，代表消息体长度加上数字签名域的长度。比如前面4个字节的hex码为OXOOooo
16、666,代表后续报文长度为1638字节，即消息体+数字签名域的长度为1638字节，不包括报文长度域本身的4个字节长度2、发起方编码统一由广东机关事业单位养老保险系统后台生成后告知各接入方（如受托人）。3、交易编号：详见交易列表章节。4、消息体：报文的正文即数据主体。5、数字签名域：128位的数字签名。3.2.3 消息体语法消息体采用XML格式描述，消息体的语法规则完全遵循XML语法规则，编码字符集为UTF-8。每一个消息体由一个公共域和一个业务域组成。整个XML格式的消息体以CPenSiOnData为根节点，公共域放在根节点之中，业务域以为节点名称。注意，在本文中，为方便阅读，XML节点中可能
17、使用了大小写字母，但在实际使用中，XML的所有节点均使用小写字母消息体报文格式如下：、公共域Pensionlnfo业务域GPenSionInfo发送时间、消息标识号以及其他些通用信息。公共域数据指标项如下:要素名称XMLTag是否必输元素类型备注标准版本号YX5例如：vl.0发送机构X30消息发送者标识接收机构YX30消息接收者标识发送人NX50发送人接收人NX50接收人日期YN8消息发送日期，格式：YYYYMMDD时间YN6消息发送时间，格式:HHMMSS数据集类型NX4本数据文件中所包含的数据集类型交易编号TypeCodeYX4见3.2.6交易列表数据集名称TypeNameNX30数据集类
18、型摘要NX200返回代码NX4AppCode,AppMsg仅出现且必须出现在应答报文中。用于标识应答方处理成功失败情况。其中返回代码为“0000”时表示正常，此时AppMsg可以为空：返回代码不为“0000”时,必须有返回信息来描述异常或失败原因。0000正常1001后续未列出的其他原因的失败1002重熨的报文标识1003通讯报文头格式错误1004通讯业务体格式错误1005报文签名验证失败1006密钥不一致5001原交易不存在9900备用自定义编码9999因不符合业务规则引发的失败出错提示信息NX5003.2.4 消息报文示例3.1.1.1 1.请求报文（以年金基本信息推送为例）1）消息体明文
19、部分l.0.0S51T012017051710314912014774220170517S51120100000000ll7221984198412345678023940239l112221111122204trustaccname测试职业年金受托财产专户lanname年金计划00lP3J5M1212122017050542120170505l(2)SoCKET报文全文假设消息体明文部分的长度为733,加密后的长度为736。因加密后密钥的密文及报文签名的长度均为128,因此，报文的总长度为736+128+128=992,992的16进制值为0x03E0,往前填充两个OXO0,达到约定的4字节
20、长度，结果为0x000003E0o则完整的SOCKET报文全文示例如下：OXOOOO03E用RSA算法加密后的AES密钥的密文消息体明文的RSA签名数据用AES算法加密后的消息体3.1.1.2应答报文应答报文格式和请求报文完全一样，但消息体的公共域部分增加了APPCOde和APPMSg两个节点，分别表示返回代码和出错提示信息。PenSionlnfo节点内的由各业务环节业务要素确定。响应报文的公共域部分的为接收方当前接口的版本号，,为接收方系统当前的日期和时间。3.2.5 xml格式约定1,在实际通讯中，所有的Xml节点均使用小写（包括公共域部分）。2,字符编码采用UTF-83,所有XML均应有
21、XmI头4,对转换为BASE64编码的，一律去除其中的换行与回车符即r与n3.2.6 交易列表交易编号交易名称交易类别发起方响应方说明OlOl连通性测试99-其他代理人受托人用于代理人系统发起的网络连通性测试，检测与受托方的网络连接是否正常。OlOl连通性测试99-其他受托人代理人用于受托方系统发起的网络连通性测试，检测与代理人的网络连接是否正常。0102通用交易查询07-查询代理人受托人由代理人发起，查询先前的某笔交易在受托方是否存在。如果存在，则返回原应答报文，如果不存在，则返回报错报文。0102通用交易查询07-查询受托人代理人由受托方发起，查询先前的某笔交易在代理人是否存在。如果存在，
22、则返回原应答报文，如果不存在，则返回报错报文。1101计划基本信息推送04-指令发送代理人受托人代理人向受托方推送已经设置完毕的各计划信息1102投资组合信息推送04-指令发送代理人受托人代理人向受托方推送已经设置完毕的投资组合信息1103年金管理人信息推送04-指令发送代理人受托人代理人向受托方推送已经设置完毕的各类年金管理人信息1104定价日信息推送04-指令发送代理人受托人委托方将新增或修改后的定价日信息推送给受托方1201划款指令上传04-指令发送代理人受托人委托方财务划款完毕后，委托方自动将划款指令上传到受托方。1203划款到账回执05-指令反馈/确受托人代理人受托方收到划款指令后，
23、检查并确认相关划款是否已到账并向委托方发送是否已经到贱认的回1210单位净值信息上传04-指令发送受托人代理人受托方将到账当前单位净值上传到委托方1211资产估值明细下载99-其他代理人受托人委托方从受托方下载当前资产估值明细数据1212成交汇总报表上传04-指令发送代理人受托人委托方将成交汇总数据上传给受托方，受托方据此进行赎回、投资分配等操作1205文件就绪通知（发放通知）04-指令发送代理人受托人通知对方文件已经上传至SFTP,对方可以下我文件并做后续处理。1208文件就绪通知（发放结果反馈通知）05-指令反馈/确认受托人代理人9208文件处理结果通知04-指令反馈/确认代理人受托人与“
24、文件就绪通知”配合使用，告知对方能否成功下载、解析以及对文件的验证是否通过。9208文件处理结果通知04-指令反馈/确认受托人代理人1350基础投资信息上传04-指令反馈/确认受托人代理人受托人方上传基础投资信息到代理人1301管理机构变动情况02修改受托人代理人报告期内管理机构更换信息1302资产净值和收益情况99.其他受托人代理人向代理人报送资产净值及收益信息1303资产分布情况99-其他受托人代理人向代理人报送投资资产的大致分布情况1304养老金产品分布情况99其他受托人代理人向代理人报送投资养老金产品分布情况1305风险准备金信.息99-其他受托人代理人向代理人发送职业年金基金投资组合
25、风险准备金变动情况1306计划管理费用信息99其他受托人代理人向代理人提供受托户在报告期间计提的管理费用信息1307管理费用明细信息99-其他受托人代理人向代理人提供在报告期间计提的管理费用明细1308投资组合风险控制指标99-其他受托人代理人向代理人报送投资组合的风险控制指标1309资产负债表99.其他受托人代理人托管人与投资管理人对职业年金基金投资组合的核弊结果进行核对后，向受托人发送投资组合及计划的资产负债情况，受托人再发送给代理人1310净资产变动表99-其他受托人代理人托管人与投资管理人时职业年金基金投资组合的核算结果进行核对后，向受托人发送投资组合及计划的净资产变动情况，受托人再发
26、送给代理人3.2.7 文件类型代码类型代码文件类型文件类别发送方接收方说明Njfo100i1206发放委托人受托人NJF020011206发放受托人委托人4,管理类交易4.1 连通性测试受托人系统或者广东机关事业单位系统可使用此接口,检测双方系统的连通性情况；也可使用此接口验证双方系统的网络报文传输、数字签名生成校验等是否正确。广东机关事业事业单位与受托人系统的连通性测试的业务功能号VTyPeCOde为“0101”；报文格式示例如下：请求报文l.0.0S5lT0120170516154656消息报文示例0101连通性测试20170516S510101(M)OOOOOOl99人答报文?xmlVe
27、rSiOn=1.0encoding=*utf-8*?l.0.0T01S5120170516l54656消息报文示例appcode返回代码，如：0000appmsg返回提示信息，如：交易成功0101连通性测试20170516S51010100000000l4.2 通用交易查询说明：通用交易查询主要用于判断由发起方发出的交易，是否被对方成功接收并处理，并以此为依据处理因为网络中断或其他异常导致的不确定交易，比如重新发起对方未接收到的交易。本交易请求报文的公共域在其交易的业务域中增加了。IdAPPSeriOnO节点，用于接收方定位要查询的原交易。应答报文则增加了OldAppCode和OldAPPMS
28、g两个节点，分别用于标识原交易返回代码和提示信息。查询交易本身的返回代码和提示信息在AppCode和AppMsg内，其中ppCode取值规则如下：0000：表示原交易存在，原应答报文参考OldPenSionlnfO节点：5001：表示原交易不存在，此时无OldPenSiOnInfO节点9999：通用交易查询本身执行失败，失败原因需查看AppMsg,此时无OldAppCode、OIdAPPMSg及OIdPenSionlnfo节点。清求报文版本号：如1.0SOKSendCodeT012016010KSendDate235959摘要0102通用交易杳询00000000000010200000000l
29、07oldAppseriono)原报文标识seriono原交易报文的主体内容即原PensionInfo节点内的内容，该部分类容可选应答报文版本号：如1.0报文唯一标识号S01T0120160101235959摘要0000：表示原交易存在，原应答报文参考OldBUSiTeXt节点；5001：表示原交易不存在，此时无。IdBUSiTeXl节点交易成功oldAppCode)原返回代码原交易提示信息00000000000010200000000107oldAppseriono原报文标iR原交易报文的主体内容即原PensionInfo节点内的内容，该部分类容可选5.功能性需求5.1 基础信息管理在社保依
30、据相关的合同、协议与方案，建立或变更职业年金计划信息、年金管理人信息、组合信息、定价日信息等基础信息后。通过接口功能实现社保系统与受托人系统之间的基础信息交互与数据同步。同步的数据范围包括：计划信息、托管人信息、投管人信息、受托人信息、定价日信息。5.1.1 计划管理5.1.1.1 计划管理业务描述计划建立：社保中心（代理人）和受托人合同签署完毕后，社保中心根据合同信息在本方系统录入受托人信息、托管人信息、投管人信息以及计划信息。广东机关事业单位职业年金系统将计划基本信息数据通过接口向推送给受托人系统，受托系统判断计划数据为新增计划，启动计划建立业务流程，完成计划建立业务。计划信息变更：广东机
31、关事业单位职业年金系统将计划基本信息数据通过接向推送给受托人系统。受托人获取计划信息唯一标示后，根据广东机关事业单位职业年金系统发起计划管理人推送的信息数据，受托系统判断计划数据为非新增计划且有变更时，则发起计划信息变更业务。为了兼容计划层定价和组合层定价两种模式，因此即便是计划层定价模式，社保端仍然会在计划下设置一个计划层组合。受托方按合同约定设置的实际组合信息应与社保端计划层组合信息建立对应关系，受托方传送的资产估值相关信息应以社保端的计算层组合信息进行转换处理。计划层定价和组合层定价，两种模式的组合信息均由社保先行创建，社保端推送，受托人下我组合信息。5.1.1.2 计划管理业务规则1、
32、计划数据信息范围：计划基本信息、计划管理人信息、投资组合信息、定价日信息2、社保系统每次更改计划信息之后自动将修改的信息推送给对应受托人系统。3、受托人系统获取计划数据信息后，需判断若为新增计划信息，则发起计划建立业务；若为原有计划信息，则发起计划信息变更业务。5.1.1.3 计划管理数据指标说明5.1.1.3.1 计划基本信息推送请求报文业务要素序号数据项名描述类型长度是否必填备注1Appseriono交易序列号X24是参数6.342Translypc交易类别X2是参数6.13Planlicdale年金计划备案批复日期X84Accountplanid代理人计划编码X30由相关机构白行定义编码
33、规则，确保木机构内部唯一性，在数据交换中仅根据双方约定辅助参考使用。代理人发送受托人时必填5Trusteefee受托管理标准费率N8,46Planname年金计划名称X100是备案的计划名称7Planlicid年金计划登记号X20PK年金计划确认函中的登记号，参数6.318Planatt计划属性X2参数6.39Plantype计划类别X2参数6.2IOTrustconno受托合同号X2011Trusteeid受托人代码X10是参数6.2112Custodianid托管人代码X10是参数6.2113Trustorid代理人代码X10是参数6.2114Unifiedplan统一计划代码X8参数6.
34、32Iicid15Unifiedplanname统一计划名称X10016Planbcgdatc年金计划生效日期X817Planenddate年金计划终止日期X818Custodian受托财产托管账户开户行名称X6019Custaccountbankid受托财产托管账户开户行行号X12参数6.1220Trustaccname受托财产托管账户名称X10021Trustaccno受托财产托管账户账号X4()22Lastupddate最后更新日期X823Memo摘要X10024Unifiedcust(lianid统一计划收益率计算人代码X1025UnifkdtrUSteeid统一计划收益率审核人代码XIO26CustodianCe托管标准费率N8.427investratc申购比例N8,428draw
