什么是unified-invoice
Unified Invoice Generator 是一款专为中小企业和自由职业者设计的发票与报价单生成工具，整合了韩语版报价单、税务发票以及国际通用的自由职业者发票功能。它通过命令行界面快速生成符合韩国税法规范的正式文件，同时支持多语言输出，适用于本地商业交易与国际客户对接。用户只需输入客户名称和商品信息，系统即可自动完成金额计算、增值税处理及文档排版，大幅简化财务流程。
该工具采用模块化架构，包含三个核心文档类型：quote（韩式报价单）用于向客户提供初步报价；tax（税务发票）满足韩国税务局要求的正式发票格式；invoice（自由职业者发票）则面向海外客户，支持美元、欧元等货币单位。所有文档均可导出为HTML、PDF或Markdown格式，便于打印、邮件发送或进一步编辑。其底层基于Node.js开发，依赖OpenClaw浏览器实现PDF转换，确保输出质量稳定可靠。
除了基础生成功能外，Unified Invoice Generator 还内置了客户数据库和常用商品库管理模块。用户可预先录入企业注册编号、联系方式等信息，并在后续开票时直接调用，避免重复输入。商品条目同样支持批量添加与更新，结合价格、单位和税率配置，实现高效复用。此外，系统提供自定义模板机制，允许开发者修改HTML模板以满足特殊品牌需求，也可通过环境变量切换语言模式，适应全球化业务场景。
核心功能特点
- 支持韩式报价单与税务发票一键生成，自动嵌入营业执照号、增值税计算
- 提供多语言自由职业者发票（含英语），兼容USD/EUR/KRW多种货币
- 内置客户与商品数据库，支持JSON存储与命令行批量管理
- 自动计算含税/不含税金额，支持反向换算与分项汇总
- 输出格式灵活：HTML预览、PDF打印、Markdown编辑三选一
- 开放模板定制，可修改HTML结构适配企业VI规范
适用场景
对于在韩国开展服务类业务的自由摄影师或活动策划公司而言，Unified Invoice Generator 能显著提升对本地客户的报价效率。例如，当接到一场婚礼拍摄订单时，只需从已保存的客户列表中选取‘김형님 컨설팅’，再调用预设的‘포토부스 대여’和‘출장비’条目，几秒内即可生成带有10%增值税的专业报价单。若客户确认合作，则可立即转为税务发票，系统自动生成唯一授权码并标注‘영수’类型，完全符合韩国税务厅申报要求。
而对于从事软件开发或文案创作的国际 freelancer，该工具同样表现出色。假设一位美国科技公司需要支付一笔40小时的技术咨询费用，用户可通过 --lang en --currency USD 参数生成英文发票，其中自动加入10%增值税并扣除3.3%的韩国源泉征收税，最终显示净收款金额。生成的Markdown文件可直接嵌入项目管理系统，而PDF版本则随附付款条款说明，方便跨境结算。无论是短期外包还是长期合作，都能快速响应客户需求，减少沟通成本。
更进阶的应用场景包括自动化工作流整合。例如，每日工作时间记录可通过脚本导入，自动转换为对应项目的发票草稿；或通过消息技能将生成的PDF附件直接发送至客户邮箱；甚至联动日历提醒设置交付期限，避免逾期风险。这种高度可扩展的设计使其不仅是一个静态文档生成器，更是现代远程办公生态中的重要生产力组件。