发票云FAQ文档

1.基础税控知识

1.1税盘相关说明

航天金税盘

盘号可见税盘的正面玻璃盘下方的数字,一共14位数字,示例:44661513704280

百旺税盘

盘号可见税盘背面的数字,一共14位数字,示例:33929904881309

1.2.航天金税盘的税盘分机号、地区编码

打开航天的开票软件并登录,界面的左下角税号小数点后面的数字就是分机号,例如下图的金税盘分机号就是3,界面的左下角前6位数字就是地区编码,例如下图的税盘地区编码就是440300

1.3.什么是离线开票时长、离线开票限额?

离线发票的含义:就是开出发票还没有同步上传到税局的发票。当离线时长为0的时候,意味着不允许开具离线的发票。每开一张发票都要上传成功到税局后才能接着开下一张发票。每个税盘都有离线开票金额限制,当累计开票金额超过离线开票金额就不能开票。离线时长及离线金额可咨询当地税局,是否可以增加

航天:

百望:

2.发票云注册激活

2.1 发票云的client_id、client_secret授权信息说明

(1)client_id、client_secret为发票云应有的授权信息,在配置对接各产品时使用(如金蝶云苍穹、金蝶云星空、EAS、K3 WISE等)。

(2)激活发票云产品后,该授权信息会通过激活时填写的邮箱地址返回。若未收到激活成功邮件,请联系发票云总部实施获取。

2.2 已经拿到了百望的注册码文件,应该如何使用?

百望注册码是一个文件名为 税号+盘号.txt的文件

将文件放置在发票云组件【金蝶发票管理】的目录下,删除bwapp文件件,重启发票云组件

2.3 现在有两个税盘,但只订购了一套发票云开票产品,请问要怎么激活?

一套开票产品只能对应一个税盘,即一个cd-key与一个税盘绑定,以上情况需要再订购一套发票云开票产品

3.发票云组件【金蝶发票管理】相关问题

3.1 如何下载获取最新的发票云组件?

访问http://www.piaozone.com/download/file/list,点击发票云服务管理程序的软件下载以获取最新版本的安装包。当有版本更新时,直接启动组件即可在线更新。

3.2 发票云组件初始化安装

(1)税盘类型:根据税盘实际情况选择

(2)税盘模式:如果税盘部署在电脑PC端的一般都是单机版;

其他类似USB Key的一般都是服务器版,服务器版税盘一般都部署在专门的税控服务器上,如有疑问请与开票人员确认

(3)证书口令:

a航信单机版
航信证书密码就是在开票软件登陆界面上的钥匙小图标旁的密码

b航信服务器版
航信服务器版证书密码填写与开票软件登陆是一致的密码,即http://ip:port的模式,以下图为例填入http://192.168.8.48:8003

c 百望单机版
百望单机版税盘密码默认为88888888,如有修改请以实际为准

3.3 日志如何获取?

3.3.1发票云组件【金蝶发票管理日志】

发票云日志在发票云组件的安装目录{SETUP}/log文件夹内,日志是按类型名称+日期命名的txt文件。通常默认的安装目录是C:\Program Files(x86)\Invoice

右键点击【金蝶发票管理】-属性-打开文件位置 ,目录下的log文件夹即为日志

3.3.2航天开票软件日志

航信开票软件的日志根据税号和分机号的不同,在不同的文件目录,可按一下步骤获取
(1).获取航信开票软件的位置
从桌面上,右键点击蓝色开票软件图标,选择打开文件位置
若桌面上没有快捷方式,可以在左下角windows开始菜单内搜索regedit,并打开regedit.exe
按HKEY_LOCAL_MACHINE/SOFTWARE/Microsoft/Windows/CurrentVersion/App Paths/fwkp.exe
或HKEY_LOCAL_MACHINE/SOFTWARE/Wow6432Node/Microsoft/Windows/CurrentVersion/App Paths/fwkp.exe
路径搜索,当前税号和分机号内Path的值即使开票软件的安装位置
(2).日志文件的路径
例如税号A的开票软件安装目录为{AisinoPath},其对应的日志文件就是{AisinoPath}/Log/Log.log文件

3.3.3百望开票软件日志

百望的日志文件在发票云的安装目录{SETUP}内,位置一般是{SETUP}/bwapp/_skpclog或{SETUP}/bwappsrv/_skpclog

3.4.提示“初始化控件失败”、“开票软件被篡改或其他非授权程序正在调用开票软件!”

(1).打开航天信息软件,通过登录界面查看开票软件版本号,如截图

(2).找到【金蝶发票管理】目录下的patch文件夹,管理员运行与开票软件版本对应的程序,如遇安装失败,请重启电脑后直接安装

(3).如patch文件夹中无对应版本的程序,请通过以下链接获取

3.5.提示"证书密码错误,您还有XX次重试将会"或"税控密码错误 DiskErr-3"

打开发票云组件的设置界面,选择税盘设置修改密码。密码填写请参考(3.2--证书口令)

税盘密码错误次数超过次数时会锁盘,请与相关财务人员确认密码,谨慎填写

3.6.提示“操作失败,需要操作员权限”

(1)将税盘USB口换到机箱后面板以确保 税盘供电正常,重启发票云组件。
(2)若步骤1还是不能解决,打开航天的开票软件做下发票修复。再重启发票云组件。

3.7.提示"通讯设备异常"

(1)重插税盘,确认右下角是否有蓝色钥匙图标。
(2)登录下航天开票软件是否登录成功。
(3)若步骤2成功,退出航天开票软件。重启发票云组件

3.8提示“TCD_11112_21,获取证书信息失败”

(1)确认已注册激活发票云开票产品,并根据邮件指引申请了开票注册码(务必确认)

(2)双击打开开票软件,找到开票软件的bin目录,各环境安装开票软件的目录、分机号各不相同,以实际为准。

目录下有JP60ES_+税号+分机号.RFHX的文件,说明开票注册码获取成功,如果出现KP60JS的文件,需要删除,保证目录下仅保留一个RFHX文件,然后重启【金蝶发票管理】组件

(3)处理完成后仍有问题,按照3.4步骤操作

4.发票开具

4.1.开票或获取金税盘信息时,提示"查无此客户端,推送失败"

(1)检查是否安装并启动开票组件【金蝶发票管理】

(2)长链接地址配置有误,请按照以下方式配置:

https://wss.piaozone.com/bill-websocket/invoicewebsocket/push?name=client_secret+税盘号,如:

client_secret:vc6jkk0apm3x1mbmd1x90,

税盘号:446698691123131(航天、百望税盘号说明可参考1.1)

那么长链接地址为:

https://wss.piaozone.com/bill-websocket/invoicewebsocket/push?name=vc6jkk0apm3x1mbmd1x90446698691123131

4.2.为什么提示“1010-注册失败,未找到匹配的注册码文件”?

(1)首先确认已提交注册码申请,并成功申请注册码。注册码申请表格在产品激活成功的邮件中

(2)在开票软件的目录下,找到注册码文件

注册码文件如上,文件名构成一般为:注册类型税号分机号地区编码注册码有效期.RFHX
仔细核对注册文件的税号、分机号、地区编码是否与税盘实际使用的匹配;如不匹配,发票云组件在开票时会报错

可按照3.8步骤(2)处理

4.3.开票或获取金税盘信息时,弹窗提示"请插入税控设备......"

(1)检查发票的发票云组件版本,若安装了发票云旧组件【发票云服务管理程序】,卸载并重启电脑。对应的程序名称为PwyInvoice version V1.0.150XXXX

(2)安装并启动新组件程序,下载地址http://www.piaozone.com/download/file/list

4.4.提示“未检测到有效的电子发票订单”

电子发票开具失败,纸电一体签章未申请或申请失败。请找到当时激活发票云产品的链接,查询签章申请的情况。如当前状态显示为“已激活,未申请签章”,点击进入申请界面,按照提示要求,完成电子签章申请。

4.5.提示“离线开票时间超限/离线累计金额超限”

(1)打开航天信息开票软件,点击发票修复

(2)在开票软件发票查询中,查看是否存在状态为“报送中”“报送失败”等的发票。若存在,点击发票,手动上传

(3)离线原因可查看1.3

4.6.为什么使用百望税盘通过发票云开具的发票,在百望开票软件中查询不到?

通过发票云开具的百望单机盘发票,必须使用管理员账号登陆开票软件并执行发票修复才能在开票软件中查询到

4.7 专票红冲时,申请红字信息表提示金额超限

金额超限意味着发起的红字信息表金额超过了原蓝票的从金额,或者这张蓝票之前已经申请过对应的信息表了,可先按4.6方法操作修复信息表后确认是否之前已申请过,如果已经有对应的申请表,可以直接把申请表编号填入erp对应输入框中进行红冲

4.8提示"SSl PostFile错误 SslCode:-10007 SslError:connect error. IP地址或端口号可能不对“

打开百望开票软件,找到服务器地址、服务器端口,将该信息维护至【金蝶发票管理】组件的税局地址、税局端口处,如下图:

4.9开票时报错,“9002-[发票开具] 税收分类编码校验失败!并非每行商品都有“税收分类编码”信息”,"开具的税收分类编码为汇总项"

1.检查ERP、对接的业务系统中物料属性维护的税收分类编码

(1)正确填写19位税收分类编码(不是21位)

(2)税收分类编码状态是“可用的”、“非汇总项”

(3)税收分类编码版本尽量使用最新的,经常出现税收分类编码是使用新的,但税收分类编码版本是旧版本的情况。

2.可以通过发票云日志定位问题,找到报错的记录,查看参数"bmbb"(编码版本)、"ssflbm"(税收分类编码),满足以上说明的税收分类编码参数的要求。

如下图,14.0版本下无此编码,升级税收分类编码或在该版本下找到可用编码即可。

4.10 提示“超过离线开票限定张数09d120”

原因可参考1.3,解决方法登录百望开票软件,点击发票修复

5.发票查验

发票云发票查验结果与【国家税务总局全国增值税发票查验平台】保持一致,如有疑问可登陆查验平台验证
https://inv-veri.chinatax.gov.cn/index.html

5.1.查验结果为什么显示“查无此票”或“所查发票不存在”?

(1)输入的查验项有误;
(2)查询的发票开票日期距当前日期超过1年;
(3)由于开票方离线开票,发票数据未上传至税务局;
(4)查验平台无此发票。
可根据以上四项说明逐一核对,一般(3)出现的可能性较大。
税局系统更新、维护会造成发票无法上传,开票方网络异常等原因也会造成发票离线开具。麻烦耐心等候,待发票上传税务局即可查验

5.2.为什么提示“超过该张发票当天查验次数(请于次日再次查验)!”?

税局规定每天每张发票可在线查验次数为5次,超过次数后需次日再进行查验操作

5.3.为什么提示“发票信息不一致”或“查询发票不规范”?

不同的发票类型对于查验的数据要求不同(如增值税普票发票查验要素为发票代码、发票号码、发票日期、校验码后六位;

增值税专用发票查验要素为发票代码、发票号码、发票日期、不含税金额),请保证查验的数据准确性。
如果是使用发票云发票助手通过PC端上传图片、PDF或微信小程序拍照等功能出现该提示,有可能是上传的发票图片不清晰,导致识别的数据有误,查验失败。PC端或移动端可点击【编辑】按钮,核对OCR识别的数据与上传的发票信息是否一致,修改错误识别的信息,重新上传。

5.4.为什么提示“图片包含疑似串号发票,串号发票XXXXXXX”?

发票云识别取的数据为发票打印的发票号码、发票代码,当打印的代码号码与纸张原始的代码号码不一致,就会有串号提示

5.5.为什么提示“查验异常1002、1006”,“当前税局网络不稳定,请过段时间再试”?

部分地区税局更新或网络异常导致查验失败,建议稍后再试或关注税局网站了解最新公告

5.6.发票云可以收取哪些类型的发票?可以查验的发票种类是哪些?

发票云支持以下票种:

1.普通电子发票2.电子发票专票(暂无)3.普通纸质发票4.专用纸质发票5.普通纸质卷票7.通用机打8.的士票9.火车票10.飞机票11.其他12.机动车.13.二手车14.定额发票15.通行费16.客运发票17.过路过桥费18.车船税发票(专票)19.完税证明 20.轮船票 21.酒店账单

其中,可查验发票的类型与税局查验平台一致,可登录该地址查看:

https://inv-veri.chinatax.gov.cn/index.html

其余票种不属于查验范围,仅通过OCR识别返回票面信息。飞机票、火车票等无法查验真伪就是此原因

5.7点击【选择发票】按钮,提示“发票云请求出错,请联系管理员”

解决方法:

服务端刷新后,打开apusic.log.0日志文件,搜索关键字userKey找到最新的操作记录

1.如日志提示“非法的客户id”

(1)确认需连接的发票云环境

正式环境:www.piaozone.com

测试环境:www.piaozone.com/test (上图为测试环境,如EAS费用报销文档所述,连接测试环境需在指定目录下替换该xml文件*\eas\server\properties\cpbc_invoice_config.xml)

(2)确认发票云配置授权信息(client_id,client_secret)正确填写,检查是否存在空格、授权信息错填等情况

2.日志提示“unKnowHostException: www.piaozone.com”

针对一些企业网络环境限制的情况,需要单独开通发票网络权限的企业,发票云服务对应域名和服务以下:

如果可以直接开通一级域名*.piaozone.com的80和443端口网络权限即可

正式环境

发票云官网: expense.piaozone.com和piaozone.com

接口地址: api.piaozone.com

静态资源: img-expense.piaozone.com和img.piaozone.com

推送服务: wss.piaozone.com、link.piaozone.com

发票资源:api.kingdee.com

测试环境

发票云官网: test-expense.piaozone.com

接口地址: api-dev.piaozone.com

静态资源: imgshow-master.piaozone.com

推送服务: wss.piaozone.com、img-expense.piaozone.com、img.piaozone.com、link-test.piaozone.com

发票资源:api.kingdee.com

5.8为什么发票助手的发票列表中,发票显示的是底账数据,不是发票原件?

如果用户通过发票助手采集发票的方式为【手工录入】、【扫描发票二维码】,发票云是会通过解析得到的数据生成一个发票底账模板。只有通过【拍照】、【扫描】等方式上传原件的方式,才会显示原始影像数据。