票据识别查验接口选择
标准接口提供三套票据识别查验方案。三套方案的主要差异是调用方式、是否直接创建系统票据,以及如何取得结果。
方案比较
| 项目 | 套件一:异步识别并创建票据 | 套件二:异步纯识别查验 | 套件三:同步识别查验 |
|---|---|---|---|
| 调用方式 | 异步 | 异步 | 同步 |
| 单次文件 | 最多 100 个附件 | 单个文件,支持一图多票和 PDF | 单个文件,最多 5 张票据 |
| 是否创建票据 | 是 | 否 | create_expense=Y 时创建 |
| 是否创建消费记录 | 是 | 否 | create_expense=Y 时创建 |
| 识别查验结果 | 查询处理进度,完成后查询票据数据 | 使用 task_id 轮询识别查验结果 |
当前识别查验请求直接返回 |
| 是否需开通子账号 | 否 | 否 | 是,使用前请联系产品开通并完成密钥配置 |
| 如需后续入库 | 无需再调创建接口 | 必须自行调用票据创建 | 传 create_expense=Y 或自行调用票据创建 |
| 推荐指数 | ★★★★★ | ★★★★ | ★★★ |
如何选择
- 批量导入并希望票据直接进入系统时,使用套件一。
- 只需要识别查验数据、不希望标准接口创建票据,或无法长时间保持同步请求时,使用套件二。
- 已开通识别查验子账号,需要立即取得结果且能接受 60 秒以上超时时,使用套件三。
通用注意事项
- 上传文件后应保证附件 URL 在任务执行期间可访问。
- 同一影像可能识别出多张票据,结果均以数组返回。
- OCR 成功不代表查验成功。请分别检查识别和查验状态。
- 需查验的票种可能因税局或第三方服务暂时异常而自动重试。
- 调用方应保留
bizId、identification_id或task_id,便于幂等控制和问题追踪。