Developers

Prijunkite savo el. parduotuvę per API ir webhook'us

Olvano turi REST API ir webhook'us — išrašykite sąskaitas programiškai ir reaguokite į įvykius realiuoju laiku.

Petr Svoboda

·2026-06-02

Turite el. parduotuvę ar savo sistemą? Su Olvano REST API sąskaitas išrašote be rankinio spaudinėjimo, o su webhook'ais iškart sužinote, kas vyksta su sąskaita.

API raktas

Užklausas autentikuokite raktu antraštėje Authorization: Bearer …. Raktą sukuria paskyros savininkas, jis priklauso lygiai vienai paskyrai ir turi savo teises (scopes: invoices, expenses, reports). Atviras tekstas parodomas tik vieną kartą — iš jo saugoma tik maiša.

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

Webhook'ai

Užuot nuolat klausinėję API, leiskite įvykius siųsti jums. Užregistruokite URL ir pasirinkite įvykius (arba * visiems):

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

Kiekvienas pristatymas turi antraštę Idempotency-Key (UUID) — naudokite ją dublikatams pašalinti.
Nustatykite savo authHeader, kad įsitikintumėte, jog užklausa tikrai atėjo iš Olvano.
Nepavykęs pristatymas kartojamas iki 5 kartų su eksponentine pertrauka.