Developers

Conecta tu tienda online con la API y los webhooks

Olvano tiene una API REST y webhooks — emite facturas de forma programática y reacciona a los eventos en tiempo real.

Petr Svoboda

·2/6/2026

¿Tienes una tienda online o tu propio sistema? Con la API REST de Olvano facturas sin clics manuales, y con los webhooks te enteras al instante de lo que le pasa a una factura.

Token de API

Autenticas las llamadas con un token en la cabecera Authorization: Bearer …. El token lo crea el propietario de la cuenta, pertenece a una sola cuenta y lleva sus propios scopes (invoices, expenses, reports). El texto en claro se muestra una sola vez — solo se almacena 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 } ] }'

Webhooks

En lugar de consultar la API una y otra vez, haz que te envíen los eventos. Registras una URL y eliges los eventos (o * para todos):

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

Cada entrega lleva una cabecera Idempotency-Key (UUID) — úsala para deduplicar.
Configura tu propio authHeader para verificar que una petición proviene realmente de Olvano.
Una entrega fallida se reintenta hasta 5 veces con retroceso exponencial.