Vero
DevelopersDashboard

Webhooks

Receba notificações em tempo real sobre eventos de facturação, pagamentos e estado de documentos.

Estrutura do Evento

O Vero envia um POST HTTPS para o URL configurado com o seguinte payload JSON:

Payload Example

JSON
{
  "event": "invoice.issued",
  "orgId": "779b90ce-...",
  "timestamp": "2026-07-07T10:00:00.000Z",
  "data": {
    "id": "a1b2c3d4-...",
    "number": "FR FR6326S47071N/1",
    "status": "issued",
    "total": 15000000,
    "pdfUrl": "https://api.vero.ao/v1/public/invoices/a1b2c3d4-.../pdf"
  }
}

data.pdfUrl em eventos de factura é um link público, sem necessidade de autenticação - pode ser usado directamente num email ou aberto pelo utilizador final. Gerado na hora a cada pedido, não fica em storage.

data é o próprio documento (mesma forma da resposta da API), não um objecto aninhado.

Eventos Suportados

invoice.issuedEmitido quando uma factura é assinada e certificada.
invoice.cancelledEmitido quando uma factura é anulada (gera Nota de Crédito).
proforma.convertedEmitido quando um orçamento é convertido em factura.
proforma.cancelledEmitido quando um orçamento é anulado.