Dokumentation för BizCortex

Webhooks

Meddela andra system automatiskt när händelser inträffar, till exempel en ny faktura.

En webhook skickar en signerad POST begäran till en URL som du väljer varje gång någon av de valda händelserna inträffar. Öppna "Inställningar" och fliken "Webhooks". Tabellen visar URL, händelser, senaste leverans med tid och svarskod samt statusen Aktiv eller Inaktiv.

Webhooks
Skärmbild av den här vyn

Vem kan använda detta

  • Ägare
  • Administratör

Steg

  1. 1. Lägg till en webhook

    Klicka på "Lägg till webhook". Ange URL, markera minst en händelse, lägg till en valfri beskrivning och låt "Aktiv" vara på. Spara.

  2. 2. Ge hemligheten till mottagaren

    Öppna radmenyn och välj "Visa hemlighet". Varje begäran signeras med den här hemligheten med HMAC SHA256. Det mottagande systemet kontrollerar signaturen för att säkerställa att begäran kommer från BizCortex.

  3. 3. Redigera eller pausa

    Välj "Redigera" för att ändra URL, händelser eller beskrivning. Stäng av "Aktiv" för att stoppa leveranser utan att ta bort webhooken.

  4. 4. Byt hemligheten

    Välj "Byt hemlighet" om hemligheten kan ha läckt. Uppdatera det mottagande systemet med den nya hemligheten.

  5. 5. Ta bort

    Välj "Ta bort" och bekräfta.

Fält och alternativ

URL

Måste börja med http:// eller https://. Upp till 1000 tecken.

Händelser

Välj bland: * (alla händelser), sales.invoice.* (alla fakturahändelser), sales.invoice.created, sales.invoice.posted, sales.invoice.cancelled, sales.payment.recorded, purchasing.bill.posted, accounting.transaction.posted och accounting.transaction.reversed.

Beskrivning

Valfri anteckning.

Aktiv

Bara aktiva webhooks tar emot händelser.

Tips

  • Om den senaste leveransen visas i rött kan du hålla muspekaren över den för att se felet som mottagaren returnerade.

Bra att veta

  • Varje begäran innehåller händelsens namn, ditt företags id och händelsedata som JSON.
  • Mottagaren har 10 sekunder på sig att svara. Om en leverans misslyckas försöker BizCortex igen upp till 5 gånger med allt längre pauser (30 sekunder, sedan 1, 2, 4 och 8 minuter).

Relaterat