个人票夹注意事项

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 嵌入个人票夹页面或者单点跳转到票友记（不需要开发页面）

2.2.1 第三方嵌入个人票夹web端页面

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

2.2.2 企业微信对接个人票夹（票友记）

• 参考最佳实践场景6

2.2.3 钉钉对接个人票夹（票友记）

• 参考最佳实践场景7

3 问题整理

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

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

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

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

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

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

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

• pc端嵌入的个人票夹页面只有发票列表，可进行数据筛选，勾选，附件下载。