PDF Templates
PDF Templates
Section titled “PDF Templates”Pre-designed templates for common document types. Use GET /pdf/v1/templates to retrieve the full JSON schema for each template.
Built-in Templates
Section titled “Built-in Templates”Invoice Modern
Section titled “Invoice Modern”Clean, contemporary invoice with tax breakdown, IRPF withholding, and payment details.
Invoice Minimal
Section titled “Invoice Minimal”Stripped-down minimalist invoice — just the essentials.
Invoice Professional
Section titled “Invoice Professional”Corporate invoice with dark sidebar header. Ideal for professional clients. Includes PO number, project name, and payment terms fields.
Service Invoice
Section titled “Service Invoice”Hourly service invoice with time tracking summary. Items use hours + rate instead of qty + unit_price. Includes a per-period breakdown and total hours badge.
Quote / Proposal
Section titled “Quote / Proposal”Proposal document with validity period and terms.
Receipt
Section titled “Receipt”Payment receipt with tax breakdown.
Delivery Note
Section titled “Delivery Note”Delivery note without pricing — items, quantities, carrier, and tracking info.
Certificate
Section titled “Certificate”Certificate or diploma with recipient name, title, and issuer details.
Business Report
Section titled “Business Report”Corporate report with cover page, numbered sections with accent borders, and an optional data table. Ideal for summaries, audits, and internal reports.
Custom Templates
Section titled “Custom Templates”You can also use custom HTML/CSS via the POST /pdf/v1/render/html endpoint.
Template Variables
Section titled “Template Variables”Common variables available across invoice-type templates:
| Variable | Type | Description |
|---|---|---|
invoice_number | string | Invoice identifier |
date | string | Issue date |
due_date | string | Payment due date |
accent_color | string | Hex color for accents (e.g. #2563EB) |
currency | string | Currency code (default: EUR) |
issuer | object | Issuer details (name, nif, address, email, logo_url) |
client | object | Client details (name, nif, address) |
items | array[] | Line items (description, qty, unit_price) |
tax_rate | number | IVA percentage (default: 21) |
withholding_rate | number | IRPF percentage (default: 0) |
notes | string | Additional notes |
payment_details | string | Bank account / payment info |
Styling
Section titled “Styling”Templates support CSS with these features:
- Flexbox and Grid layouts
- Custom fonts (Google Fonts)
- Page breaks (
page-break-after) - Headers/footers (running elements)