Dokumentation til BizCortex

Webhooks

Giv automatisk andre systemer besked, når der sker noget, for eksempel en ny faktura.

En webhook sender en signeret POST forespørgsel til en URL efter eget valg, hver gang en af de valgte hændelser indtræffer. Åbn "Indstillinger" og fanen "Webhooks". Tabellen viser URL'en, hændelserne, seneste levering med tidspunkt og svarkode samt status Aktiv eller Inaktiv.

Webhooks
Skærmbillede af denne visning

Hvem kan bruge det

  • Ejer
  • Administrator

Trin

  1. 1. Tilføj en webhook

    Klik på "Tilføj webhook". Angiv URL'en, sæt flueben ved mindst én hændelse, tilføj eventuelt en beskrivelse, og lad "Aktiv" være slået til. Gem.

  2. 2. Giv hemmeligheden til modtageren

    Åbn menuen i rækken, og vælg "Vis hemmelighed". Hver forespørgsel signeres med denne hemmelighed med HMAC SHA256. Det modtagende system kontrollerer signaturen for at sikre, at forespørgslen kommer fra BizCortex.

  3. 3. Redigér eller sæt på pause

    Vælg "Rediger" for at ændre URL, hændelser eller beskrivelse. Slå "Aktiv" fra for at stoppe leverancer uden at slette webhooken.

  4. 4. Rotér hemmeligheden

    Vælg "Rotér hemmelighed", hvis hemmeligheden kan være lækket. Opdatér det modtagende system med den nye hemmelighed.

  5. 5. Slet

    Vælg "Slet", og bekræft.

Felter og valgmuligheder

URL

Skal begynde med http:// eller https://. Op til 1000 tegn.

Hændelser

Vælg mellem: * (alle hændelser), sales.invoice.* (alle fakturahændelser), sales.invoice.created, sales.invoice.posted, sales.invoice.cancelled, sales.payment.recorded, purchasing.bill.posted, accounting.transaction.posted og accounting.transaction.reversed.

Beskrivelse

Valgfri note.

Aktiv

Kun aktive webhooks modtager hændelser.

Tips

  • Hvis seneste levering vises med rødt, kan du holde musen over den for at se den fejl, modtageren returnerede.

Godt at vide

  • Hver forespørgsel indeholder hændelsens navn, din virksomheds id og hændelsesdataene som JSON.
  • Modtageren har 10 sekunder til at svare. Hvis en levering fejler, prøver BizCortex igen op til 5 gange med stigende pauser (30 sekunder, derefter 1, 2, 4 og 8 minutter).

Relateret