Developers

Ligue a sua loja online com a API e os webhooks

O Olvano tem uma API REST e webhooks — emita faturas de forma programática e reaja aos eventos em tempo real.

Petr Svoboda

·02/06/2026

Tem uma loja online ou um sistema próprio? Com a API REST do Olvano fatura sem cliques manuais, e com os webhooks fica a saber de imediato o que acontece a uma fatura.

Token de API

Autentica as chamadas com um token no cabeçalho Authorization: Bearer …. O token é criado pelo proprietário da conta, pertence a uma única conta e traz os seus próprios scopes (invoices, expenses, reports). O texto simples é mostrado apenas uma vez — só é guardado um 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

Em vez de consultar a API repetidamente, deixe que os eventos lhe sejam enviados. Regista um URL e escolhe os eventos (ou * 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 traz um cabeçalho Idempotency-Key (UUID) — use-o para eliminar duplicados.
Defina o seu próprio authHeader para verificar que um pedido veio mesmo do Olvano.
Uma entrega falhada é repetida até 5 vezes com recuo exponencial.