《XX集团有限公司XX财务平台与相关信息系统接口改造需求说明书》由会员分享，可在线阅读，更多相关《XX集团有限公司XX财务平台与相关信息系统接口改造需求说明书（13页珍藏版）》请在金锄头文库上搜索。
1、XX集团有限公司XX财务平台与相关信息系统接口改造需求说明书1 .概述为了配合计划财务部推进财务报销管理系统、应收管理系统、应付管理系统项目建设，规范合同、客商等信息数据，实现与财务系统对接与数据交互，为对台、集团下属各前端合同管理系统进行规范化、系统化管理，计划对现有OA协同办公平台、集团合同管理系统、影视剧管理系统、XX合同管理系统四个信息化进行相应改造。为了实现财务应收、应付自动化、一体化管理，需要建立台、集团统一客商库，并将各合同管理系统中的合同归档信息（主要包括合同名称、经办单位、对方单位、收付款类型、有效期等基础信息，合同正本扫描件、会签单等等）实时同步到财务应收、应付管理系统。2
2、 .各关联平台职责前端合同管理系统- 合同起草、审批、盖章等全流程合同在线监管- 将审批流程已完成，进入归档阶段的字段推送给财务中台- 本次项目涉及OA协同办公平台、集团合同管理系统、影视剧管理系统、XX合同管理系统四个信息化系统，四个信息化系统详细情况如下表所示。序号系统名称使用范围1集团合同管理系统集团职能部门、事业部2OA协同办公平台XX卫视中心，XX广播中心，融媒体中心，X3影视剧管理系统X影视剧中心4XX合同管理系统XXXX传媒技术有限公司财务中台- 接收来自财务中台的收付款内容- 回传收付款结果到财务中台- 主要包括财务应收管理系统和财务应付管理系统财务中台一客商模块- 推送客商信
3、息到各个前端合同管理系统以供使用- 历史签约情况、合同执行各环节记录况查看- 风险客商预警3.需求详细说明本次改造重点是各信息化系统统一客商库，将合同前端系统的合同归档相关信息实时同步到财务中台系统，便于财务后续应收与应付的有效管理。合同前端系统与财务中台之间数据交互详细逻辑如下图所示。业务流程图合同前排系统财务中台财务中台单点登录平台客商档案组织架构用户信息客商档案归档系统定时抓取归档系统定时抓取客商档案组织柒构用户信息财奂推送合同修订合同面单手0A合同终止审影/过归档导入接口一H合同归档信息接口合同档案报销单L雷自闻R谟乐线中 !幄崖口冏号状总变更接口 合同详情显示收付款接口收付款单调用1
4、）在前端合同管理系统中完成合同新建、审批、修改变更、附件上传等一系列动作。当合同管理系统审批结束，进入归档节点，推送需归档字段到财务中台，合同状态为“生效”。2）在前端合同创建补充合同需要具有合同号，需设置与主合同的关联关系并推送财务中台。3）补充合同创建时需通知财务中台将主合同状态变为“变更中”。补充合同归档后，再次通知财务中台将主合同状态变更为“生效”。4）前端合同管理系统去除客商创建功能，创建新合同时先从本地客商库中选择，如该客商需要新建，则从财务中台客商模块中创建新客商，并从客商模块中将相关客商信息推送到对应的前端合同系统方才可以被选择。5）如客商被用户赋予了警示状态则各系统均可看到相
5、关状态，但该客商仍然能够被选择进行合同申请。6）如客商被加入了黑名单，需推送相关状态到前端合同系统的具体分部处，该客商在前端合同系统中，该分部的用户可见该客商的“黑名单”状态，并不可选择该客商进行合同申请。7）当前端合同进入财务中台，财务中台根据相关信息完成收付款操作后将相关信息在财务中台进行记录。8）财务中台进行收付款操作时，可以实时调取合同详情及附件进行查看。9）以后如因业务需求，需增加各对接接口的推送字段，可以通过配置完成字段的添加，不需要对接口进行另外的开发。10） 各对接系统均需要对数据传输进行日志记录。记录相关数据的推送/接收时间，具体推送/接收接口，推送/接收源或目标，推送/接收
6、内容，是否推送/接收成功等信息，如数据推送/接收失败需记录具体的报错信息,以方便问题定位排查解决。4.相关接口需求说明4.1 返回值注意：后续所有接口，均按照以下格式返同：（code”:0,“message:”，/描述result:,/结果success:true,执行结果成功true,还是失败false；timestamp:0/时间戳4.2 获取token令牌接口地址：/smg-bootcontractapigetToken请求方式：GET接口描述：用于后续接口参数herder头文件信息X-ACCeSS-TOken参数值有效期：60分钟（可调整）请求参数:参数名称参数说明请求类型是否必须数据
7、类型username用户帐号querytruestring响应参数:参数名称参数说明类型code返回代码integer(int32)message返回处理消息stringresult返回数据对象objectsuccess成功标志booleantimestamp时间戳integer(inl64)响应示例：(,successrtruez“message:操作成功！,codeOz,result,eyJOeXAiOKVlQiLCJhbGciOiJIUzllNiJ9.eyJleHAiOjE10TkONzlMTEslnVzZXJuYWllljoiMSJ93GraSZ42a2BVkDur-ZKOd-TlyK
8、YRVOj.x9oeCpOTgz,timestampzl599473711395)4.3 合同新增/更新接口接口地址：smg-boot/contract/api/synContract调用方：前端合同系统被调用方：财务中台请求方式：post同步时机：实时接M描述：合同归档对外接口请求参数:参数名称参数说明请求类型是否必须数据类型ContraclPage合同归档表bodytruecontract对象X-Access-TokenaiKeyheadertruect_contractPage对象参数名称参数说明请求类型必输数据类型备注SourceSys外部系统来源bodytruestringexter
9、SysId外部单据IDb(lytruestringadvert是否含有广告元素bodytruestring是/否afterawerMemo事后合同说明bodyfalsestringafterwardsCt是否为事后合同bodytrueString是/否amountMemo金额备注bodyfalsestringauthorization授权方向bodyfalsestring授权方、被授权方、各方分配beginDale合同生效日期bodyfalsestringyyyy-mm-ddContractBCode关联合同编号（如果是补充协议，必输，这里是所关联的外部单据exterSysId）bodystr
10、ing当为补充协议是必输CoppyrightValid版权期限bodyfalsestringCopyrightProp版权性质bodyfalsestring独家/非独家CtCode合同号bodytruestringCtCodeYw业务合同号bodyfalsestringCtDescibe合同背景及主要内容bodytruestringCtName合同名称bodytruestringCtType是否补充协议bodytruestring是/否CtValidity合同有效期bodytruestringXXXX年XX月XX日一XXXX年XX月XX日；合同签订后多少天生效CustomerBan对方账号开户
11、行bodyfalsestringCustomerBankno对方收款账号bodyfalsestringfwdemo法务备注bodytruestringhandlingCo)经办单位编码bodytruestring与HR架构一致HandlingCorpName经办单位名称bodyfalsestringhandlingDept经办部门编码bodytruestring与HR架构一致handlingDeptName经办部门名称bodyfalsestringhandlingUser经办人工号bodytruestring与HR系统一致handlingUserName经办人姓名b(lyfalsestring
12、keyWord关键词bodyfalsestringIegerUser法务人员工号bodyfalsestring与HR系统一致IegerUserName法务人员姓名bodyfalsestringmemo备注bodyfalsestringnyear年度bodytruestring合同前端系统中创建流程日期的年度OriginalAmount合同原币金额bodytruenumberOriginalCurrency合同原币币种bodytruestringCNY/USD/JPY/EUR/GBP/HKD/AUD/KRWpartnerld对方单位编码bodytruestring参照NCC客商档案Partner
13、Name对方单位名称bodytruestringpayType收付款类型bodytruestring收付款类型，传名称收款、不固定金额收款、付款、不固定金额付款、不涉及费用priority紧急程度bodyfalsestring特急、紧急、一般prqjectld项目编号bodyfalsestring参照NCCprojectName项目名称bodyfalsestringIechnicalServic是否外部技术服务bodytruestring是/否IemplelCtFIag是否为格式合同bodytruestring是/否vatFlag是/否增值税专用发票bodytruestring是/否weBank我方账号开户行b(lyfalsestringweBankno我方收款账号bodyfalsestringWeCorpId我方单位编号bodytruestring参照NCC内部客商WeCorpName我方单位名称bodyfalsestringincomeType收入类型body
