Invoice Builder 是一款面向小微企业和自由职业者的开票工具，它内置的报价单（Quotes）模块让你可以快速创建报价单、管理报价状态，并在客户接受报价后一键转成正式发票。本指南覆盖从新建报价、填写明细，到导出 PDF、转换为发票的完整流程。

报价单功能总览

进入左侧导航栏的Quotes页面，你就能完成报价单的全部日常管理：

• ✅ 创建、编辑、删除报价单（完整 CRUD）
• 🔍 按状态、客户、日期等条件筛选
• 📄 实时 PDF 预览并导出 PDF 报价单
• 📊 导出 XLSX 报表（不含附件与 Logo 快照）
• 🔄一键转发票：报价转发票后报价自动关闭，也可随时手动重新打开
• 📋 快速复制一份报价，生成类似的新报价

界面整体布局如下：左侧是报价列表，右侧是选中报价的详情面板。

💡 列表中的每张报价会显示：开具日期、状态（Open / Closed）、客户名称、金额总额，以及到期提醒（如 "Due in 32 day(s)"、"Overdue"），让你一眼掌握所有报价的进展。

如何快速创建报价单

点击页面底部的Add（＋）按钮，打开右侧录入面板。如果启用了预设（Presets）功能，会先弹出选择面板：既可以Create new全新创建，也可以Create new from preset从已有预设快速生成。

填写报价基本信息

创建时需要填写以下必填项：

各个下拉框都支持搜索、筛选和排序；货币、公司、客户、风格方案（Style Profile）等选择都会以"快照"方式保存——之后即使修改原数据，历史报价也不受影响。

选择客户并添加报价项目

客户选择器里有一个小技巧：不需要离开报价表单，直接点Add就能快速新建客户，填好名称（可选填电话）后会自动选中新客户。

报价项目同样从项目库中选取：选好项目后弹窗中填写数量和单价，还可以为项目添加自定义字段（如表头 + 值），这些自定义列会直接显示在 PDF 的项目表格里。

添加多个项目后，可以用拖拽自由调整顺序。

设置折扣、税费与运费

在报价金额区域，你可以按需配置（金额为 0 的区块在 PDF 中会自动隐藏）：

• 💰折扣（Discount）：固定金额或百分比
• 🏷️附加费（Surcharge）：固定金额或百分比
• 🧾税费（Tax）：支持按总额计税（含税/不含税/扣除）或按单项计税（含税/不含税）
• 🚚运费（Shipping fees）：固定金额

一键将报价单转换为发票

这是整个报价流程的高光时刻 ⭐：当客户接受报价后，点击报价项右侧的竖排三点菜单，选择Make invoice，系统就会基于这份报价自动生成一张正式发票，同时报价状态变为Closed（如需继续跟进，可手动重新打开）。

菜单中的其他常用操作：

• Export：导出报价单 PDF
• Duplicate：复制当前报价，快速生成相似新单
• Delete：删除报价

转换生成的发票会自动继承报价中的客户、公司、项目和金额信息，你只需在 Invoices 页面 补充发票号与付款信息即可。该转换逻辑由核心服务层实现，参见 invoices.ts。

报价单 PDF 预览与导出

点击详情面板顶部的Preview，可以实时预览报价单 PDF 效果，并在线调整 PDF 样式（字体、颜色、Logo、页眉页脚等）。调整满意后点Save as Profile还能把当前样式保存为风格方案，复用到其他报价单上。

需要发送给客户时，直接从操作菜单Export导出 PDF 即可；想批量整理数据，则可用右上角Export导出 XLSX。

转换成功后，生成的发票在 PDF 端呈现正式发票样式，可直接交付客户。

相关文档

• 报价单功能详解：quotes.md
• 发票功能详解：invoices.md
• 客户管理：clients.md
• 项目库管理：items.md
• 预设模板：presets.md
• 报价单页面源码入口：index.tsx