查询接口常见问题及解决方案
预计阅读时间: 19 分钟下表列出了在接口调用中出现的错误信息，以及对应的解决办法。
| 报错信息 | 原因 | 解决方法 |
|---|---|---|
| “code”:1,”message”:”需要操作员权限！” | 云助手运行异常 | 1：关闭开票云助手；2：以管理员方式运行云助手； |
| “code”:1,”message”:”TCD_3001_5” | 云助手与税盘通讯异常 | 1.税盘是否移动过，重新插拔税盘并重启云助手;2.使用管理员权限运行云助手；3.USBROOT关闭电源自动关闭设置 |
| “code”:1,”message”:”计算签名值长度失败：你还有7次重试机会(0x381063C7)” | 客户的数字证书口令错误 | 1：数字证书口令错误，必须停止云助手，否则会造成税盘锁死； 2. 咨询当地税控服务商获取口令，或者到税局进行修改 |
| “code”:1,”message”:”计算签名值长度失败：你还有6次重试机会(0x381063C6)” | ||
| “code”:1,”message”:”计算签名值长度失败：你还有5次重试机会(0x381063C5)” | ||
| code:1,”message”:”TCD_768_5” | 离线时间超限 | 1.登录开票软件，查看是否有未上传发票，待上传完成后恢复开票即可； 2.如果离线时间小于24小时，是否可以去税务增加离线时间； |
| code:1,”message”:”计算签名值长度失败：未插USBKEY(0xA7)” | 开票软件的驱动未安装 | 重新安装开票软件即可 |
| code:1,”message”:”写入发票签名值失败：命令中的参数有错” | ||
| code:1,”message”:”INP-242104” | 发票号不足或者无电子发票票种 | 1.登录开票软件，确认是否已经增加电子发票票种 |
| code:1,”message”:”金税设备已到抄税期，请先抄税” | 月初需要先抄税再开票 | 登录开票软件，确认是否完成抄税，抄税后重新运行云助手 |
| code:1,”message”:”TCD_768_30” | 税盘离线 | 登录开票软件，查看是否有未上传发票，待上传完成后恢复开票即可； |
| code:1,”message”:”读发票领购信息失败：没有找到指定的数据” | 发票号不足或者无电子发票票种 | 1.登录开票软件，确认是否已经增加电子发票票种 |
| code:4,”message”:”数字签名错误。” | 使用瑞宏的证书签名时异常，数据异常 | 重推请求 |
| code:401,”message”:”发票不存在。” | 使用订单号作为条件查询，未查询到发票 | 发票查询接口，不使用过订单号作为条件，使用流水号查询发票 |
| code:4,”message”:”数字签名错误。” | 使用瑞宏的证书签名时异常，数据异常 | 重推请求 |
| code:1,”message”:”INP-242101” | 发票号不足或者无电子发票票种 | 1.登录开票软件，确认是否已经增加电子发票票种 |
| 购买方纳税人识别号不符合校验规则！ | 购买方的税号位数不符合税务规定 | 客户预留的税号不正确，需要修改客户所预留税号信息 |
| TCD_786_5 | 电子发票票号使用完，无可用发票号 | 1.及时到税务申请电子发票票号 |
| 离线发票累计金额超限！ | 电子发票的离线累计金额到最大值 | 登录开票软件上传发票，待发票上传完成后可恢复开票 |
| 发票开具失败，红字发票累计金额超过原蓝字发票 | 原发票已经被冲红或者部分冲红过 | 确认客户是否已经冲红原发票 |
| TCD_499_5 | 待确认 | |
| 本张发票不能开红字发票！原因：数据库中未找到对应的蓝票，且与受理平台网络不通，不能开红字发票 | 税务网络不同，无法进行冲红 | 发票的冲红接口需要税务端验证， |
| 发票开具失败：时钟芯片操作错误 | 税盘离线 | 1.登录开票软件，查看是否有未上传发票，待上传完成后恢复开票即可； 2.如果离线时间小于24小时，是否可以去税务增加离线时间； |
| 购买方纳税人识别号长度不正确！ | 购买方的税号位数不符合税务规定 | 客户预留的税号不正确，需要修改客户所预留税号信息 |
| 有票种没有完成征期抄报税，不能继续开票！ | 购买方的税号位数不符合税务规定 | 客户预留的税号不正确，需要修改客户所预留税号信息 |
| 本张发票不能开红字发票！原因：销项红字发票填开金额超过对应蓝字发票金额！本张发票填开限额：￥0.00所开发票已填金额：￥-3408.75 | 原发票已经冲红 | 原发票已经冲红成功，无需二次冲红 |
| 发票开具失败：已超过单张发票开票金额限额 | 超过发票限额，开具失败 | 订单金额大于单张发票所开限额,解决办法: 1:客户去税务局增加票种额度； 2：订单拆分为多张发票； |
| 购方名称不允许为空！ | 购买方名称为空 | 发票抬头字段为空，请核实字段后重新推送 |
| 离线开票时间超限！ | 税盘离线 | 1.登录开票软件，查看是否有未上传发票，待上传完成后恢复开票即可； 2.如果离线时间小于24小时，是否可以去税务增加离线时间； |
| 重复发票代码号码，不能继续开票 | 云助手运行异常 | 关闭云助手，重新以管理员方式运行 |
| 第1行：税率非法！ | 使用不正确的税率开票 | 税率。只能为0、 0.03、0.04、0.06、0.10、0.11、0.16、0.17。 |
| 设备通讯异常！ | 云助手与税盘通讯异常 | 1.税盘是否移动过，重新插拔税盘并重启云助手; 2.使用管理员权限运行云助手； 3.USBROOT关闭电源自动关闭设置 |
| TCD_3258_5 | 待确认 | |
| 发票开具失败！返回值为：正在进行开票，稍后请重新提交开票请求。 | 开票种 | 开票中，无需再次请求 |
| 写入发票签名值失败：权限不够！ | 开票操作权限问题 | 使用管理员方式运行云助手 |
| 发票开具失败：开票信息中的发票号码、代码不合法 | 云助手运行异常 | 关闭云助手，重新以管理员方式运行 |
| 选择发票类型026失败：权限不够！ | 发票号不足或者无电子发票票种 | 1.登录开票软件，确认是否已经增加电子发票票种 |
| 发票开具失败：权限不够！ | 开票操作权限问题 | 使用管理员方式运行云助手 |
| 读取发票明细失败：权限不够！ | 开票操作权限问题 | 使用管理员方式运行云助手 |
| code:2,”message”:”参数cmdName不正确。” | 系统异常 | 此错误为系统异常，是暂定发票查询接口所致； |
| 税控盘口令认证失败：权限不够！ | 客户配置的数字证书口令不正确 | 需要客户确认数字证书口令，然后重新配置云助手所配置的口令 |