invoice-generator
Generate professional PDF invoices from JSON data. Use when the user needs to create an invoice, billing document, or payment request with company/client details and line items.
Informations de source
- Dépôt
- ThinkfleetAI/thinkfleet-engine
- Dernière activité de la source
- 10 février 2026 à 12:42
- Langue détectée de SKILL.md
- anglais
- Étoiles
- 0
- Forks
- 0
Options d'installation
Le prompt qui vérifie d'abord la source est sélectionné par défaut. Vous pouvez passer à une commande directe ou télécharger une copie locale.
Vérifiez les fichiers source
Lisez SKILL.md et les fichiers associés affichés par SkillsMP avant de décider de l'installer.
Affichage de SKILL.md
SKILL.md
Instructions source · Aperçu en lecture seule- name
- invoice-generator
- description
- Generate professional PDF invoices from JSON data. Use when the user needs to create an invoice, billing document, or payment request with company/client details and line items.
- metadata
- {"thinkfleet":{"emoji":"🧾","requires":{"bins":"[Truncated]","env":"[Truncated]"},"primaryEnv":"INVOICE_DIR"}}
# Invoice Generator
Generate PDF invoices from structured JSON data.
## Setup
1. Install Node.js dependencies:
```bash
cd invoice-generator && npm install
```
2. Set `INVOICE_DIR` environment variable (or in `skills.entries.invoice-generator.env`):
```bash
export INVOICE_DIR="/path/to/your/invoices"
```
This creates the directory structure:
```
$INVOICE_DIR/
├── configs/ # Optional: saved invoice configs
└── invoices/ # Generated PDF output
```
## Usage
```bash
# From stdin (on-the-fly)
cat invoice-data.json | {baseDir}/scripts/generate.sh
# From a full file path
{baseDir}/scripts/generate.sh /path/to/invoice-data.json
# From a saved config (looks in $INVOICE_DIR/configs/)
{baseDir}/scripts/generate.sh client-template
# Loads: $INVOICE_DIR/configs/client-template.json
# Output goes to: $INVOICE_DIR/invoices/invoice-{number}.pdf (auto-versions if exists)
```
## Input Data Format
The JSON input must contain these fields:
```json
{
"company": {
"name": "Your Company",
"address": "123 Main St",
"cityStateZip": "City, State, 12345",
"country": "Country"
},
"client": {
"name": "Client Name",
"address": "456 Client Ave",
"cityStateZip": "City, State, 67890",
"country": "Country",
"taxId": "TAX123"
},
"invoice": {
"number": "INV-2025.01",
"date": "Jan 15 2025",
"dueDate": "Jan 30 2025"
},
"items": [
{
"description": "Service description",
"rate": "1000.00",
"currency": "USD"
}
],
"totals": {
"currency": "USD",
"total": "1,000.00"
}
}
```
See [references/data-schema.md](references/data-schema.md) for complete field documentation.
## Output
The script outputs the path to the generated PDF file on success:
```
$INVOICE_DIR/invoices/invoice-INV-2025.01.pdf
# If that filename already exists, the script will write:
# $INVOICE_DIR/invoices/invoice-INV-2025.01-2.pdf (then -3, etc.)
```
## Error Handling
- Exits with code 1 if JSON is invalid or missing required fields
- Exits with code 2 if weasyprint fails to generate PDF
- Error messages are written to stderr
Voir sur GitHub