目的

因财务孪生在自身版本迭代、多集团推广及历史项目升级过程中需要将已经存在的历史单据和发票及订单数据做财务孪生的信息刷数处理，所以本文档目的是详细的说明历史刷数的设计原理，常见表说明、日常操作说明及出现问题时的排查方法，同时介绍了手工指定补尝方法的操作步骤。

适应人员

本文档适应产品和项目开发人员，测试人员、实施人员及对财务孪生历史数据刷新机制感兴趣的人员。

基本设计思路

财务孪生历史数据刷新有两部分，第一部分是把未报销的发票和订单中的财务孪生字段分别刷新，涉及发票表【zfs_op.op_all_ticket】和订单表【zfs_op.op_bill_order】；第二部分是把已经提交的历史单据和单据关联的发票及订单的财务孪生信息刷新到财务孪生信息的中间表中，涉及财务孪生信息表【zfs_boe.zfs_boe_invoice_twin】财务孪生信息明细表【zfs_boe.ZFS_BOE_INVOICE_TWIN_DETAIL】。

以上涉及表中将与本次刷数相关的字段如下：

zfs_op.op_all_ticket表影响字段:

列名	类型	非空	注释
BUS_OCCURRENCE_ADDRESS	VARCHAR2(1024)	FALSE	费用发生地点-详细地址-高德返回
LOCATION	VARCHAR2(64)	FALSE	费用发生地点-经纬度
ARRIVE_CITY_ID	VARCHAR2(64)	FALSE	费用发生城市-城市表id
BUS_OCCURRENCE_DATE	VARCHAR2(64)	FALSE	费用发生日期
TWIN_ADDRESS_ID	VARCHAR2(64)	FALSE	关联场所表id,（手选需要清空该字段）
TRANSACTION_CONTENT	VARCHAR2(512)	FALSE	交易内容
TRANSACTION_TYPE_ID	VARCHAR2(64)	FALSE	交易分类(ID)
MATCH_FLAG	VARCHAR2(1)	FALSE	精准匹配标签:0:精确匹配,1兜底匹配
START_OFF_CITY_ID	VARCHAR2(64)	FALSE	出发城市
CARRIER_CODE	VARCHAR2(64)	FALSE	承运方编码
INTE_COMPANY_CODE	VARCHAR2(64)	FALSE	常见互联网公司编码
BUS_OCCURRENCE_CITY_ID	VARCHAR2(64)	FALSE	费用发生城市
GOOD_SERVICE_CLASSIFY_CODE	VARCHAR2(64)	FALSE	商品服务分类
DEPT_ID	VARCHAR2(64)	FALSE	部门id
SELLER_NUMBER	VARCHAR2(64)	FALSE	销方税号
SELLER_NAME	VARCHAR2(200)	FALSE	销方名称
BUYER_NUMBER	VARCHAR2(64)	FALSE	购方税号

zfs_op.op_bill_order表影响字段:

列名	类型	非空	注释
BUS_OCCURRENCE_ADDRESS	VARCHAR2(1024)	FALSE	费用发生地点-详细地址-高德返回
LOCATION	VARCHAR2(64)	FALSE	费用发生地点-经纬度
BUS_OCCURRENCE_DATE	VARCHAR2(64)	FALSE	费用发生日期
TWIN_ADDRESS_ID	VARCHAR2(64)	FALSE	关联场所表id,（手选需要清空该字段）
TRANSACTION_CONTENT	VARCHAR2(512)	FALSE	交易内容
TRANSACTION_TYPE_ID	VARCHAR2(64)	FALSE	交易分类(ID)
MATCH_FLAG	VARCHAR2(1)	FALSE	精准匹配标签:0:精确匹配,1兜底匹配
CARRIER_CODE	VARCHAR2(64)	FALSE	承运方编码
INTE_COMPANY_CODE	VARCHAR2(64)	FALSE	常见互联网公司编码
BUS_OCCURRENCE_CITY_ID	VARCHAR2(64)	FALSE	费用发生城市
GOOD_SERVICE_CLASSIFY_CODE	VARCHAR2(64)	FALSE	商品服务分类
SELLER_NUMBER	VARCHAR2(64)	FALSE	销方税号
SELLER_NAME	VARCHAR2(200)	FALSE	销方名称
BUYER_NUMBER	VARCHAR2(64)	FALSE	购方税号
BUYER_NAME	VARCHAR2(200)	FALSE	购方名称

zfs_boe.zfs_boe_invoice_twin表

此表为新加表，需要关注是否存在记录，和记录行的所有字段

zfs_boe.ZFS_BOE_INVOICE_TWIN_DETAIL 表影响字段:

此表为新加表，需要关注是否存在记录，和记录行的所有字段，他是上面zfs_boe.zfs_boe_invoice_twin表的子表。

基本数据处理流程如下：

图数据库关系刷新：

从V1.6开始我们开始引入图数据库记录关系数据，V1.6版本的关系图设计如下：

财务孪生图数据库引入-概要设计

本次V1.6版本只记录了3类关系，1、公司与交易对手（销售方）；2、人员与交易对手；3、及提单时分滩行核算主体法人与销售方的关系

前提条件

刷新历史数据必须满足几个条件，每一个条件都影响一定的范围

序号	条件	未达条件影响范围说明	检查方法	开启方法	是否必要条件
1	集团必须开启财务孪生的参数	所有刷新逻辑不执行	方法： 1、打开移动端是有地图展示页面 2、登录后查看请求接口返回true,见图：	联系运维管理人员开启，具体操作方法见部署文档登录-TAPD见【七、1】章节内容	是
2	人员必须先维护【常用办公场所】	人员的发票和单据不会执行刷新	个人检查：移动或PC端登录后，在个人信息查看【常驻办公场所】字段是否维护值。管理员检查：在组织数据->员工信息维护页面，查看员工的【常驻办公场所】字段是否维护值。	个人自行维护或者管理员统一维护	是
3	单据类型需要打开财务孪生开关	单据及单据对应的发票和订单不会刷新	在单据类型维护页面，点编辑，找到【是否财务孪生】字段	页面操作开启	可选

日常操作场景

财务孪生操作场景参考上线操作手册

财务孪生-上线准备及操作手册

问题与故障排查

刷数的时间与要刷新的发票订单和单据的数据量有关系，一般情况第一次执行可能需要30分钟左右，正常的情况下在定时器可以看到执行成功的提示：

如果发生错误可以通过下面的SQL检查人员刷新情况：

select count(1),v.TWIN_PROCESS_FLAG from zfs_sys.sys_emp v WHERE

GROUP_ID =(SELECT id FROM SYS_GROUP WHERE code_no='XY' ) group by v.TWIN_PROCESS_FLAG

返回结果：

TWIN_PROCESS_FLAG 字段如果为空表示不需要刷新的数据（或者是没有维护常驻场所），为 1 表示待刷新；为 2表示存在部分失败；为 3表示全部成功；上图表示已经18个待刷新用户，17个已经刷新完成，1个待刷新。

对于部分失败的用户可以根据人员表EMP ID 通过下面的SQL查出哪一些单据或者是发票失败：

select itr.* from zfs_boe.init_twin_record itr where itr.emp_id='b6df664d-7ee0-495b-ac00-2417a733ba0d'

and itr.SUCCESS_FLAG!='Y'

上面的SQL可查出一个人下面出错的记录，对于这一部分出错的数据可以下面的异常处理动作重新执行（解决报错问题之后）。

异常情况处理：

考虑到我们不能一直重复刷数，所以执行一次之后会记录刷新的状态，下一次定时器将不在执行这一部分数据。如果发生错误需要根据上面的排查方法找到具体原因，并解决问题之后重新刷新，我们在程序设计上已经考虑了重复执行刷新的场景，如果发生错可以尝试选择性的重复执行刷新，下面列出了各类型可能重复执行的场景。

以下场景暂时只面向开发人员，需要使用到apifox工具，并需要有接口权限的人员帐号通过apifox调用登录接口后方可使用。

1. 指定人员或者是集团重新刷新上一次出错的记录数据

2. 重刷指定人员未刷新的数据

3. 强制重刷指定人员的数据

调用上面的接口，把isReInitFlag 参数改为 1即可。

财务孪生历史数据刷新说明

财务孪生历史数据刷新说明

关于作者

目录