korean-invoice

韩国式报价单/增值税专用发票生成器 — 按照韩国标准格式自动生成报价单与增值税专用发票。支持自动计算企业注册号、供应金额及增值税。

适用场景

• 向客户发送报价单
• 开具增值税专用发票
• 管理交易方信息
• 维护常用商品/服务数据库
• 导出为 PDF / HTML 格式

快速开始

# 交互式创建报价单
korean-invoice quote

# 使用已保存的交易方
korean-invoice quote --client "무펭이즘"

# 创建增值税专用发票
korean-invoice tax --client "무펭이즘"

# 添加交易方
korean-invoice client add "무펭이즘" --business-number "123-45-67890" --ceo "김형님"

# 添加商品/服务
korean-invoice item add "포토부스 대여" --price 500000 --unit "일"

# 列出所有交易方
korean-invoice client list

# 列出所有商品/服务
korean-invoice item list

报价单字段

增值税专用发票字段

自动计算

供应金额：     500,000 元  
增值税（10%）：  50,000 元  
合计：         550,000 元

• 输入供应金额时，自动按 10% 计算增值税
• 输入合计金额时，反向推算供应金额（合计 ÷ 1.1）
• 自动汇总各商品/服务的小计

交易方管理

# 添加交易方
korean-invoice client add "무펭이즘" 
  --business-number "123-45-67890" 
  --ceo "김형님" 
  --address "서울시 강남구..." 
  --phone "010-1234-5678" 
  --email "contact@mufism.com"

# 修改交易方
korean-invoice client edit "무펭이즘" --phone "010-9999-9999"

# 删除交易方
korean-invoice client remove "무펭이즘"

# 查看交易方详情
korean-invoice client view "무펭이즘"

交易方数据保存在 data/clients.json 中。

商品/服务管理

# 添加商品/服务
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：通过 puppeteer 将 HTML 转换为 PDF
• 保存路径：output/YYYY-MM-DD-{type}-{client}.pdf

我的信息配置

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

{
  "businessNumber": "123-45-67890",
  "companyName": "무펭이즘",
  "ceo": "김무펭",
  "address": "서울시 강남구...",
  "phone": "010-1234-5678",
  "email": "contact@mufism.com",
  "bankAccount": "우리은행 1002-123-456789"
}

使用示例

1. 简单报价单生成

korean-invoice quote 
  --client "무펭이즘" 
  --items "포토부스 대여,2,500000" 
  --notes "부가세 별도"

2. 使用已保存的商品/服务

# 预先保存商品/服务
korean-invoice item add "포토부스 대여" --price 500000 --unit "일"
korean-invoice item add "출장비" --price 100000 --unit "회"

# 使用商品/服务 ID 创建报价单
korean-invoice quote --client "무펭이즘" --item-ids "포토부스 대여,출장비"

3. 开具增值税专用发票

korean-invoice tax --client "무펭이즘" --items "포토부스 대여,1,500000" --type 영수

集成能力

• 与 message 技能联动，支持通过电子邮件或 Discord 发送
• 与 daily-report 技能联动，将工时记录自动转换为报价单
• 与 calendar 技能联动，设置有效期到期提醒

注意事项

• 企业注册号须按 123-45-67890 格式输入
• 金额请以“元”为单位输入（仅数字，不加千位分隔符逗号）
• 生成 PDF 时需确保 OpenClaw 浏览器处于运行状态