API dokumentace

Tři kroky k PDF.

Vystavuj elegantní faktury přímo z kódu — Node, prohlížeč, Bun, Deno. Tato stránka je jen ochutnávka; kompletní schéma, všechna pole a tvůj licenční klíč jsou za bezplatným účtem.

1 · Nainstaluj SDK

Běží na Node 18+, Bun, Deno i v moderních prohlížečích. Balík obsahuje ESM i CJS.

npm install simpleinvoicing

2 · Jedno volání, jedno PDF

Nastav licenční klíč jednou přes createClient a faktury vystavuj jedním await. Uložené firmy a klienti (pro opakované fakturování) se odkryjí po přihlášení.

import { createClient } from 'simpleinvoicing';

const si = createClient({ licenseKey: process.env.SI_KEY! });

const pdf = await si.invoices.generate({
  supplier:  { name: 'Acme Ltd' },
  purchaser: { name: 'Globex' },
  invoiceDetails: {
    invoiceNr: 'INV-2026-001',
    issueDate: '2026-06-15',
    dueDate:   '2026-06-29',
    currency:  'EUR',
  },
  items: [{ item: 'Web design', quantity: 1, unitCost: 1200 }],
});

3 · Nebo přes curl

Nepotřebuješ SDK? API je obyčejné JSON přes HTTP. Stejná pole, stejná odpověď — SDK je jen tenký obal kolem stejného endpointu.

curl -X POST https://invoice.codurra.com/api/invoices/generate \
  -H "Content-Type: application/json" \
  -d '{
    "invoiceSettings": { "licenseKey": "YOUR_LICENSE_KEY" },
    "supplier":  { "name": "Acme Ltd" },
    "purchaser": { "name": "Globex" },
    "invoiceDetails": {
      "invoiceNr":  "INV-2026-001",
      "issueDate":  "2026-06-15",
      "dueDate":    "2026-06-29",
      "currency":   "EUR"
    },
    "items": [
      { "item": "Web design", "quantity": 1, "unitCost": 1200 }
    ]
  }'

Kompletní dokumentace a ukázky jsou k dispozici po přihlášení.