Koppla din webbshop med API:et och webhooks

Har du en webbshop eller ett eget system? Med Olvanos REST-API fakturerar du utan manuellt klickande, och med webhooks får du veta direkt vad som händer med en faktura.

API-token

Autentisera anrop med en token i Authorization: Bearer …-headern. Token skapas av kontoägaren, hör till exakt ett konto och bär sina egna scopes (invoices, expenses, reports). Klartexten visas bara en gång — endast en hash sparas.

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

I stället för att fråga API:et om och om igen kan du få händelser skickade till dig. Registrera en URL och välj händelserna (eller * för alla):

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

• Varje leverans bär en Idempotency-Key-header (UUID) — använd den för att ta bort dubbletter.
• Ange din egen authHeader för att verifiera att en förfrågan verkligen kom från Olvano.
• En misslyckad leverans görs om upp till 5 gånger med exponentiell backoff.