星瀚费用报销集成发票云日常高频问题解决方法

1.发票云配置问题

1.1 钉钉、企业微信相关配置

问题描述：TypeError: Cannot read property 'call' of underfined，弹框提示调用发票云失败

解决方案：

检查钉钉、企业微信等对接发票云环境配置

步骤1.打开路径

开发服务云>开发平台>搜索参数：er_stdconfig>列表>预览

步骤2. 检查相关配置：

a）钉钉对接发票云环境配置

invoicecloud.app 参数值设置为：dingding 

invoicecloud.isShowInvoiceInH5 参数值设置为：true 

invokeMiniProgram 参数值设置为：false 

 b）云之家对接发票云环境配置 

invoicecloud.app 参数设置为：yunzhijia 

invoicecloud.isShowInvoiceInH5 参数值设置为：true 

invokeMiniProgram 参数值设置为：true 

 c）企业自建OA、自建APP、企业微信对接发票云环境配置 

invoicecloud.app 参数值设置为：qywx 

invoicecloud.isShowInvoiceInH5 参数值设置为：true 

invokeMiniProgram 参数值设置为：false 

 以上参数，如果不存在，就新增加上。

解决方案：
步骤1. 让网管检查防火墙、检查黑白名单，发票云的域名是否被拒绝（在容器中执行ping或curl指令可进行简单测试）如有配置代理，让网管检查代理是否配置错误.步骤2.如有配置代理，让网管检查代理是否配置错误.

1.3 提示建立连接失败/基础授权信息有误

问题描述：单据界面点击导入发票弹框提示与发票云建立连接失败及提示基础授权信息有误

问题分析：该提示为AWS发票云提示基础授权信息错误，需要检查发票云配置信息。

解决方案：

步骤1.路径：【费用核算】 -> 【发票设置】 -> 【发票云配置】 / 【发票云配置（集团）】

步骤2.找到指定费用承担公司的配置信息

步骤3.检查【费用全局配置】中发票云环境相关参数（谨慎修改）

参数值解释：dev是客户测试环境使用，sit是研发使用，生产环境需要把杠后的dev或sit都删掉。

另外，正式环境中还需要把参数invoicecloud.not_prod设置为false。

步骤4.检查发票云配置项，是否与发票云提供的配置项信息一致

1.4 提示没有发票云收票特性分组许可

问题描述：单据界面点击导入发票弹框提示没有分组许可

问题分析：该提示为星瀚发票云提示没有许可，需要检查星瀚发票云授权信息。星瀚升级到5.0后，发票云旗舰版有独立的许可文件，需要导入发票云旗舰版许可才能使用。

解决方案：

步骤1：新购客户订货必须是发票云旗舰版，企业云平台订单激活后才能获取到旗舰版许可文件。如果订货错误需要退货重订。

步骤2：老客户升级到5.0之后报错不能使用，请按文档步骤升级致旗舰版https://www.yuque.com/piaozone/implement/lggou1#PGkth，后面续费请按旗舰版订货使用 若有疑问可云之家咨询发票云交付（万微：16675579412）

2 .导入发票问题

2.1 发票号码存在，发票信息不存在这张发票

问题描述：差旅卡片式移动端第三屏按行导入后，PC端查看发票，发现发票分录缺失发票

原因分析：5.0.002以下旧版本bug

解决方案：升级到5.0.002及以上版本

2.2 是否抵扣错误

如以下步骤检查完毕扔未排查出问题，可以提单协助排查。

问题描述：

1.发票信息分录抵扣错误

2.费用明细分录抵扣错误

解决方案：

发票信息抵扣错误

步骤1.检查当前版本号，如当前版本低于4.0.020，则无法修复，建议升级5.0.011。

步骤3.当前版本号高于4.0.020，检查【费用全局参数】Invoices.credits，路径：【开发者门户】->搜索【费用全局配置】->【列表】预览->搜索Invoices.credits

步骤4.如Invoices.credits值为ture或者不存在该参数。

步骤4-1查询数据库，确认该发票对应的发票明细抵扣字段（invoiceitemoffset-finvoiceitemoffset）是否正确（可参考操作指引4.3），如明细抵扣正确则检查步骤4-2，不正确则检查步骤4-3

步骤4-2 检查【费用全局参数】invoicecloud.Deductible，路径：【开发者门户】->搜索【费用全局配置】->【列表】预览->搜索invoicecloud.Deductible

如果值为true，则表示发票信息抵扣为差旅明细/费用明细抵扣值联动修改。

步骤4-3检查发票抵扣条件，检查发票是否满足对应发票类型的抵扣条件，可根据公司业务自行修改抵扣条件。

操作：进入【开发平台】下，设置  【费用核算】-【发票设置】下的菜单【发票类型(发票云)】可见，然后进入发票类型(发票云)列表。

步骤5.如Invoices.credits值为false，打开monitor/天梯，日志搜索关键字【发票云】，找到canBeDeduction或deductionFlag字段（1为可抵扣），如抵扣错误，联系发票云项目组进行问题排查。（可参考操作指引4.1、4.2）。

费用明细分录是否抵扣错误

步骤1.检查发票分录抵扣字段是否正确，可通过查看发票信息分录抵扣字段，或者查询数据库。

步骤2.检查申请人公司系统参数【按纳税人类型判断可抵扣】，为否：所有导入的发票都默认为不可抵扣，为是，则根据发票类型&费用项目/差旅项目综合判断是否可抵扣。

路径：【配置工具】->【参数配置】->【系统参数】->【财务云】->【费用核算】->【按纳税人类型判断可抵扣】

步骤3.检查差旅项目/费用项目是否可抵扣

路径：【费用核算】->【费用项目】

路径：【费用核算】->【报销设置】->【差旅项目】

备注：发票按行导入在5.0.20版本前存在抵扣判断错误bug，抵扣发票和不可抵扣发票按行混导时，可能会导致差旅明细/费用明细抵扣判断错误。

2.3 抵扣金额/转出金额错误

问题描述：抵扣金额、转出金额错误，发票信息或费用明细抵扣税额、转出金额计算不正确

问题分析：旧版本bug

解决方案：建议升级至5.0.011版本（稳态）

2.4 单据转出金额字段补充说明

问题描述：报销单据上的转出金额与会计/税法上的增值税进项税额转出金额一致吗？

问题解答：不完全相等，与【发票云配置】中“导入不可抵扣发票”参数设置相关。

场景1：当发票云配置中“导入不可抵扣发票”为是

（费用明细与发票信息中的税率、税额、抵扣税额、核定税额、转出金额根据发票显示）

①当税额判定为不可抵扣：

抵扣税额=0，转出金额=税额。由于税额不可抵扣，但是在单据上显示，需全额转出单据。

②当税额判定为可抵扣：

（抵扣税额=税额，转出金额=0）

当报销金额核减，核定税额根据税率与核定金额计算，当系统参数“核定金额联动可抵扣”为“是”，抵扣税额=核定税额，转出金额=差额，这一场景的转出金额为税务上的进项转出金额；为“否”，抵扣税额=税额，转出税额=0

场景2：当发票云配置中“导入不可抵扣发票”为否

①当税额判定为不可抵扣：

（费用明细与发票信息中的税率、税额、抵扣税额、核定税额、转出金额都置为0）

由于税额不可抵扣，且单据上无显示，不需要转出，凭证中增值税进项取值为0。

②当税额判定为可抵扣：

同上1-②逻辑

关联知识指导：

1.是否可抵扣根据单据的“纳税人类型+费用项目/差旅项目+发票类型”判断，具体参考：如何配置抵扣方案，实现发票自动抵扣处理

https://vip.kingdee.com/article/340158960369842944?productLineId=2&isKnowledge=2

2.报销金额小于发票金额时，手动关联费用明细与发票信息（非智能发票报销），费用明细的税率、税额是否分摊？如何取值？

https://club.kdcloud.com/questions/157872305380043008/answers/157872305413597440?productLineId=2&isKnowledge=2

3.卡片式差旅报销单上，差旅明细的税率税额字段不可见，与什么配置相关？差旅项目配置中有“价税分离”的判断，若是关闭了“价税分离”。差旅报销单上的税率税额字段会默认隐藏。参考差旅项目配置：

https://vip.kingdee.com/article/229201028586180352?productLineId=2&isKnowledge=2

2.5 导入发票后差旅项目/费用项目为空

问题描述：差旅项目/费用项目为空

问题描述：智能发票报销导入生成的差旅明细/费用明细的未匹配到对应项目

问题分析：智能发票报销会根据【映射差旅项目】 / 【映射费用项目】进行匹配对应的项目，因此需要检查映射关系

解决方案：检查【映射差旅项目】 / 【映射费用项目】，查看是否存在对应的映射关系或映射关系是否满足条件，如：票种、税收分类编码，映射因素等。

路径：【费用核算】->【发票设置】->【映射差旅项目】/【映射费用项目】

2.6 导入发票报错

问题描述：导入发票报错，MappingItemWithOrgInvoiceServiceImp抛出NullPointerException

问题描述：导入发票时出现中断异常，堆栈中出现MappingItemWithOrgInvoiceServiceImp抛出的NullPointerException

问题分析：旧版本未对一些特殊边界场景进行判断拦截

解决方案：检查【映射差旅项目】 / 【映射费用项目】，查看是否存在映射关系未填写项目的情况，填写这个映射关系的项目

路径：【费用核算】->【发票设置】->【映射差旅项目】/【映射费用项目】

2.7 发票类型显示为【其他】或【数字】

问题描述：发票类型并未正确显示发票真实类型

问题描述：导入发票后，发票分录发票类型显示为【其他】或【数字】

问题分析：发票类型基础资料可能并未维护这个类型的发票。

解决方案：维护这个类型的发票类型基础资料

操作：进入【开发平台】下，设置  【费用核算】-【发票设置】下的菜单【发票类型(发票云)】可见，然后进入发票类型(发票云)列表。

发票类型具体信息可以联系费用报销项目组发票组支持人员

2.8 非智能发票报销手动关联抵扣税额转出金额错误

问题描述：非智能发票报销手动关联抵扣税额转出金额错误

非智能发票报销导入的发票手动进行关联后抵扣税额、转出金额错误，重现步骤：

 1、多条明细、一张发票（未关联）

 2、选择一条明细关联发票

 3、全选所有明细，关联发票

 4、发票信息抵扣税额、转出金额错误

问题分析：该问题为旧版本bug，未考虑多次关联的场景，导致多次关联时联动计算错误。

解决方案：升级至5.0.011版本

2.9 发票抵扣条件字段超长

问题描述：发票类型保存提示如下图：

、

解决方案：定义多个商品名称不包含xx 的条件，可以合并定义为一个条件：商品名称 “不在 … 中”，然后列举多个名称，如图

2.10 发票解绑之后，提交单据仍提示发票xxx已被报销单xx引用

问题描述：发票解绑之后，提交单据仍然提示发票xxx已被报销单xx引用：

问题分析与解决方案：费用报销和发票云集成，费用报销也会记录发票与单据的关联关系，非暂存（A）、废弃（D）、审核不通过（H）这 3 个状态的单据会占用发票。在发票云界面操作解绑之后，还需要将占用该发票的报销类单据删除，或者改为 A、D、H 状态之一。可以通过在单据上增加状态转换的操作码或者编写数据库记录更新脚本来修改状态。

2.11 发票是否连号判断错误

问题描述：实际连号的发票导入后，发票信息是否连号字段显示为否。

解决方案：

步骤:1.打开monitor/天梯，日志搜索关键字【发票云】，找到verifyresult 。

步骤2.查看字段中是否存在sequenceNum，存在就是连号，不存在就是不连号。如果日志中已经判断错误