Dokumentasjon for BizCortex

Webhooks

Varsle andre systemer automatisk når hendelser skjer, for eksempel en ny faktura.

En webhook sender en signert POST forespørsel til en URL du velger, hver gang en av de valgte hendelsene skjer. Åpne "Innstillinger" og fanen "Webhooks". Tabellen viser URL, hendelsene, den siste leveringen med tidspunkt og svarkode, og statusen Aktiv eller Inaktiv.

Webhooks
Skjermbilde av denne visningen

Hvem kan bruke dette

  • Eier
  • Administrator

Steg

  1. 1. Legg til en webhook

    Klikk "Legg til webhook". Skriv inn URLen, kryss av for minst én hendelse, legg eventuelt til en beskrivelse og la "Aktiv" være på. Lagre.

  2. 2. Gi hemmeligheten til mottakeren

    Åpne radmenyen og velg "Vis hemmelighet". Hver forespørsel signeres med denne hemmeligheten med HMAC SHA256. Mottakersystemet kontrollerer signaturen for å sikre at forespørselen kommer fra BizCortex.

  3. 3. Rediger eller sett på pause

    Velg "Rediger" for å endre URL, hendelser eller beskrivelse. Slå av "Aktiv" for å stoppe leveringer uten å slette webhooken.

  4. 4. Roter hemmeligheten

    Velg "Roter hemmelighet" hvis hemmeligheten kan ha lekket. Oppdater mottakersystemet med den nye hemmeligheten.

  5. 5. Slett

    Velg "Slett" og bekreft.

Felt og valg

URL

Må starte med http:// eller https://. Opptil 1000 tegn.

Hendelser

Velg blant: * (alle hendelser), sales.invoice.* (alle fakturahendelser), sales.invoice.created, sales.invoice.posted, sales.invoice.cancelled, sales.payment.recorded, purchasing.bill.posted, accounting.transaction.posted og accounting.transaction.reversed.

Beskrivelse

Valgfritt notat.

Aktiv

Bare aktive webhooks mottar hendelser.

Tips

  • Hvis den siste leveringen vises i rødt, holder du musepekeren over den for å se feilen mottakeren returnerte.

Greit å vite

  • Hver forespørsel inneholder hendelsesnavnet, selskapets ID og hendelsesdataene som JSON.
  • Mottakeren har 10 sekunder på å svare. Hvis en levering mislykkes, prøver BizCortex på nytt opptil 5 ganger med økende pauser (30 sekunder, deretter 1, 2, 4 og 8 minutter).

Relatert