Developers

Połącz swój e-sklep przez API i webhooki

Olvano ma REST API i webhooki — wystawiaj faktury programowo i reaguj na zdarzenia w czasie rzeczywistym.

Petr Svoboda

·2.06.2026

Masz e-sklep albo własny system? Dzięki REST API Olvano fakturujesz bez ręcznego klikania, a dzięki webhookom od razu wiesz, co dzieje się z fakturą.

Token API

Wywołania uwierzytelniasz tokenem w nagłówku Authorization: Bearer …. Token tworzy właściciel konta, należy on do dokładnie jednego konta i niesie własne uprawnienia (scopes: invoices, expenses, reports). Jawny tekst jest pokazywany tylko raz — przechowywany jest z niego jedynie skrót.

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 } ] }'

Webhooki

Zamiast odpytywać API w kółko, pozwól, by zdarzenia były wysyłane do Ciebie. Zarejestruj URL i wybierz zdarzenia (lub * dla wszystkich):

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

Każde doręczenie niesie nagłówek Idempotency-Key (UUID) — użyj go do deduplikacji.
Ustaw własny authHeader, aby potwierdzić, że żądanie naprawdę pochodzi od Olvano.
Nieudane doręczenie jest ponawiane do 5 razy z wykładniczym odstępem.