Pro vývojáře

Napojte e-shop přes API a webhooky

Olvano má REST API a webhooky — vystavujte faktury programově a reagujte na události v reálném čase.

Petr Svoboda

·2. 6. 2026

Máte e-shop nebo vlastní systém? Přes REST API Olvano fakturujete bez ručního klikání a přes webhooky se hned dozvíte, co se s fakturou děje.

API token

Volání autentizujete tokenem v hlavičce Authorization: Bearer …. Token vytváří vlastník účtu, patří právě jednomu účtu a nese vlastní oprávnění (scopes: invoices, expenses, reports). Plaintext se zobrazí jen jednou — uloží se z něj jen otisk.

curl -X POST "$STARGATE/api/accounts/$SLUG/invoices" \
  -H "Authorization: Bearer sg_vas_token" \
  -H "Content-Type: application/json" \
  -d '{ "subjectId": "ID", "lines": [ { "name": "Položka", "unitPrice": "1000", "vatRate": 21 } ] }'

Webhooky

Místo abyste se API dokola ptali, necháte si události poslat. Zaregistrujete URL a vyberete události (nebo * pro všechny):

invoice_created, invoice_sent, invoice_paid, invoice_overdue, invoice_cancelled, invoice_uncollectible, invoice_viewed, invoice_reminder_sent, recurring_generator_invoice_created.

Každé doručení nese hlavičku Idempotency-Key (UUID) — použijte ji k deduplikaci.
Nastavíte-li vlastní authHeader, ověříte si, že request je opravdu od Olvano.
Neúspěšné doručení se opakuje až 5× s exponenciálním odstupem.