> ## Documentation Index
> Fetch the complete documentation index at: https://www.zippendo.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Mislukte webhook-afleveringen

> Wat je doet als Zippendo-webhooks je systeem niet bereiken, fouten tonen in het afleverlog of meer dan één keer binnenkomen.

Met een webhook laat Zippendo een ander systeem weten dat er een gebeurtenis heeft plaatsgevonden, zoals **Zending verzonden** of **Track & trace bijgewerkt**. Je stelt webhooks in onder **Instellingen** → **Webhooks** (open het organisatiemenu en klik op **Beheren**). Voor elke gebeurtenis stuurt Zippendo een bericht naar de **Endpoint-URL** die je hebt ingevuld.

Dit zijn geen track-&-tracewebhooks van vervoerders. Daarvoor, zie [Tracking-webhooks van vervoerders](/docs/nl/how-to/tracking-webhooks).

## Wat je ziet

* Je systeem ontvangt helemaal niets.
* Het **Afleverlog** van een webhook toont rode statuscodes of tekst in de kolom **Fout**.
* Je systeem ontvangt dezelfde gebeurtenis meer dan één keer.

## Controleer eerst het afleverlog

Klik bij **Webhooks** op **Afleverlog** bij de webhook. Elke rij is één poging, met de **Gebeurtenis**, de **Status** waarmee je systeem antwoordde, de **Duur** en eventuele **Fout**.

* **Nog geen afleveringen**: Zippendo heeft nog niets geprobeerd te verzenden. Zie “Er wordt niets verzonden” hieronder.
* Een groene status: je systeem heeft het bericht ontvangen. Zoek het probleem in je eigen systeem.
* Een rode status of **n.v.t.** met een fout: je systeem heeft het bericht niet geaccepteerd. Zie “Afleveringen mislukken” hieronder.

## Er wordt niets verzonden

| Waarschijnlijke oorzaak | Wat je doet |
| - | - |
| De webhook is **Inactief** | Klik bij de webhook op **Bewerken** en zet **Actief** aan. Een inactieve webhook verzendt niets en logt niets. **Test verzenden** verzendt ook niets, ook al toont het **Testgebeurtenis verzonden** |
| De gebeurtenis is niet aangevinkt | Klik op **Bewerken** en controleer of de gebeurtenis is aangevinkt onder **Gebeurtenissen** |
| De gebeurtenis heeft niet plaatsgevonden | **Zending verzonden** wordt bijvoorbeeld alleen verzonden als een zending echt naar de vervoerder is gestuurd |

## Afleveringen mislukken

Zippendo telt een aflevering alleen als geslaagd als je systeem binnen 10 seconden antwoordt met een succesvolle status (200-299). Anders probeert het binnen ongeveer een minuut nog een paar keer opnieuw, in totaal 5 pogingen. Daarna wordt de gebeurtenis niet meer verzonden.

| Wat het afleverlog toont | Waarschijnlijke oorzaak | Wat je doet |
| - | - | - |
| 404 | De **Endpoint-URL** is onjuist, of het adres is aan jouw kant gewijzigd | Corrigeer de **Endpoint-URL** onder **Bewerken** |
| 401 of 403 | Je systeem vraagt om een wachtwoord of token, of blokkeert onbekende afzenders | Laat berichten van Zippendo door en controleer ze in plaats daarvan met de handtekening (zie hieronder) |
| 500-599 | Je systeem crashte bij het verwerken van het bericht | Bekijk het foutenlogboek van je systeem |
| **n.v.t.** met een timeoutfout | Je systeem deed er langer dan 10 seconden over om te antwoorden | Antwoord direct en doe het trage werk daarna |
| **n.v.t.** met een verbindingsfout | Het adres is niet bereikbaar vanaf internet, of het certificaat is ongeldig | Gebruik een openbaar `https://`-adres met een geldig certificaat |

Klik nadat je de oorzaak hebt verholpen bij de webhook op **Test verzenden**. Je ziet **Testgebeurtenis verzonden** en er verschijnt een nieuwe rij in het **Afleverlog**.

<Note>
  Zippendo verzendt mislukte gebeurtenissen later niet opnieuw. Was je systeem een tijdje offline, zoek de zendingen of bestellingen die je hebt gemist dan op in de Zippendo-app, of haal ze op via de API.
</Note>

## Je systeem weigert de handtekening

Elk bericht heeft een `X-Webhook-Signature`-header, zodat je systeem kan controleren dat het echt van Zippendo komt. Het is een HMAC-SHA256 van de ruwe berichtinhoud, gemaakt met het secret van de webhook. Veelgemaakte fouten:

* De handtekening wordt berekend over het bericht nadat het is verwerkt en herschreven, in plaats van over de ruwe inhoud precies zoals ontvangen.
* Het secret van een andere webhook wordt gebruikt. Elke webhook heeft zijn eigen secret.

Details en codevoorbeelden: [Snelstart voor webhooks](/docs/nl/quickstarts/webhooks).

## Dezelfde gebeurtenis komt twee keer binnen

Antwoordde je systeem te traag of met een fout, dan probeert Zippendo het opnieuw, ook als je systeem de eerste poging wel heeft verwerkt. Gebruik de header `X-Webhook-Id` om een bericht te herkennen dat je al hebt verwerkt.

Gerelateerd: [Webhooks](/docs/nl/how-to/webhooks), [Webhookinstellingen](/docs/nl/settings/webhooks).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.