korean-invoice

韩国型报价单/税务发票生成器 — 自动生成符合韩国标准格式的报价单和税务发票。支持自动计算营业执照号码、供应金额、附加税。

何时使用？

• - 向客户发送报价单
• 开具税务发票
• 管理客户信息
• 管理常用项目数据库
• 以PDF/HTML格式输出

快速开始

bash

生成报价单（交互式）

korean-invoice quote

已保存客户信息时

korean-invoice quote --client Mufism

生成税务发票

korean-invoice tax --client Mufism

添加客户

korean-invoice client add Mufism --business-number 123-45-67890 --ceo Kim Hyungnim

添加项目

korean-invoice item add 摄影棚租赁 --price 500000 --unit 天

客户列表

korean-invoice client list

项目列表

korean-invoice item list

报价单字段

字段	说明	必填
client	客户名称（已保存的客户ID）	✅
items

项目列表（项目名称、数量、单价） | ✅ | | issueDate | 填写日期（默认：今天） | ❌ | | validUntil | 有效期（默认：+30天） | ❌ | | notes | 备注 | ❌ | | includeVAT | 是否包含附加税（默认：true） | ❌ |

税务发票字段

字段	说明	必填
client	接收方（客户ID）	✅
items

项目列表 | ✅ | | issueDate | 填写日期 | ✅ | | type | 收据/请求（默认：收据） | ❌ | | notes | 备注 | ❌ |

自动计算

供应金额： 500,000 韩元
附加税（10%）： 50,000 韩元
合计： 550,000 韩元

• - 输入供应金额时自动计算10%附加税
• 输入总金额时反向计算（总金额 ÷ 1.1）
• 自动合计各项目小计

客户管理

bash

添加客户

korean-invoice client add Mufism \
--business-number 123-45-67890 \
--ceo Kim Hyungnim \
--address 首尔市江南区... \
--phone 010-1234-5678 \
--email contact@mufism.com

修改客户

korean-invoice client edit Mufism --phone 010-9999-9999

删除客户

korean-invoice client remove Mufism

查看客户详情

korean-invoice client view Mufism

客户数据保存在 data/clients.json 中。

项目管理

bash

添加项目

korean-invoice item add 摄影棚租赁 --price 500000 --unit 天

修改项目

korean-invoice item edit 摄影棚租赁 --price 600000

删除项目

korean-invoice item remove 摄影棚租赁

项目列表

korean-invoice item list

项目数据保存在 data/items.json 中。

模板

报价单模板

• - 供应商信息（营业执照号码、商号、代表、地址、联系方式）
• 接收方信息
• 填写日期、有效期
• 项目表格（项目名称、规格、数量、单价、供应金额）
• 合计（供应金额、附加税、总金额）
• 备注

税务发票模板

• - 批准号码（随机生成）
• 供应商/接收方信息（营业执照号码、商号、姓名、地址）
• 填写日期
• 项目表格
• 合计（供应金额、税额）
• 收据/请求区分

输出格式

• - HTML：在浏览器中直接查看
• PDF：HTML → PDF转换（使用puppeteer）
• 保存路径：output/YYYY-MM-DD-{type}-{client}.pdf

个人信息设置

我的企业信息保存在 data/my-info.json 中：

json
{
businessNumber: 123-45-67890,
companyName: Mufism,
ceo: Kim Mufeng,
address: 首尔市江南区...,
phone: 010-1234-5678,
email: contact@mufism.com,
bankAccount: 友利银行 1002-123-456789
}

使用示例

1. 生成简单报价单

bash korean-invoice quote \ --client Mufism \ --items 摄影棚租赁,2,500000 \ --notes 不含附加税

2. 使用已保存项目

bash

预先保存项目

korean-invoice item add 摄影棚租赁 --price 500000 --unit 天 korean-invoice item add 出差费 --price 100000 --unit 次

使用项目ID生成报价单

korean-invoice quote --client Mufism --item-ids 摄影棚租赁,出差费

3. 开具税务发票

bash korean-invoice tax --client Mufism --items 摄影棚租赁,1,500000 --type 收据

集成

• - 与 message 技能联动，通过电子邮件/Discord发送
• 在 daily-report 中将工作时间转换为报价单
• 使用 calendar 技能设置有效期提醒

注意事项

• - 营业执照号码按 123-45-67890 格式输入
• 金额以韩元为单位输入（仅数字，不含逗号）
• 生成PDF需要OpenClaw浏览器正在运行