测试文章

Posted 2020-11-29 jnnleo

文档编码	GMC_CFAS_FO_SSC_WRITE_20191103
密级	1级
文档版本	1.0
拟制人	李朋飞
日期	2019-11-03

 

 

 

 

久其云报账

设计文档

（共享操作回写）

 

 

 

 

 

 

 

 

 

郑重声明：北京久其软件股份有限公司版权所有。本文档中任何部分未经北京久其软件股份有限公司书面授权，不得将材料泄露给第三方，不得以任何手段、任何形式进行复制与传播。

变更履历

版本	日期	变更位置	变更理由/变更内容	变更人	备注
1.0	2019-11-03		创建文档	李朋飞

                                                                                                            

 

 

目录

文档编码..................................................................................................... 1

变更履历.......................................................................................................................... 2

1 名词与缩略语............................................................................................................... 3

2 设计概述...................................................................................................................... 3

3 功能设计...................................................................................................................... 4

3.1 命名规范............................................................................................................. 4

3.2 代码工程............................................................................................................. 4

3.3 推送SSC自动任务.............................................................................................. 4

3.3.1 功能描述................................................................................................... 4

3.3.2 注意事项................................................................................................... 4

3.4 推送SSC单据按钮.............................................................................................. 4

3.4.1 功能描述................................................................................................... 5

3.4.2 注意事项................................................................................................... 5

3.5 SSC操作反馈接口................................................................................................ 5

3.5.1 功能描述................................................................................................... 5

3.5.2 注意事项................................................................................................... 6

4 单据表设计................................................................................................................... 6

4.1 单据业务表FO_XXBILL（增加固化字段）......................................................... 6

 

1        名词与缩略语

2        设计概述

开发提供单据审批通过推送SSC自动任务

开发提供单据“推送SSC”单据按钮

开发提供单据操作反馈接口（复核完成、支付完成、生成凭证）

 

3        功能设计

3.1     命名规范

3.2     代码工程

cfas-fo

 

3.3     推送SSC自动任务

开发自动任务实现单据入池动作

3.3.1   功能描述

1. 校验单据字段是否完整，缺少字段推送失败，记录日志
2. 通过接口查询单据入池配置信息SSCConfigController
3. 根据配置信息和单据信息封装推送报文
4. 调用共享平台webservice接口推送单据（操作状态：驳回标识=1 操作状态UPDATE,驳回标识=0 ADD），根据接口返回结果成功(code=10)时单据SSCSENDFLAG字段赋值1，失败时记录日志
5. 推送单据成功时调用接口（SSCTaskHistoryService）往操作记录日志表SSC_TASK_HISTORY中插入一条入池成功记录

3.3.2  注意事项

1. 调用接口推送单据信息进入共享平台失败时需要将错误信息和推送报文记录到日志中

 

3.4    推送SSC单据按钮

开发单据按钮实现手动推送单据进入共享平台

3.4.1  功能描述

1. 按钮标识：bill-send-ssc

2. 可用时机：单据审批通过（billstate=130）且 SSCSENDFLAG = 0 / SSCSENDFLAG=1和SSCREJECTFLAG!=0时按钮可用

3. 开发过程：

(1)      后端参考BillCommitAction，前端参考fo-start-action.js

(2)      校验单据字段是否完整，确实字段给出提示：XX字段不存在，请检查后重试

(3)      调用共享平台webservice接口推送单据数据，参考SSCUtil.send()。根据接口返回结果成功(code=10)时单据SENDSSCFLAG字段赋值1同时插入操作，失败时记录日志

 

3.4.2  注意事项

按钮可用时机

推送结果：code=10代表推送成功，其他或code为空代表推送失败

 

3.5    SSC操作反馈接口

开发操作反馈接口供共享平台调用

3.5.1  功能描述

1. 接口格式：http://10.2.12.159:9797/cfasserver/anon/cfasfo/ssc/back

2. 报文以json格式传输

3. 接口逻辑：

(1)      解析共享平台报文

(2)      获取租户名称和单据编号，加载单据模型

(3)      获取报文RTNCODE参数值

①     S:支付成功/复核完成。支付成功回写源单支付完成标识=1,复核完成回写源单SSCFINISHFLAG=1

②     F:共享驳回，云报账接收到共享驳回反馈信息时判断报文是否重走工作流参数
1.提单人重走工作流： 单据状态BILLSTATE 修改为0（已保存） SSCREJECTFLAG 修改为 1（共享驳回重走工作流） 
2.提单人不重走工作流： SSCREJECTFLAG 修改为 2（共享驳回重走工作流），通过“推送SSC”按钮重新入池

(4)      根据反馈报文字段名称和参数值回写源单单据信息（相同字段默认回写赋值，排除系统字段）

(5)      共享平台反馈页签固化配置信息：（处理不区分大小写，配置建议配置大写）

①     固化必须配置：BILLCODE、TENANTNAME、UNITTITLE

②     配置可选项：PAYFINISHDATE、VOUCHERDATE、VOUCHERCODE

③     其他配置项：相同字段默认回写

(6)      根据操作类型（支付成功，复核成功，共享驳回）调用接口SSCTaskHistoryService往SSC操作记录日志表SSC_TASK_HISTORY中插入一条记录

3.5.2  注意事项

共享平台反馈信息参数配置必须包含租户标识tenantname、单据编号billcode

其他业务字段按需要配置添加

共享驳回是否重走工作流选项。共享驳回时可选项：（提单人重走工作流 + 提单人不重走工作流）
                   1.共享平台调整放开提单人重走工作流选项可用。
                   2.共享平台共享驳回操作反馈报文增加提单人是否重走工作流参数。

 

4        单据表设计

4.1     单据业务表FO_XXBILL（增加固化字段）

 

字段标识	字段说明	类型	关联属性	备注
系统字段
SSCSENDFLAG	共享推送标识	INTEGER		初始默认为0 0  未推送 1  已推送
SSCFINISHFLAG	共享审批完成标识	INTEGER		初始默认为0 0 待共享审批 2共享审批通过
SSCREJECTFLAG	驳回标识	INTEGER		0 正常状态（初始值） 1 共享驳回重走工作流 2 共享驳回不重走工作流 3 支付驳回
PAYFINISHFLAG	支付完成标识	INTEGER		初始默认为0 0 未支付完成 1 支付成功
PAYFINISHDATE	支付完成日期	TIMESTAMP
VOUCHERFLAG	生成凭证标识	INTEGER		初始默认为0 0 未生成凭证 1 生成凭证
VOUCHERDATE	生成凭证日期	TIMESTAMP
VOUCHERCODE	凭证号	VARCHAR（60）