← Back to all products
$19
Invoice Generator
PDF and HTML invoice generator with customizable templates, line items, and tax calculations.
PythonMarkdownJSON
Product Preview
Try the interactive reader and demo tools below, or get the full product with all content unlocked.
Interactive Reader (Free Preview) ⚙ Try Demo Tools Download Free SampleFile Structure 12 files
invoice-generator/
├── LICENSE
├── README.md
├── examples/
│ └── invoice_data.json
├── free-sample.zip
├── guide/
│ ├── 01_features.md
│ ├── 02_cli-reference.md
│ └── 03_license.md
├── index.html
├── interactive.html
├── src/
│ └── invoice_generator.py
└── tests/
└── test_invoice_generator.py
Documentation Preview README excerpt
Invoice Generator
Part of the Payment Stack by CodeVault
Generate professional, print-ready HTML invoices from a simple JSON config. Supports line items, taxes, discounts, payment terms, and custom branding.
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
# 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
CLI Reference
| Flag | Description |
|---|---|
--action, -a | Action: generate (default), demo, validate |
--config, -c | Path to invoice JSON config file |
--output, -o | Output file path (default: stdout) |
--format, -f | Output format: html (default) or json |
--verbose, -v | Enable debug logging |
Configuration Reference
See examples/invoice_data.json for a complete example. Key fields:
| Field | Type | Description |
|---|---|---|
invoice_number | string | Invoice ID (auto-generated if omitted) |
issue_date | string | Issue date in YYYY-MM-DD format |
due_date | string | Due date (defaults to Net 30) |
currency | string | ISO 4217 code: USD, EUR, GBP, JPY, CAD, AUD |
sender | object | Your business address and contact info |
recipient | object | Client address and contact info |
line_items | array | Items with description, quantity, unit_price, tax_rate, discount_percent |
payment_terms | string | Terms text (e.g., "Net 30") |
... continues with setup instructions, usage examples, and more.
Code Sample .py preview
src/invoice_generator.py
#!/usr/bin/env python3
"""
Invoice Generator — Payment Stack by DataNest
Generate professional HTML invoices from JSON data: line items with quantity
and unit pricing, tax calculation, payment terms, due dates, branding, and
notes. Outputs self-contained HTML files ready for printing or PDF conversion.
Why this exists:
Every SaaS and freelancer needs invoices. Building an invoice generator
from scratch means dealing with currency formatting, tax math, HTML/CSS
layout for printing, and edge cases like discounts and multi-line notes.
This tool handles all of that from a simple JSON config, producing clean
HTML invoices you can send directly to clients.
Usage:
python invoice_generator.py --config invoice_data.json
python invoice_generator.py --config invoice_data.json --output invoice_001.html
python invoice_generator.py --config invoice_data.json --format json
python invoice_generator.py --action demo
License: MIT
"""
from __future__ import annotations
import argparse
import json
import logging
import sys
import html as html_module
import uuid
from dataclasses import dataclass, field, asdict
from datetime import datetime, date, timedelta, timezone
from pathlib import Path
from typing import Any, Optional
# ---------------------------------------------------------------------------
# Constants
# ---------------------------------------------------------------------------
# Default payment terms in days
DEFAULT_NET_DAYS = 30
# Currency formatting rules
CURRENCY_CONFIG: dict[str, dict[str, Any]] = {
"USD": {"symbol": "$", "decimal_places": 2, "thousands_sep": ",", "decimal_sep": "."},
"EUR": {"symbol": "€", "decimal_places": 2, "thousands_sep": ".", "decimal_sep": ","},
"GBP": {"symbol": "£", "decimal_places": 2, "thousands_sep": ",", "decimal_sep": "."},
"JPY": {"symbol": "¥", "decimal_places": 0, "thousands_sep": ",", "decimal_sep": "."},
# ... 613 more lines ...