进项受票注意事项

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 报销台账查询附件(全票种)、采购台账附件查询接口 两个接口的功能介绍

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 采购台账如何报销、取消报销?

  • 由于报销台账以及采购台账合并为进项业务台账,所以采购台账的报销、取消报销可以使用报销台账(全票种)目录下的【台账报销】、【台账取消报销】接口
    报销取消报销.png

2.9 采购台账发票查询电票、采购台账查询(新)这两个接口有什么区别?

  • a.【采购台账发票查询电票】支持查询采购台账所有类型的发票,仅电子发票可返回pdf文件流。入参可配置是否返回表体行和pdf文件流。缺点是筛选参数只有分页,查询不是很灵活
  • b.【采购台账查询(新)】筛选参数包括发票代码、号码、状态、时间等等,查询灵活。缺点是没有返回pdf文件流
Copyright © 用友 -【生态技术部】 2022-2023 all right reserved,powered by Gitbook修订时间: 2024-02-02 12:53:37

results matching ""

    No results matching ""