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.
Informações da origem
- Repositório
- ThinkfleetAI/thinkfleet-engine
- Última atividade na origem
- 10 de fevereiro de 2026 às 12:42
- Idioma detectado do SKILL.md
- inglês
- Estrelas
- 0
- Forks
- 0
Opções de instalação
Por padrão, está selecionado o prompt que primeiro revisa a origem. Você pode mudar para um comando direto ou baixar uma cópia local.
Revise os arquivos de origem
Leia o SKILL.md e os arquivos complementares exibidos pelo SkillsMP antes de decidir se vai instalar.
Exibindo SKILL.md
SKILL.md
Instruções da origem · Visualização somente leitura- 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
Ver no GitHub