Developers

Conectați-vă magazinul online prin API și webhook-uri

Olvano are un API REST și webhook-uri — emiteți facturi programatic și reacționați la evenimente în timp real.

Petr Svoboda

·02.06.2026

Aveți un magazin online sau un sistem propriu? Cu API-ul REST al Olvano facturați fără clicuri manuale, iar cu webhook-urile aflați instantaneu ce se întâmplă cu o factură.

Token API

Autentificați apelurile cu un token în antetul Authorization: Bearer …. Tokenul este creat de proprietarul contului, aparține exact unui singur cont și poartă propriile permisiuni (scopes: invoices, expenses, reports). Textul în clar se afișează o singură dată — se stochează doar un 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 } ] }'

Webhook-uri

În loc să interogați API-ul în mod repetat, lăsați evenimentele să vă fie trimise. Înregistrați o adresă URL și alegeți evenimentele (sau * pentru toate):

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

Fiecare livrare poartă un antet Idempotency-Key (UUID) — folosiți-l pentru deduplicare.
Setați-vă propriul authHeader pentru a verifica faptul că o cerere provine cu adevărat de la Olvano.
O livrare eșuată este reîncercată de până la 5 ori, cu interval exponențial crescător.