TreeviewCopyright © aleen42 all right reserved, powered by aleen42
个人票夹注意事项
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端嵌入的个人票夹页面只有发票列表,可进行数据筛选,勾选,附件下载。