Developers

Verbinden Sie Ihren Onlineshop über API und Webhooks

Olvano bietet eine REST-API und Webhooks — stellen Sie Rechnungen programmatisch aus und reagieren Sie in Echtzeit auf Ereignisse.

Petr Svoboda

·2.6.2026

Haben Sie einen Onlineshop oder ein eigenes System? Mit der REST-API von Olvano fakturieren Sie ohne manuelles Klicken, und über Webhooks erfahren Sie sofort, was mit einer Rechnung geschieht.

API-Token

Authentifizieren Sie Aufrufe mit einem Token im Header Authorization: Bearer …. Das Token wird vom Kontoinhaber erstellt, gehört zu genau einem Konto und trägt eigene Scopes (invoices, expenses, reports). Der Klartext wird nur einmal angezeigt — gespeichert wird nur ein Hash.

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

Webhooks

Anstatt die API ständig abzufragen, lassen Sie sich Ereignisse zusenden. Registrieren Sie eine URL und wählen Sie die Ereignisse aus (oder * für alle):

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

Jede Zustellung trägt einen Header Idempotency-Key (UUID) — nutzen Sie ihn zur Deduplizierung.
Legen Sie einen eigenen authHeader fest, um zu überprüfen, dass eine Anfrage wirklich von Olvano stammt.
Eine fehlgeschlagene Zustellung wird bis zu 5-mal mit exponentiellem Backoff wiederholt.