Naar inhoud

Meldingen ontvangen met webhooks

Stuur een ondertekend bericht naar een andere app wanneer een factuur wordt uitgegeven, een betaling wordt geboekt, de voorraad laag wordt en meer.

5 min leestijd Echte schermen, fictieve voorbeeldgegevens Bijgewerkt 22 oktober 2026

Op deze pagina

Een webhook is een bericht dat we via POST naar het adres van uw app sturen wanneer er iets in uw bedrijf gebeurt, zodat de andere app niet steeds hoeft te vragen.

  1. Stap 1: Een endpoint toevoegen

    Klik in Administratie → Instellingen → API & webhooks, onder Webhooks, op Endpoint toevoegen.

  2. Stap 2: Het adres invullen

    Vul de Endpoint-URL in (dit moet een openbaar https://-adres zijn) en eventueel een Omschrijving.

  3. Stap 3: De gebeurtenissen kiezen

    Vink onder Gebeurtenissen de gebeurtenissen aan die u nodig hebt, of Alle gebeurtenissen, ook later toegevoegde.

  4. Stap 4: Het ondertekeningsgeheim kopiëren

    Na het opslaan wordt het Ondertekeningsgeheim één keer getoond. Kopieer het naar de ontvangende app zodat die kan controleren of elk bericht echt van ons komt.

  5. Stap 5: Testen

    Klik op Testgebeurtenis verzenden en controleer het Afleverlogboek.

Beschikbare gebeurtenissen

  • Contacten: een contact is aangemaakt of bijgewerkt.
  • Facturen: uitgegeven, volledig betaald, ingetrokken. Offertes: geaccepteerd.
  • Betalingen: een betaling of ontvangst is geboekt.
  • Inkoopfacturen: ontvangen (geboekt), volledig betaald. Uitgaven: een uitgave is geregistreerd.
  • Voorraad: een artikel is gedaald tot of onder het bestelniveau.
  • Verlof: er is een verlofaanvraag aangemaakt.

Aflevering en nieuwe pogingen

  • Uw app moet binnen 10 seconden antwoorden met een 2xx-status. Alles anders telt als mislukt.
  • Mislukte afleveringen worden automatisch opnieuw geprobeerd, tot zes pogingen verspreid over enkele uren, met telkens langere wachttijden.
  • Open een endpoint met Beheren om het Afleverlogboek te zien: elke gebeurtenis met de Payload, het Antwoord van uw server en een status Geleverd, Mislukt of In afwachting. Klik op Opnieuw verzenden om er een opnieuw te sturen.
  • Vink Gebeurtenissen naar dit endpoint verzenden uit om het te pauzeren, of klik op Verwijderen om het te verwijderen. Een endpoint dat lange tijd blijft mislukken, wordt automatisch uitgeschakeld.

De handtekening verifiëren

Elke aflevering heeft de header X-Webhook-Signature: t=<timestamp>,v1=<signature>. Bereken HMAC-SHA256 van “<timestamp>.<raw body>” met uw ondertekeningsgeheim en vergelijk het met v1; weiger tijdstempels ouder dan 5 minuten. X-Webhook-Id blijft bij nieuwe pogingen hetzelfde, dus gebruik het om dubbele berichten te negeren.

Vraag over het product

Vraag wat de software kan, hoe een taak werkt, of welke landen en talen worden ondersteund. Antwoorden komen uit deze handleidingen.

Bezig met nadenken…

De AI-assistent is op dit moment niet beschikbaar. Doorzoek de handleidingen of neem contact op met ons team. Contact met support

AI kan fouten maken. Controleer de gelinkte handleidingen.

Nog hulp nodig?

Ons supportteam leest elk bericht en antwoordt in begrijpelijke taal.

Contact met support
Chat met AI