PDF发票生成器

4小时前更新 1 00
PDF发票生成器PDF发票生成器
PDF发票生成器

技能简介

该技能将结构化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文件、标准输入流或预设模板名称;JSON需包含company(公司信息)、client(客户信息)、invoice(发票编号/日期)、items(项目明细数组)、totals(金额汇总)五个必填对象
输出PDF格式发票文件,保存至$INVOICE_DIR/invoices/目录,文件名格式为invoice-{number}.pdf,冲突时自动追加版本号
适用人群中小企业财务人员、独立开发者、SaaS产品运营团队、需要自动化账单流程的自由职业者
不包含发票邮件发送、在线支付对接、税务合规校验、云端存储同步、历史发票检索数据库

 

风险提示

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

来源信息

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

数据统计

相关导航

暂无评论

none
暂无评论...