Aviseringar (webhooks)

Bli meddelad i stället för att fråga: händelser, signaturverifiering, omförsök och hur ni undviker dubbletter.

I stället för att fråga oss om och om igen kan ni bli aviserade när något händer. Ni pekar ut en adress, vi skickar ett signerat anrop dit.

Uppsättning

Lägg upp mottagaren under Integrationer i ert konto, eller via API med scope webhooks:manage. Ni får en hemlighet — spara den, den visas bara en gång.

Välj vilka händelser ni vill ha. Prenumerera bara på det ni faktiskt använder.

Händelser

Händelse	När
`document.received`	Ett dokument har kommit in
`document.parsed`	Tolkningen är klar
`document.needs_review`	Något fält var osäkert
`document.verified`	En människa har godkänt dokumentet
`document.failed`	Tolkningen misslyckades
`staff_entry.submitted`	Personal har skickat in tid, resa eller utlägg
`staff_entry.approved`	Chefen har attesterat
`staff_entry.rejected`	Chefen har avvisat

Så ser anropet ut

{
  "schema_version": 2,
  "event": "document.parsed",
  "occurred_at": "2026-01-15T10:00:00.000Z",
  "document": { "id": "…", "document_type": "supplier_invoice",
                "tenant_ref": "nordbutik-linkoping", "status": "parsed" },
  "invoice": { "invoice_number": "8812", "total_inc_vat": 1249.00,
               "vat_amount": 249.80, "currency": "SEK", "due_date": "2026-02-14" }
}

Belopp är tal. Saknade värden är null.

Verifiera signaturen

Varje anrop bär en HMAC-signatur beräknad på kroppen med er hemlighet. Räkna ut samma värde själva och jämför innan ni gör något med innehållet — annars kan vem som helst som känner till er adress skicka påhittade händelser.

Omförsök

Svara 2xx inom rimlig tid. Gör ni inte det försöker vi igen med växande mellanrum: 60 sekunder, 5 minuter, 30 minuter, 2 timmar, 6 timmar, 12 timmar, 24 timmar. Därefter läggs leveransen som död och syns i er leveranslogg.

Dubbletter