TreeviewCopyright © aleen42 all right reserved, powered by aleen42
进项受票注意事项
1 接口功能介绍
【】括住的文字对应接口文档中的接口名称
1.1 非全票种与全票种区别
- 非全票种指的是增值税发票,需要查验之后才能进台账
- 全票种指的是所有类型的发票,除增值税以外的发票不查验也能进台账
1.2 采购与报销的区别
- 不同的业务标识,在税务云的后台系统中有关于业务标识的筛选
1.3 上传报销台账接口调用顺序
- 非增值税发票:1:【OCR识别接口】 2:【识别结果保存台账】;
- 增值税发票:1:【OCR识别接口】 2:【查验并缓存】 3:【从缓存提交保存到报销台账】。(2、3接口也可以替换为【纸票查验进报销台账】,看具体业务场景);
- 电子发票上传:【报销台账发票上传返回全票面信息(PDF)】,此接口包含pdf解析、查验、查重、提交台账操作;
- 如果使用了第三方的查验,不需要再查验,则直接调用 【不需要查验进入台账】;
1.4 上传采购台账接口调用顺序
- 增值税发票(只有增值税的发票才能进采购台账):1:【OCR识别发票】 2:【采购查验并缓存发票】 3:【从缓存保存到企业采购台账】;
- 电子发票上传:【采购台账发票上传】, 此接口包含pdf解析、查验、查重、提交台账操作;
- 如果使用了第三方的查验,不需要再查验,则直接调用【采购台账不查验进入台账】;
2 问题整理
2.1 查验并缓存接口返回未经授权?
- 测试环境:查验并缓存相关接口的appid每月都会更新,不允许客户一直使用。
- 生产环境:提dsp工单,提供购买产品的截图等相关信息,找运营人员开通权限。
2.2 检测税盘是否在线接口为什么返回检测失败
- 测试环境返回“检测失败”则证明接口已调通
- 生产环境检查税盘是否正常连接
2.3 ocr识别接口报base64解析失败是什么原因?
- 图片转base64有问题,base64转码工具类用代码示例里提供的,不支持识别pdf文件
2.4 ocr识别接口(个人票夹)、ocr识别接口v2(个人票夹)、ocr识别接口(报销台账全票种)、ocr识别发票(采购台账)这四个接口的区别是什么?
- a.业务上支持票种的类型没区别,都是全票种的图片识别接口,都不具备查验功能
- b.业务上有用户群体的区分,前两个是个人票夹的识别,需要传用户信息,后两个不需要
- c.都会返回一个税务云分配的图片路径id(imageId),以便于后续的操作
- d.功能方面,【ocr识别接口v2】可支持返回大小图的选项,进行压缩处理
- e.都不支持识别pdf,可将pdf文件拍成照片进行识别(不推荐),但是在发票类型方面有一定的识别误差,比如少量不常见的特殊种类发票识别为other,例如非税发票
2.5 报销台账发票上传返回全票面信息(PDF)具体支持哪些发票种类的pdf?
- 对增值税种类识别度最高,支持大部分机打类,少部分的医院门诊类、财政非税类。具体特殊情况需要提工单反馈给研发人员,研发人员核实后,会持续升级该接口识别能力
2.6 报销台账查询附件(全票种)、采购台账附件查询接口 两个接口的功能介绍
- a.由于报销台账以及采购台账合并为进项业务台账,这两个接口都能查询增值税的发票信息(最好各用各的),除了增值税以外的只能用【报销台账查询附件(全票种)】查询
- b.都是返回发票列表,点击操作按钮,可查看发票以及下载附件。具体如图:
- c.返回地址样例:https://yesfp.yonyoucloud.com/ent-views/fpView/viewInvoiceList.html?corpid=caa39a10-0a61-4c0e-9838-8923a730eaa6&viewid=681297f8-f53f-4958-bcdc-3c4884f88ae1, 每此请求返回的viewid都会改变。该地址为临时链接,实际有效时间为30分钟
附件为pdf情况
附件为图片情况
无附件情况
2.7 采购台账附件预览接口的相关能力
- a.该接口支持发票的预览,报销和采购台账都可以预览,注意billType字段传对应发票类型枚举值,没发票代码传空字符串
- b.返回单个发票的图片、pdf、表格预览页面地址。具体显示效果取决于进项电子票据中心保存的发票附件是什么类型
- c.返回的预览页面只能预览不支持下载附件
- d.返回地址样例:https://yesfp.yonyoucloud.com/ent-views/fpView/previewInvoice.html?viewid=6fe14bdd-02c3-4617-b10b-df56d50cce43, 每此请求返回的viewid都会改变。该地址为临时链接,实际有效时间为30分钟,但是前端提示是10分钟
2.8 采购台账如何报销、取消报销?
2.9 采购台账发票查询电票、采购台账查询(新)这两个接口有什么区别?
- a.【采购台账发票查询电票】支持查询采购台账所有类型的发票,仅电子发票可返回pdf文件流。入参可配置是否返回表体行和pdf文件流。缺点是筛选参数只有分页,查询不是很灵活
- b.【采购台账查询(新)】筛选参数包括发票代码、号码、状态、时间等等,查询灵活。缺点是没有返回pdf文件流