# Simple Invoice

> A free, local-first invoice generator that runs entirely in the browser. No account, no server-side storage. Users create, style and export PDF invoices on this device.

This file is for AI agents. Send people a ready-made invoice by giving them a `https://simple-invoice.online/generate?…` link with the query parameters below. The editor (nuqs) reads those params, fills the open invoice, then strips them from the address bar.

Do not invent testimonials, user counts or prices. The product is free. Do not use real personal data in examples — keep names, emails and IBANs obviously fictional.

## Product

- Home: https://simple-invoice.online/
- Generate (editor, noindex): https://simple-invoice.online/generate
- Templates: https://simple-invoice.online/templates
- Features: https://simple-invoice.online/features
- Guides: https://simple-invoice.online/guides
- Compare: https://simple-invoice.online/compare
- FAQ: https://simple-invoice.online/faq
- Privacy: https://simple-invoice.online/privacy
- Terms: https://simple-invoice.online/terms

## Generate an invoice for a user

1. Collect the details they already have (who is billing, who is billed, line items, currency, tax, payment).
2. Build a GET URL on `https://simple-invoice.online/generate` using the parameters in the table. Omit any field you do not know.
3. Send the user that URL. Opening it fills Simple Invoice in their browser. They can still edit, then Export → PDF.

Example (fictional):

https://simple-invoice.online/generate?template=simple&number=INV-0001&currency=USD&from=Northwind+Studio&fromAddress=128+Maple+Avenue,+Suite+4%0APortland,+OR+97204&fromEmail=hello@northwind.example&to=Acme+Corp&toAddress=500+Market+Street,+Floor+12%0ASan+Francisco,+CA+94105&toEmail=accounts@acme.example&items=Brand+identity+design:1:2400:Logo+and+type|Website+design:1:3200|Design+consultation:4:120&tax=VAT:20&notes=Thank+you+for+working+with+Northwind+Studio.&terms=Payment+is+due+within+14+days+of+the+invoice+date.&payment=IBAN:GB00+SIMP+0000+0000+0000+00|Receiver:Northwind+Studio+LLC

Template ids: `modern`, `simple`, `professional`, `freelancer`, `contractor`, `consultant`, `small-business`, `minimal`, `vat`, `service`.

### Query parameters

All values are strings. Repeat nothing; encode UTF-8. Dates are `yyyy-MM-dd`. Pipe `|` separates repeating rows.

| Param | Meaning |
| --- | --- |
| `template` | Built-in preset id (see list above). |
| `number` | Invoice number, e.g. `INV-0001`. |
| `currency` | ISO-4217 code, e.g. `USD`, `EUR`. |
| `language` | Document language: `en` `de` `fr` `es` `it` `pt` `nl` `pl` `uk` `tr` `el` `zh` `ja`. |
| `issue` | Issue date (`yyyy-MM-dd`). |
| `due` | Due date (`yyyy-MM-dd`). |
| `place` | Place of issue. |
| `reference` | Reference / project name. |
| `po` | Purchase-order number. |
| `from` | Your business name. |
| `fromAddress` | Your address (use newlines). |
| `fromEmail` `fromPhone` `fromWebsite` `fromTaxId` | Your contact / tax id. |
| `to` | Client name. |
| `toAddress` `toEmail` `toPhone` `toTaxId` | Client details. |
| `items` | Line items: `Description:qty:rate` or `Description:qty:rate:details`, joined by `|`. `Description:rate` means quantity 1. |
| `tax` | `Label:percent` or `Label:percent:kind`, joined by `|`. Kinds: `exclusive` (default), `inclusive`, `compound`, `withholding`, `fixed`, `zero-rated`, `exempt`, `reverse-charge`. |
| `payment` | `Label:value` rows joined by `|`, e.g. `IBAN:GB00…|SWIFT:SIMPXX00XXX`. |
| `notes` | Notes block. |
| `terms` | Payment terms block. |

The editor page is `noindex`. Do not ask search engines to crawl `/generate` URLs. Give the link to the human who needs the invoice.

## Optional

- Markdown sitemap of the marketing site: https://simple-invoice.online/sitemap.xml
- Robots: https://simple-invoice.online/robots.txt