Contents

Chapter 1

Features

This chapter covers the core features and capabilities of Invoice Generator.

Features

  • Beautiful, self-contained HTML invoices (no external dependencies)
  • Print-optimized CSS with proper page break handling
  • Line items with quantity, unit pricing, and per-item tax rates
  • Per-item discount percentages
  • Multi-currency support (USD, EUR, GBP, JPY, CAD, AUD)
  • Customizable brand color and text logo
  • Payment methods section (bank transfer, PayPal, etc.)
  • Invoice status badges (draft, sent, paid, overdue, canceled)
  • JSON report output for programmatic use
  • Config validation mode for catching errors before generation
  • Python stdlib only — zero dependencies

Quick Start

bash
# Generate a demo invoice to see it in action
python src/invoice_generator.py --action demo --output demo_invoice.html

# Generate from your own config
python src/invoice_generator.py --config examples/invoice_data.json --output invoice.html

# Validate config without generating
python src/invoice_generator.py --config examples/invoice_data.json --action validate

# Output as JSON report
python src/invoice_generator.py --config examples/invoice_data.json --format json
Chapter 2

CLI Reference

Follow this guide to get Invoice Generator up and running in your environment.

CLI Reference

FlagDescription
--action, -aAction: generate (default), demo, validate
--config, -cPath to invoice JSON config file
--output, -oOutput file path (default: stdout)
--format, -fOutput format: html (default) or json
--verbose, -vEnable debug logging

Configuration Reference

See examples/invoice_data.json for a complete example. Key fields:

FieldTypeDescription
invoice_numberstringInvoice ID (auto-generated if omitted)
issue_datestringIssue date in YYYY-MM-DD format
due_datestringDue date (defaults to Net 30)
currencystringISO 4217 code: USD, EUR, GBP, JPY, CAD, AUD
senderobjectYour business address and contact info
recipientobjectClient address and contact info
line_itemsarrayItems with description, quantity, unit_price, tax_rate, discount_percent
payment_termsstringTerms text (e.g., "Net 30")
payment_methodsarrayAccepted payment methods
brand_colorstringHex color for accents (default: #2563EB)
notesstringAdditional notes for the client
statusstringdraft, sent, paid, overdue, canceled
Chapter 3
🔒 Available in full product

License

You’ve reached the end of the free preview

Get the full Invoice Generator and unlock everything.

All Chapters

Get the complete guide with every chapter unlocked, including code samples, diagrams, and best practices.

Full Tool Suite

Access all interactive tools with complete data, all workload profiles, and the full scenario library.

Source Files

Downloadable source code, configuration files, and working examples from every chapter.

Lifetime Updates

Free updates for life. Every new chapter, tool, and improvement included.

Buy Now — $19 →
📦 Free sample included — download another copy for the full product.
Invoice Generator v1.0.0 — Free Preview