
Invoice & Quote Forge:英国VAT·美国销售税 发票报价单PDF
Invoice & Quote Forge
给客户开票、报价,不用再翻 Word 模板或订阅记账软件。填一份 JSON 需求,直接出能发出去的发票和报价单:A4 与 US Letter 双纸型、按行计税、付款条款、滞纳金措辞、银行信息、记账 CSV。
全程本地确定性生成,不联网、不调 AI、不需要 API Key。同一份数据重跑,金额一分不差。
你会拿到什么
| 文件 | 内容 |
|---|---|
out/invoice-a4.pdf |
发票,A4(英国 / 欧洲标准) |
out/invoice-letter.pdf |
同一张发票,US Letter(美国标准) |
out/quote-a4.pdf |
报价单,行项目与发票一致 |
out/ledger.csv |
记账行:发票号、日期、客户、币种、小计、税、合计 |
out/report.json |
机器可读的合计数据,方便核对和二次处理 |
为什么英国、美国的自由职业者需要它
- 英国:VAT 必须按行计算并单独列示,发票上要有 VAT 号、付款到期日。20% 是标准税率,但书籍、儿童服装是 0%,一张发票里混税率很常见。
- 美国:没有 VAT,但有州销售税(sales tax),而且不同州税率不同。发票要写
Sales tax,不是VAT。 - 两边共同的痛点:逾期付款。发票上必须写清付款条款和滞纳金,否则客户拖三个月你也没话说。
- 币种:GBP / USD / EUR / AUD / CAD 五种,符号跟着币种走,不会出现英镑发票印着
$的事故。
怎么用
第一步,说清楚四件事(其余用默认值):
卖方:工作室名、地址、VAT 号或 EIN
客户:公司名、地址、VAT 号
项目:描述、数量、单价、税率
币种与账期:GBP / 30 天 / 2% 月滞纳金
第二步,生成:
pip install -r requirements.txt
python3 scripts/make_invoice.py --spec brief.json --out out/ --kind both
第三步,校验(不要只信控制台):
python3 scripts/verify_invoice.py out/ --spec brief.json
verify_invoice.py 会重新算一遍小计、税、合计,然后打开 PDF 检查:纸张尺寸是不是 A4 595×842 pt 或 Letter 612×792 pt、发票号 / 客户名 / 合计金额是否真的印在页面上、小计 + 税 = 合计、CSV 行是否与 PDF 一致。任一项不过直接报错。
计税规则
| 模式 | 用在哪 | 发票上怎么显示 |
|---|---|---|
vat |
英国、欧盟 | VAT (20%),单独一行 |
sales_tax |
美国 | Sales tax,单独一行 |
none |
不注册税号的个体 | 不显示税行 |
税率挂在每个行项目上,所以一张发票可以同时有 20% 的服务和 0% 的书籍。税是按行算完再相加,不是拿总额乘一个混合税率——这是很多模板算错的地方。
示例:英国设计工作室
一份真实跑通的样例(references/sample-spec.json):
- 客户:Northwind Studios Ltd,London
- 行项目:品牌设计 £2,400 + 网站开发 £1,382.50
- 小计 £3,782.50,VAT 20% £756.50,合计 £4,539.00
- 账期 30 天,滞纳金 2% / 月
- 输出:A4 发票、Letter 发票、A4 报价单、ledger.csv、report.json
- 校验:17 项全过
常见问题
金额会算错吗?
不会。所有钱用 Decimal 计算,四舍五入到 2 位小数(half-up),不经过浮点数。校验脚本会独立重算一遍对账。
能开形式发票(pro-forma)吗?
能,--kind quote 出报价单,--kind both 同时出发票和报价单。
支持分期或定金吗?
支持在行项目里写「Deposit 50%」和「Balance on delivery」两行,税额分别计算。
能直接对接 Xero / QuickBooks 吗?
导出 ledger.csv,列名按通用记账格式,可直接导入或粘贴。
会替我报税吗?
不会。这是开票工具,不做 VAT 申报、不做 HMRC 提交、不做多币种合并报表。
English
Freelancers and small studios lose hours every month rebuilding invoices in Word or Canva. This agent turns one JSON brief into an invoice, a quotation and a ledger row — A4 and US Letter, GBP/USD/EUR/AUD/CAD, per-line VAT or sales tax, payment terms, late-fee wording and bank details.
Everything is generated locally with ReportLab. No network, no API key, no AI model. Run the same brief twice and the totals are identical to the cent.
Ask it for: "Invoice Northwind Studios for brand design £2,400 and web development £1,382.50, 20% VAT, 30-day terms."
版本
v1.0.0 · 中文(简体)为主语言


