Overslaan naar inhoud
Nederlands
Klantenportal
  • Er zijn geen suggesties want het zoekveld is leeg.

Webhooks instellen

Met webhooks koppel je Minox Focus automatisch aan externe systemen. Zo kun je gegevens realtime verwerken in je eigen applicatie of integratie.

Wat kun je met Webhooks doen?

  • Een webhook-URL registreren waar Minox meldingen naartoe stuurt

  • Instellen voor welke gebeurtenissen je notificaties ontvangt

  • Webhooks activeren of tijdelijk uitschakelen

  • Automatisch opnieuw laten proberen bij een mislukte levering

  • E-mailmeldingen ontvangen bij foutmeldingen (HTTP 4xx en 5xx)

  • De verzendgeschiedenis per webhook inzien via het tabblad Historie

Een webhook aanmaken en instellen

Met een webhook zorg je ervoor dat Minox automatisch een melding verstuurt naar een externe applicatie. Hieronder lees je hoe je een webhook aanmaakt en configureert.

Stap 1: Ga naar Webhooks

  1. Ga naar Inrichting.

  2. Klik op Koppelingen.

  3. Kies onder Meer voor Webhooks.

Je ziet nu het overzicht van bestaande webhooks.

Stap 2: Maak een nieuwe webhook aan

  1. Klik op het plus-icoon om een nieuwe webhook toe te voegen.

  2. Open de aangemaakte webhook.

Het scherm opent op het tabblad Algemeen.

Stap 3: Vul de basisgegevens in

Onder Basisgegevens:

  1. Vul bij Omschrijving een herkenbare naam in.

  2. Vul bij URL de endpoint-URL in waar Minox de notificaties naartoe moet sturen.

    • De URL moet beginnen met http:// of https://.

  3. Vink Webhook actief aan om de webhook in te schakelen.

Let op: zonder geldige URL kan de webhook niet worden opgeslagen of geactiveerd.

Stap 4: Kies de notificaties

Onder Notificaties geef je aan waarvoor Minox meldingen moet versturen:

  • Openstaande posten van debiteuren

  • Openstaande posten van crediteuren

Vink aan welke gebeurtenissen je wilt ontvangen.

Stap 5: Stel signalering in

Onder Signalering kun je instellen wat er gebeurt bij fouten:

  • Opnieuw proberen (in minuten)
    Geef aan na hoeveel minuten Minox een mislukte verzending opnieuw probeert.

  • E-mailadres bij status 400–499
    Ontvang een melding bij clientfouten.

  • E-mailadres bij status 500–599
    Ontvang een melding bij serverfouten.

Stap 6: Opslaan

Sla de webhook op via het opslaan-icoon.

De webhook is nu actief (indien aangevinkt) en verzendt notificaties volgens de ingestelde configuratie.

Historie bekijken

Via het tabblad Historie kun je per webhook zien:

  • Of de verzending is geslaagd

  • Welke statuscode is teruggegeven

  • Welk type notificatie is verzonden

Zo kun je eenvoudig controleren of de koppeling correct functioneert.