个人票夹注意事项

1 接口功能介绍

【】括住的文字对应接口文档中的接口名称或者字段名称

1.1 OCR识别接口和OCR识别接口V2的区别

  • 都具有提取图片中的文字内容功能
  • 都支持识别多张发票的功能
  • 都不具有查验功能
  • 后者比前者多一项返回图片大小的设置,会将图片压缩返回

1.2 个人票夹新增接口

  • 提交发票数据到个人票夹,该接口没有查验功能;
  • 如果参数传了ocr接口返回的图片id【imageId】,将会自动保存通过ocr识别的图片文件;
  • 【imageContent】与【imageId】互斥,二者只需传其中一个即可。【imageContent】只支持图片格式文件;
  • 经过ocr识别之后,新增接口字段一定要传全面些,否则会报错,比如【hjje】、【gmfNsrsbh】、【xsfNsrsbh】。

1.3 Ocr接口图片预览、个人票夹附件预览、个人票夹附件下载的区别

  • 【Ocr接口图片预览接口】与【个人票夹附件下载接口】成功时返回二进制流,查询失败或者文件不存在均返回json格式数据
  • 【个人票夹附件预览】无论查询成功与失败都返回json格式的数据,成功时datas中有Base64编码,其它情况没有datas该属性
  • 返回文件类型支持pdf、png、jpg,如何判断文件类型,可参考代码示例中的VerifyFileType类的getFileTypeByByte()方法

1.4 修改发票状态

  • 该接口可以将发票状态修改为任何状态,不受限制,请结合业务实际情况使用

1.5 根据号码代码获取信息

  • 该接口返回了发票的明细信息

1.6 个人票夹列表查询、个人票夹票据详情查询

  • 【个人票夹列表查询】接口返回信息不包含发票明细信息,获取发票明细信息需要调用【个人票夹票据详情查询】接口
  • 【个人票夹票据详情查询】接口不支持批量查询

1.7 提交至企业台账、个人票夹发票提交到采购台账的区别

  • 都是通过个人票夹的方式将发票提交至台账,前者提交到报销台账,后者提交到采购台账
  • 都内含发票查验功能,以及合规校验

2 对接场景

  • 业务系统对接个人票夹主要分为两种方式:一种是业务系统对接openApi接口,需要自行开发页面;另一种是嵌入个人票夹页面或者单点跳转到票友记,不需要再开发页面

2.1 对接openApi接口(需要开发页面)

2.1.1个人全票种

  • 通过手机号或者邮箱查询票夹信息,是标准openApi对接产品

2.1.2个人票夹后台对接

  • 特殊场景对接案例,必须进行和税务云账户绑定,查询只需要验证token。不需要邮箱或者手机号,很少有场景应用到

2.2 嵌入个人票夹页面或者单点跳转到票友记(不需要开发页面)

  • 参考最佳实践场景4
  • 访问https://yesfp.yonyoucloud.com/cas/login 通过个人用户登录可查看票夹页面。如果忘记密码,修改密码时默认验证码为666666 pc端个人票夹页面
  • 该页面不包含单独查验、新增发票等功能,只有发票列表、附件查看等功能,点击确定可通过监听中的回调方法获取到选中的数据信息,然后做其它相应的操作

3 问题整理

3.1 调用新增票夹接口必须首先要调用ocr识别接口吗?

  • 非必须,这里支持使用其它第三方图片识别接口,然后再将结构化数据通过新增票夹接口上传到个人票夹

3.2 企业微信或者钉钉对接个人票票夹,用户信息初始化到哪里了?

  • 用户信息同步到友户通,不提供默认密码,需要到pc端登录页面->个人用户->忘记密码进行重置

3.3 个人票夹附件预览接口是否有图片不存在的情况?

  • 有这种情况,返回信息{"code":"1002","msg":"没有找到对应的票据摘要信息"}

3.4 票友记app添加发票到个人票夹自带查验功能,为什么pc端嵌入的个人票夹页面没有查验功能?

  • pc端嵌入的个人票夹页面只有发票列表,可进行数据筛选,勾选,附件下载。
Copyright © 用友 -【生态技术部】 2022-2023 all right reserved,powered by Gitbook修订时间: 2024-02-02 12:53:37

results matching ""

    No results matching ""