Invoice生成

技能简介

该技能将结构化JSON数据转换为专业格式的PDF发票文档，支持公司信息、客户详情、项目明细和金额汇总的标准化排版。

业务背景

财务与运营人员频繁需要开具标准化发票，手工制作易出错且耗时。本工具将JSON结构化数据自动渲染为专业PDF发票，确保版式统一、编号规范，减少重复排版工作，加速 billing 流程。

落地案例：某SaaS公司每月需向数百客户发送订阅发票。财务人员将订单系统导出的JSON数据传入工具，指定预设模板后批量生成PDF，文件自动按规则命名并存档至指定目录。若文件名冲突，系统自动追加版本号，避免覆盖历史记录，方便后续审计调阅。

能做什么

• 从JSON文件或标准输入读取发票数据
• 生成带自动编号的专业PDF发票
• 支持预设模板快速复用常用配置
• 自动处理文件名冲突（版本递增）

使用说明

安装步骤：

1. 进入技能目录并安装Node.js依赖：
   cd invoice-generator && npm install
2. 设置环境变量指定工作目录：
   export INVOICE_DIR="/path/to/your/invoices"
   该目录下会自动创建configs/（模板存储）和invoices/（PDF输出）子目录

使用方法：

• 管道输入即时生成：
  cat invoice-data.json | {baseDir}/scripts/generate.sh
• 指定完整文件路径：
  {baseDir}/scripts/generate.sh /path/to/invoice-data.json
• 调用已保存的模板配置：
  {baseDir}/scripts/generate.sh client-template
  系统会从$INVOICE_DIR/configs/加载对应JSON文件

输出生成至$INVOICE_DIR/invoices/invoice-{number}.pdf，若文件已存在则自动添加版本后缀（-2、-3等）。

输入与输出

见下方输入与输出表格。

风险提示

• JSON格式错误或缺少必填字段时退出码为1
• weasyprint渲染失败时退出码为2
• 需确保Node.js、jq、weasyprint已正确安装
• 环境变量INVOICE_DIR未设置时无法定位输出目录

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/tmigone/invoice-generator/SKILL.md
来源类型：GitHub仓库

常见问题

Q1：Invoice生成 适合哪些场景？
A：适合需要「技能简介 该技能将结构化JSON数据转换为专业格式的PDF发票文档，支持」的场景，尤其是希望快速验证并落地的团队与个人。

Q2：第一次使用应该先做什么？
A：先明确目标任务，再按照页面中的“能做什么”和“使用说明”完成最小可行流程。

Q3：如何判断是否值得长期使用？
A：建议连续使用 1-2 周，对比效率、稳定性和协作成本，再决定是否纳入长期工具栈。

替代方案

• Mspot生成
• Legal文档管理
• Style生成

相关推荐

• Resume生成
• Prezentit演示稿生成
• Pdf文档管理
• Pptx大纲生成