SpringBoot3+PaddleOCR 发票识别：不接云端大模型，本地飞桨怎么把专票读进进项单

🌐 文档地址：https://ruoyioffice.com
 📦 源码1·GitHub：https://github.com/yuqing2026/ruoyi-office
 📦 源码2·GitCode：https://gitcode.com/zhouzhongyan/ruoyi-office
 📦 源码3·Gitee：https://gitee.com/yqzy1688/ruoyi-office
 💬 微信：17156169080（备注「RuoYi Office」）

财务把一张电子专票丢进对话框，指望大模型「看懂」再抄进 Excel，票号抄错一位，抵扣对不上。RuoYi Office 不走这条路。默认识别器是本地飞桨 PP-OCRv4：影像先上传，Java 把文件打到本机或云主机上的 /ocr/invoice，规则解析票号和价税，Vue3 回填进项单。人核过再保存，来源记成 OCR。票进池之后怎么占用，是另一篇文章。

▲ 左：进项录入先上传影像。中：SpringBoot3 默认 provider=model，只打 PaddleOCR。右：PP-OCRv4 出框，parser 锚票号/税号/价税，人核对后 source=20

引言：发票识别难在「读对字段」，不在「看起来智能」

进项录入要的不是一段自然语言摘要，是能入账的格子：发票号码、价税合计、销方税号。格子错了，认证和抵扣一起错。

正确的形状是：影像必传；飞桨能读就回填；读错或读空就手改；保存时 source=20 只表示「这张票曾经走过失识别」，不表示「机器说了算」。

本文只讲本地飞桨怎么把专票读进进项单。票池占用、报销挂票，见已发布的进项发票池一文。

一、产品能力与特点

进项发票是「票面要素 + 影像 + 识别来源」的一张主数据。谁用：财务在 财务 → 发票管理 → 进项发票 点「录入发票」。解决的事：少抄 20 位票号，少抄销方税号，但不取消核对。

和「只做一张开票申请」也要分开：开票申请是销项侧审批单；进项 OCR 是收票录入。客户说「发票模块」，先问开出去还是收进来。

模块就三块，点到为止：

二、业务流程怎么串

主路径只有四步：打开录入 → 上传影像 → 飞桨回填 → 人核后保存。

2.1 打开进项录入，先看到上传区

菜单进 /finance/invoice/input-invoice，点「录入发票」。弹窗上半是拖拽上传，下半是票面字段。还没上传时，「OCR 识别」不可用。

▲ 财务 → 进项发票 → 录入发票。虚线拖拽区支持 JPG / PNG / PDF，单文件不超过 20MB。没有 imageUrl，保存直接警告

状态：弹窗打开，表单空，source 还没写。

2.2 上传完成后点识别，飞桨回填格子

上传走基础设施文件服务，拿到 imageUrl。再点「OCR 识别」，请求 POST /finance/ocr/recognize，带 fileUrl 和 bizType=2（进项）。

回填这些格：发票类型、代码、号码、开票日期、销方名称、销方税号、不含税金额、税额、价税合计。购方名称、购方税号、明细行，解析结果里有，当前进项主表先不回填——避免把本公司抬头写进销方，也避免半截明细当正式分录。

识别成功会提示「已回填可识别字段」；parser 带 warnings 时改用警告，例如价税勾稽对不上。

2.3 人核票号和价税，再保存

飞桨读电子专票时，票号常见 20 位，价税合计在「小写」行。验收过的一张电子票：号码 26372000002434577806，价税合计 8999，销方税号 91370100MAC5ME3C95。CPU 节点大约 5～8 秒，不是秒回。数字对上了才能点确定。

▲ 演示进项编辑弹窗。增值税专用发票，票号、不含税 442.48、税额 57.52、价税合计 500 已回填。人还可以改，保存值才入账

状态：字段从空变成识别值，recognizedBySource=20，单据仍未落库。

2.4 保存进项，影像和来源一起留下

确定时必须带 imageUrl。后端写入 finance_input_invoice。列表能看来源：手工 10 / OCR 20。再点编辑，核对票号价税和影像是不是同一张。私有桶预览走预签名，不要把对象地址当永久公网链。

▲ 进项发票列表是入口。点「录入发票」走识别，点「编辑」核对角。来源列能区分手工和 OCR，占用不在这一页完成

状态：进项已保存。占用、票夹，不是这一步的职责。

三、设计怎么落地

3.1 设计思路

切到云端大模型要把 provider 改成 vlm，并单独配 VLM 模型。那是另一条客户端，不要和飞桨混在一个 HTTP 里。

3.2 表结构

支撑闭环的只有三张表。票池没有自己的表。

3.3 时序图

忙时飞桨进程单锁，会返回 503。财务侧应看到失败提示，而不是空白成功。

3.4 核心代码

上传后才允许识别。 对应 2.2，拦的是空 URL。

async function handleRecognize() {  if (!innerUrl.value) {    message.warning('请先上传发票影像');    return;  }  recognizing.value = true;  try {    const result = await recognizeInvoice({      fileUrl: innerUrl.value,      bizType: props.bizType,    });    emit('recognized', result);    if (result.warnings && result.warnings.length > 0) {      message.warning(result.warnings.join('；'));    } else {      message.success('识别完成，已回填可识别字段');    }  } finally {    recognizing.value = false;  }}

只把飞桨结果写进主表格子。 对应 2.3，不写购方，也不把明细当正式分录。

function handleRecognized(res: FinanceOcrApi.OcrRecognizeRespVO) {  recognizedBySource = ocrSource;  const invoiceDate =    res.invoiceDate && dayjs(res.invoiceDate).isValid()      ? dayjs(res.invoiceDate).valueOf()      : undefined;  formApi.setValues({    invoiceType: res.invoiceType,    invoiceCode: res.invoiceCode,    invoiceNo: res.invoiceNo,    invoiceDate,    sellerName: res.sellerName,    sellerTaxNo: res.sellerTaxNo,    amount: res.amount,    taxAmount: res.taxAmount,    priceTaxAmount: res.priceTaxAmount,  });}

Java 只打 PaddleOCR 节点。 对应 2.2 中间那一跳。平台不是 PaddleOCR 直接拒绝，避免误把对话模型当成读票器。

if (!AiPlatformEnum.PADDLE_OCR.getPlatform().equals(model.getPlatform())) {    throw new IllegalArgumentException("暂不支持的 OCR 平台：" + model.getPlatform());}AiApiKeyDO apiKey = apiKeyService.validateApiKey(model.getKeyId());byte[] fileBytes = fileApi.getFileContentByUrl(reqDTO.getImageUrl()).getCheckedData();Map<String, Object> request = new LinkedHashMap<>();request.put("imageBase64", Base64.encode(fileBytes));request.put("model", model.getModel());HttpRequest httpRequest = HttpUtil.createPost(buildEndpoint(apiKey.getUrl()))        .header("Content-Type", "application/json");if (StrUtil.isNotBlank(apiKey.getApiKey())) {    httpRequest.header("X-OCR-Token", apiKey.getApiKey());}

票号和价税来自版式锚点，不是 Prompt。 对应 2.3 的字段验收。

result["invoiceNo"] = labeled(r"发票号码:?\s*(\d{20}|\d{8})(?!\d)")result["invoiceCode"] = labeled(r"发票代码:?\s*(\d{12}|\d{10})(?!\d)")# ...if "小写" in joined:    match = re.search(r"小写[)）:]*(?:[￥¥Y])?(-?\d[\d,]*(?:\.\d+)?)", joined)    if match:        result["priceTaxAmount"] = number(match.group(1))if re.search(r"合计", joined) and "价税" not in joined:    values = [number(t.text) for t in line if number(t.text) is not None]    if len(values) >= 2:        result["amount"], result["taxAmount"] = values[-2:]

仓库默认 model-id: 69 指向本机 GPU pp-ocrv4-gpu（127.0.0.1:18081）。演示环境切 model-id: 70，打云主机 CPU pp-ocrv4-cpu（48082，必带 Token）。两套目录禁止混装：ocr-service/gpu-windows 与 ocr-service/cpu-yidong。

四、边界与对照

传统「把 PDF 丢给聊天模型抄字段」和本方案的差别：前者难回归，后者可以用同一张电子票反复打 /ocr/invoice，票号和价税必须稳定。

五、快速体验

在线演示：https://ruoyioffice.com/web/（账号 admin / admin123）

1. 打开 财务 → 发票管理 → 进项发票（/finance/invoice/input-invoice）。
2. 点「录入发票」，上传一张增值税票面（电子票 JPG 即可）。
3. 点「OCR 识别」，看票号、价税合计、销方税号是否回填。
4. 对不上的格子手改，不要为了「识别率」硬保存。
5. 保存后再次编辑，确认影像还在，来源能区分手工 / OCR。
6. 本机有 NVIDIA 时，起 ocr-service/gpu-windows，模型 69 打 18081。
7. 只有 CPU 的云主机，起 cpu-yidong，模型 70 打 48082，Key 不要提交进 Git。

源码仓库：GitHub：https://github.com/yuqing2026/ruoyi-office ｜ GitCode：https://gitcode.com/zhouzhongyan/ruoyi-office ｜ Gitee：https://gitee.com/yqzy1688/ruoyi-office

相关阅读：进项发票池与报销占用（已发）；本文是它的前半段——票还没被锁之前，字段从哪来。

常见问题（FAQ）

飞桨发票 OCR 和云端大模型有什么区别？

飞桨 PP-OCRv4 在自建节点做检测和识别，再用规则把「发票号码」「小写」锚成字段。云端多模态是另一条 provider=vlm。RuoYi Office 默认走飞桨，避免专票出网，也避免票号被模型改写成「看起来像」的数字。

识别错了还能保存进项单吗？

能。OCR 只回填，不锁死表单。没有影像不能保存；识别失败可以手填票号和价税。finance_ocr_record 会留下失败原因，进项单仍以保存值为准。

本机 GPU 和云主机 CPU 怎么切？

改 finance.ocr.model-id，以及 ai_model 绑定的 API Key URL。69 + 127.0.0.1:18081 给本机 GPU；70 + 云主机 48082 给 CPU，并配置 X-OCR-Token。模型标识必须是 pp-ocrv4-gpu 或 pp-ocrv4-cpu，和进程加载的设备一致。

为什么购方税号识别出来了，进项单没有？

解析结果里有 buyerTaxNo。进项主表当前只回填销方和价税，减少「本公司抬头写进销方」这类错列。需要购方时再在表单上补，不要为了字段多就整包灌入。

RuoYi Office 的发票 OCR 可以在线体验吗？

可以。后端 Spring Boot 3.5 + 前端 Vue3，演示站按上面路径上传一张票即可。完整能力与私有化部署咨询商业版。

结语

进项录入要的是可核对的格子，不是一段聪明的描述。本地飞桨负责读，规则负责锚，人负责核，SpringBoot3 负责把结果写进进项单。不要把云端大模型默认成读票器，也不要把识别成功当成入账许可。

同一套回填组件，销项录入也能复用，只要 bizType 分开。票读进来之后如何占用、如何报销，走票池那一套，不要塞进识别服务。

你们团队现在是手抄票号，还是已经把飞桨挂在财务网里？欢迎留言对一下耗时和必核字段。

💡 想要体验 RuoYi Office 的强大功能？

🌐 在线演示：https://ruoyioffice.com/web/（账号 admin / admin123）

📦 源码仓库：GitHub：https://github.com/yuqing2026/ruoyi-office ｜ GitCode：https://gitcode.com/zhouzhongyan/ruoyi-office ｜ Gitee：https://gitee.com/yqzy1688/ruoyi-office

💬 技术咨询：添加微信 17156169080，备注「RuoYi Office」

⭐ 如果觉得不错，请给个 Star 支持一下！