网页上传¶
网页上传是最直接的入口:把发票文件拖进投递区,或者点一下选文件。
支持的格式与限制¶
| 项目 | 规则 |
|---|---|
| 支持格式 | PDF、JPG、JPEG、PNG |
| 单文件大小 | ≤ 10MB(超过会提示"超过单文件大小上限") |
| 单批数量 | 客户端按每批最多 20 个依次提交,可以一次选更多,系统自动分批 |
| 文件夹 | 支持拖入文件夹递归导入其中支持的文件;不保存目录结构 |
| 其他格式 | OFD、XML 等不支持解析的格式会直接跳过,不会上传也不会入库 |
| 空文件 | 被拒绝 |
为准确率考虑
优先传电子发票原件(PDF)。截图/拍照尽量正、清晰、完整,别裁掉票号、金额、日期、购销方这几块——OCR 认不全时,系统会提示"票面关键信息不完整"。
怎么传¶
- 把文件(或文件夹)拖进上传投递区;也可以点击投递区打开文件选择框。
- 拖拽过程中标题会变成
松开以导入;拖文件夹时显示正在读取文件夹。 - 上传时有进度条和百分比。
- 上传结束,页面用提示条告诉你结果,列表自动刷新。
上传结果怎么看¶
提示条会把每个文件的结果汇总成一句话:
| 你看到的提示 | 含义 | 该做什么 |
|---|---|---|
已提交 N 个文件,正在解析 |
全部受理成功 | 等列表刷新即可 |
N 个文件未受理:重复文件,本空间已存在 |
同一工作区里已有这个文件 | 不用管;若要重传,先删除已有那张发票 |
N 个文件未受理:仅支持 PDF / JPG / PNG |
格式不支持 | 转成 PDF/图片再传 |
N 个文件未受理:超过单文件大小上限 |
单文件超过 10MB | 压缩或拆分 |
N 个文件未受理:本月免费识别额度已用完… |
免费识别次数用尽 | 填自己的百度 OCR Key(设置 → OCR 识别) |
「xxx」此前已删除,已重新提交解析 |
你之前删过这个文件,这次等于撤销删除 | 无需操作,原记录会恢复 |
已跳过 N 个不支持的文件(仅支持 PDF / JPG / PNG) |
夹带的 OFD/XML 等被忽略 | 无需操作 |
没有发现可上传的文件 |
拖进来的文件夹里没有支持的文件 | 检查格式 |
上传之后发生什么¶
- 文件级防重:同一工作区内,同一个文件(按内容哈希)只会入库一次。
- 票号级防重:识别出票号后,同一张发票(按发票号码+代码)在全组织范围内只允许一次报销;命中时提示"该发票已报销或处理中",不会告诉你它在谁的账上。
- 失败可恢复:网络抖动、接口限流这类问题会自动退避重试(30 秒 / 2 分钟 / 10 分钟),仍失败才标记
失败并给出错误码。
解析失败怎么办¶
- 先看错误码:失败任务的提示形如
错误码:说明,常见的是 OCR 未配置、文件损坏、票据不识别。 - 可能是"这根本不是发票":系统会把非发票文件(如行程单、订单截图)自动转入附件处理,它不需要有发票号码。
- 重新上传:修正文件后重新上传即可。如果提示"重复文件",说明旧记录还在——先在发票库删除那张旧发票,再传。
关于"重试"入口
后台提供了任务重试能力(POST /tasks/:id/retry),但当前 Web 版本还没有把"解析任务面板"挂到界面上(见功能可用状态)。所以现在遇到失败,请按上面的步骤重新上传处理。
用完了免费额度怎么办¶
- 每个用户每月 10 次免费识别(按上传文件计)。
- 额度用完后,两种选择:
- 到 设置 → OCR 识别 填自己的百度智能云 OCR API Key / Secret Key(系统会加密保存,并且这个 Key 会加入共享池,让所有用户都能受益);
- 等下个月额度重置。
- 自备 Key 的用户不受免费额度限制。