Developers

Collega il tuo e-shop con l'API e i webhook

Olvano ha un'API REST e i webhook — emetti fatture in modo programmatico e reagisci agli eventi in tempo reale.

02/06/2026

Hai un e-shop o un sistema tuo? Con l'API REST di Olvano fatturi senza clic manuali e con i webhook scopri all'istante cosa succede a una fattura.

Token API

Autentichi le chiamate con un token nell'header Authorization: Bearer …. Il token viene creato dal proprietario dell'account, appartiene a un solo account e porta con sé i propri scope (invoices, expenses, reports). Il testo in chiaro viene mostrato una sola volta — ne viene memorizzato solo 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

Invece di interrogare di continuo l'API, fai inviare gli eventi a te. Registri un URL e scegli gli eventi (oppure * per tutti):

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

Ogni consegna porta un header Idempotency-Key (UUID) — usalo per la deduplicazione.
Imposta il tuo authHeader per verificare che una richiesta provenga davvero da Olvano.
Una consegna fallita viene ritentata fino a 5 volte con backoff esponenziale.