报销单发票导入的校验接口配置指南

栏目：云星瀚知识作者：金蝶来源：金蝶云社区发布：2024-09-22浏览：1

报销单发票导入的校验接口配置指南

一、发票导入流程

①.流程图例

②.节点说明

序号	节点	说明	备注
1	发票导入开始	发票云将会返回发票采集结果json字符串
2	【二开SDK接口】发票原始信息JSON处理	发票云采集完毕，获取到发票原始json数据，二开可以在此处对发票采集的原始数据进行修正	可通过实现sdk接口进行修正，参考接口说明
3	构造费用明细Bo、发票信息Bo、发票明细Bo过程	标准导入流程
4	【二开接口】发票信息BO写入发票信息分录前置事件	二开可以在此处对发票信息Bo （InvoiceEntryBO）进行修正
5	发票信息BO 写入发票信息分录	将构造生成的发票信息BO模型写入分录
6	【二开接口】发票信息BO写入发票信息分录后置事件	二开可以在此处对界面数据模型 dataModel进行修正（建议只对发票信息分录进行修改）	可通过发票云服务商配置实现接口进行修正，参考接口说明
7	【二开接口】发票明细BO写入发票明细分录前置事件	二开可以在此处对发票明细Bo （InvoiceItemEntryBO）进行修正	可通过发票云服务商配置实现接口进行修正，参考接口说明
8	发票明细BO 写入发票明细分录	将构造生成费用明细/差旅明细BO模型写入分录
9	【二开接口】发票明细BO写入发票明细分录后置事件	二开可以在此处对界面数据模型dataModel进行修正（建议只对发票明细分录进行修改）	可通过发票云服务商配置实现接口进行修正，参考接口说明
10	【二开接口】费用明细/差旅明细BO写入费用明细分录前置事件	二开可以在此处对费用明细/差旅明细Bo （ExpenseEntryBo）进行修正
11	费用明细B/差旅明细BO 写入费用明细B/差旅明细分录
12	【二开接口】费用明细/差旅明细BO写入费用明细分录后置事件	二开可以在此处对界面数据模型 dataModel进行修正（建议只对费用明细/差旅明细分录进行修改）	可通过发票云服务商配置实现接口进行修正，参考接口说明
13	标准后置逻辑--刷新数据、刷新界面
14	【二开接口】导入发票流程后置事件	此时发票导入流程已经结束，数据已经写入单据实体并渲染界面，二开可在此处对整个单据进行操作	可通过发票云服务商配置实现接口进行修正，参考接口说明
15	【二开SDK接口】导入发票流程后置事件	此时发票导入流程已经结束，数据已经写入单据实体并渲染界面，二开可在此处对整个单据进行操作	可通过实现sdk接口进行修正，参考接口说明
16	结束

二、接口说明

1.【二开SDK接口】发票原始信息JSON处理

目前仅支持PC端

2.【二开SDK接口】导入发票流程后置事件

目前仅支持PC端

参考sdk开发指南：https://dev.kingdee.com/open/detail/sdk/1803055070749671424

3.【二开接口】发票信息BO写入发票信息分录前置事件

4.【二开接口】发票明细BO写入发票明细分录前置事件

接口	说明
kd.fi.er.business.invoicecloud.provider.service.IBeforeCreateInvoiceInfoService	创建发票分录分录前置服务

方法

参数及说明

beforeCreateInvoiceEntry

创建发票信息分录前置接口

context：导入发票上下文

dataModel：当前页面代理数据模型（只允许获取数据而无法对模型操作）

invoiceEntryBO：即将创建的发票信息模型

rowIndex：发票信息索引行

beforeCreateInvoiceItemEntry

创建发票明细分录前置接口

context：导入发票上下文

dataModel：当前页面代理数据模型（只允许获取数据而无法对模型操作）

invoiceItemEntryBO：即将创建的发票明细模型

rowIndex：发票明细索引行

5.【二开接口】发票信息BO写入发票信息分录后置事件

6.【二开接口】发票信息BO写入发票明细分录后置事件

接口	说明
kd.fi.er.business.invoicecloud.provider.service.IAfterCreateInvoiceInfoService	创建发票分录分录后置服务

方法

参数及说明

afterCreateInvoiceEntry

创建发票信息分录前置接口

context：导入发票上下文

dataModel：当前页面代理数据模型（允许获取数据和对模型操作）

invoiceEntryBO：创建的发票信息模型

rowIndex：发票信息索引行

afterCreateInvoiceItemEntry

创建发票明细分录前置接口

context：导入发票上下文

dataModel：当前页面代理数据模型（允许获取数据和对模型操作）

invoiceItemEntryBO：创建的发票明细模型

rowIndex：发票明细索引行

7.【二开接口】费用明细/差旅明细BO写入费用明细分录前置事件

接口	说明
kd.fi.er.business.invoicecloud.provider.service.IBeforeCreateExpenseItemEntryService	创建费用/差旅明细前置服务

方法	参数及说明
beforeCreateExpenseItemEntry	创建费用明细分录前置接口 context：导入发票上下文 dataModel：当前页面代理数据模型（只允许获取数据而无法对模型操作） expenseEntryBO：即将创建的费用明细模型 rowIndex：费用明细索引行
beforeCreateExpenseItemEntryForTrip	创建差旅明细分录前置接口 context：导入发票上下文 dataModel：当前页面代理数据模型（只允许获取数据而无法对模型操作） tripEntryDO：当前行程信息DynamicObject expenseEntryBO：即将创建的差旅明细模型 tripRowIndex：差旅明细索引行 parentIndex：行程信息索引行
beforeCreateExpenseItemEntryForExpensePool	创建费用池费用明细前置接口 context：导入发票上下文 dataModel：当前页面代理数据模型（只允许获取数据而无法对模型操作） expenseEntryBO：即将创建的费用明细模型

8.【二开接口】费用明细/差旅明细BO写入费用明细分录后置事件

接口	说明
kd.fi.er.business.invoicecloud.provider.service.IAfterCreateExpenseItemEntryService	创建费用/差旅明细后置服务

方法	参数及说明
afterCreateExpenseItemEntry	创建费用明细分录后置接口（请勿使用已废弃的旧方法） invoiceContext：导入发票上下文 dataModel：当前页面代理数据模型（允许获取数据和对模型操作） expenseEntryBO：创建的费用明细模型 rowIndex：费用明细索引行
afterCreateExpenseItemEntryForTrip	创建差旅明细分录后置接口（请勿使用已废弃的旧方法） invoiceContext：导入发票上下文 dataModel：当前页面代理数据模型（允许获取数据和对模型操作） tripEntryDO：当前行程信息DynamicObject expenseEntryBO：创建的差旅明细模型 tripRowIndex：差旅明细索引行 parentIndex：行程信息索引行
afterCreateExpenseItemEntryForExpensePool	创建费用池费用明细后置接口（请勿使用已废弃的旧方法） invoiceContext：导入发票上下文 dataModel：当前页面代理数据模型（允许获取数据和对模型操作） expenseEntryBO：创建的费用明细模型