# Invovate — sample outputs

Public demo assets generated by the live Invovate invoice API
(`POST https://invovate.com/api/generate-invoice`). Free to use for evaluation,
documentation, and listings.

## Sample invoices (PDF)

**22 invoices — 2 per language (11 languages), each in a different currency.**
For every language: a `branded` variant (logo + signature + payment block + due
date) and a `plain` variant (no images; shows discounts / partial payments).

File naming: `invoice-<lang>-<CURRENCY>-<branded|plain>.pdf`
(e.g. `invoice-en-GBP-branded.pdf`, `invoice-ja-USD-plain.pdf`).

Languages & currency pairs: en (GBP/USD) · nl (EUR/GBP) · de (EUR/CHF) ·
fr (EUR/CAD) · es (EUR/MXN) · it (EUR/CHF) · pt (EUR/BRL) · ar RTL (SAR/AED) ·
ja (JPY/USD) · ru (RUB/EUR) · hi (INR/USD). See `samples-manifest.json` for the
full machine-readable list.

All non-Latin invoices embed proper Noto Sans fonts (Arabic, Japanese,
Devanagari, Cyrillic) and render mixed Latin text (emails, IBANs) cleanly. The
whole matrix is reproducible with `node scripts/generate-samples.mjs`.

## Other formats

- `invoice-sample.ubl.xml` — UBL 2.1 XML export (`"output": "ubl"`).
  *Interoperability/archival only — not a regulated e-invoice transmission.*
- `sample-request.json` — a representative request body for `POST /api/generate-invoice`.
- `webhook-payload-sample.json` — the exact JSON body delivered for an
  `invoice.generated` webhook event.

## Webhook delivery

Webhook POSTs carry these headers:

```
Content-Type: application/json
User-Agent: Invovate-Webhooks/1.0 (+https://invovate.com/api)
X-Invovate-Event: invoice.generated
X-Invovate-Signature: sha256=<hex HMAC-SHA256 of the raw body, keyed with your webhook secret>
```

Verify by recomputing `HMAC-SHA256(secret, rawBody)` and comparing to the
`X-Invovate-Signature` hex (constant-time). Events: `invoice.generated`,
`batch.generated`.

## Regenerate

```bash
curl -X POST https://invovate.com/api/generate-invoice \
  -H "Authorization: Bearer inv_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d @sample-request.json --output invoice.pdf
```

Docs: https://invovate.com/api · For AI agents: https://invovate.com/invoice-api-for-ai-agents