常见发票下载失败问题解决

目录

1 发票下载介绍
2 EAS与发票云服务交互图
3 常见下载失败场景及提示
3.1 金税互联设置未正确维护
3.1.1 报错提示：未设置金税互联参数，请先设置好金税互联相关参数
3.1.2 报错提示：非法的客户ID，请联系管理员
3.1.3 报错提示：签名认证不通过
3.1.4 报错提示：发票查询传入数据错误
3.2 无网络访问权限
3.2.1 报错提示：访问超时，请检查金税互联设置或网络连接是否正确。
3.3 发票云组件未识别到正确税盘信息
3.3.1 报错提示：打开设备--未插USBKEY(0xA7)
3.3.2 报错提示：登录过程1校验失败，返回结果数据格式异常
3.4 发票云官网问题
3.4.1 报错提示：网络繁忙
3.5 发票归集错误
3.5.1 报错提示：发票下载0张
3.5.2 其他问题：EAS的发票下载数量与税局数量不符
3.5.3 其他问题：EAS的发票下载勾选确认状态与税局状态不符

1 发票下载介绍

EAS客户端下载发票是通过发票云服务进而从发票云官网或者税局获取发票数据，然后EAS对获取的发票数据解析入库并匹配公司与往来户。所以EAS下载发票需具备两个重要的条件：一是EAS客户端拥有访问发票云的网络权限，二是客户下票组织已购买发票云服务从而拥有发票授权码。

发票云官网下载发票：发票云会定期从税局下载发票存储在发票云服务中，所以EAS通过发票云官网接口可下载到发票。

税局下载发票：EAS可通过发票云组件实时直接向税局请求下载发票，但是从税局只能申请下载增值税专用发票，无法下载增值税普通发票。

2 EAS与发票云服务交互图

如上图，EAS下载发票，首先需找到下票组织的金税互联设置，进而获取金税互联设置中的发票云授权信息去请求其维护的http地址，金税互联设置的请求地址支持http、长链接以及软证书（默认发票云官网）。

EAS对请求返回的发票数据进行解析入库并记录金税互联日志，界面下载结果提示入库成功发票张数及其对应入库组织。如获取发票数据失败或者入库失败，下载界面将给出失败提示。

3 常见下载失败场景及提示

EAS与发票云交互过程中，任一环节不满足条件则会导致发票下载失败，EAS下载界面和金税互联日志会给出相应的提示，我们可根据提示排查问题的原因，下面罗列常见的下载失败场景及常见报错信息。

3.1 金税互联设置未正确维护

3.1.1 报错提示：未设置金税互联参数，请先设置好金税互联相关参数

问题分析：下票财务组织没有维护金税互联设置或者金税互联设置被禁用了。

解决方式：维护并启用下票财务组织的金税互联设置。

3.1.2 报错提示：非法的客户ID，请联系管理员

问题分析：金税互联设置的发票云ID维护有误

解决方式：检查金税互联设置的发票云ID维护是否遗漏，首尾是否多余空格，发票云ID由发票云提供。

3.1.3 报错提示：签名认证不通过

问题分析：金税互联设置的发票云秘钥维护有误

解决方式：检查金税互联设置的发票云秘钥维护是否遗漏，首尾是否多余空格，发票云秘钥由发票云提供。

3.1.4 报错提示：发票查询传入数据错误

问题分析：金税互联设置的发票云加密秘钥维护有误

解决方式：检查金税互联设置的发票云加密秘钥维护是否遗漏，首尾是否多余空格，发票云加密秘钥由发票云提供。

3.2 无网络访问权限

3.2.1 报错提示：访问超时，请检查金税互联设置或网络连接是否正确。

问题分析：

1、EAS的金税互联设置中http地址维护有误，EAS无法访问到该地址

解决方式：检查金税互联