Συνδέστε το e-shop σας με το API και τα webhooks

Έχετε e-shop ή δικό σας σύστημα; Με το REST API του Olvano τιμολογείτε χωρίς χειροκίνητα κλικ, και με τα webhooks μαθαίνετε αμέσως τι συμβαίνει σε ένα τιμολόγιο.

Token API

Πιστοποιείτε τις κλήσεις με ένα token στην κεφαλίδα Authorization: Bearer …. Το token δημιουργείται από τον κάτοχο του λογαριασμού, ανήκει σε έναν ακριβώς λογαριασμό και φέρει τα δικά του scopes (invoices, expenses, reports). Το απλό κείμενο εμφανίζεται μόνο μία φορά — αποθηκεύεται μόνο ένα 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 } ] }'

Webhooks

Αντί να ρωτάτε το API ξανά και ξανά, αφήστε τα συμβάντα να σας αποστέλλονται. Καταχωρείτε ένα URL και επιλέγετε τα συμβάντα (ή * για όλα):

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

• Κάθε παράδοση φέρει μια κεφαλίδα Idempotency-Key (UUID) — χρησιμοποιήστε την για την απαλοιφή διπλότυπων.
• Ορίστε το δικό σας authHeader για να επαληθεύσετε ότι ένα αίτημα προήλθε πράγματι από το Olvano.
• Μια αποτυχημένη παράδοση επαναλαμβάνεται έως 5 φορές με εκθετική υποχώρηση.