ERP / 财务发票与对账单静默打印

财务共享、ERP 出票窗口需将增值税发票版式、对账单、费用明细静默打到指定打印机。HTML 报表 + printHtml 可复用 Web 版式,避免 window.print 弹窗打断财务操作。

打印架构

ERP 页面或接口输出 HTML → printHtml → 客户端 PDF 渲染 → 办公室 A4 激光机或针式打印机静默出纸。

典型场景

增值税票

发票 / 电子票打印

A4 纵向、背景图与水印见 发票样例;printBackground: true 保留票面底色。

批量

月末批量出账

财务月结可用 batchPrint;参数见 batchPrint API。

接入步骤

  1. 财务 PC 安装客户端
  2. 从 ERP 按钮提取报表 HTML 或模板字符串
  3. 配置 A4 pdfOptions 与 printOptions.printerName
  4. 联调 preview → 正式 silent print
  5. 失败统一 formatPrintError

A4 发票 printHtml 示例

await webPrintPdf.printHtml(
  invoiceHtml,
  { paperFormat: 'A4', printBackground: true },
  { printerName: 'Finance laser', duplex: 'longEdge' }
);

参数要点

  • 背景:printBackground: true 保留 CSS 背景
  • 双面:printOptions.duplex 与打印机能力匹配
  • 鉴权 URL:报表若需登录,见 URL 鉴权打印

选型要点

需要用户每次确认可用 window.print;需要指定打印机静默选 web-print-pdf。存量 Lodop 套打可并行评估,见 Lodop 迁移。

排障清单

  • 背景丢失 → 开启 printBackground
  • 表格截断 → 检查 pdfOptions margin 与 CSS 分页
  • 登录页而非报表 → auth-url-print 专题

与本站专题分工

常见问题

ERP 报表 HTML 从哪来?

常见做法:前端 ref 取 DOM、后端接口返回 HTML 字符串,或 printHtmlByUrl + extraOptions。

能否指定财务室打印机?

可以。printOptions.printerName 填客户端枚举名称。

长表格多页怎么配?

用 CSS 分页与 A4 pdfOptions;先 preview 核对总页数。

批量打印对账单?

batchPrint 传入任务数组;任务级参数覆盖批量默认。

和导出 PDF 文件比?

jsPDF/Puppeteer 适合归档;工位直打选 web-print-pdf。

各平台客户端部署

同一套 web-print-pdf 前端代码可在 Windows、macOS、Linux/信创混合环境运行;请按终端操作系统安装对应客户端。

免费下载客户端 查看 npm 包 开发文档