> ## 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.

# Fehlgeschlagene Webhook-Zustellungen

> Was du tun kannst, wenn Zippendo-Webhooks dein System nicht erreichen, im Zustellprotokoll Fehler zeigen oder mehrfach ankommen.

Ein Webhook lässt Zippendo ein anderes System über ein Ereignis informieren, zum Beispiel **Sendung versendet** oder **Sendungsverfolgung aktualisiert**. Webhooks richtest du unter **Einstellungen** → **Webhooks** ein (öffne das Organisationsmenü und klicke auf **Verwalten**). Für jedes Ereignis sendet Zippendo eine Nachricht an die **Endpunkt-URL**, die du eingegeben hast.

Das sind keine Webhooks zur Sendungsverfolgung der Versanddienstleister. Zu diesen siehe [Webhooks zur Sendungsverfolgung](/docs/de/how-to/tracking-webhooks).

## Was du siehst

* Dein System empfängt nie etwas.
* Das **Zustellprotokoll** eines Webhooks zeigt rote Statuscodes oder Text in der Spalte **Fehler**.
* Dein System empfängt dasselbe Ereignis mehrmals.

## Zuerst das Zustellprotokoll prüfen

Klicke bei **Webhooks** beim Webhook auf **Zustellprotokoll**. Jede Zeile ist ein Versuch, mit dem **Ereignis**, dem **Status**, mit dem dein System geantwortet hat, der **Dauer** und eventuell einem **Fehler**.

* **Noch keine Zustellungen**: Zippendo hat noch nichts zu senden versucht. Siehe „Es wird nichts gesendet“ unten.
* Ein grüner Status: Dein System hat die Nachricht empfangen. Suche das Problem in deinem eigenen System.
* Ein roter Status oder **k. A.** mit einem Fehler: Dein System hat die Nachricht nicht akzeptiert. Siehe „Zustellungen schlagen fehl“ unten.

## Es wird nichts gesendet

| Wahrscheinliche Ursache | Was du tun kannst |
| - | - |
| Der Webhook ist **Inaktiv** | Klicke beim Webhook auf **Bearbeiten** und schalte **Aktiv** ein. Ein inaktiver Webhook sendet nichts und protokolliert nichts. Auch **Test senden** sendet nichts, obwohl es **Testereignis gesendet** anzeigt |
| Das Ereignis ist nicht angehakt | Klicke auf **Bearbeiten** und prüfe, ob das Ereignis unter **Ereignisse** angehakt ist |
| Das Ereignis ist nicht eingetreten | **Sendung versendet** wird zum Beispiel nur gesendet, wenn eine Sendung tatsächlich an den Versanddienstleister gesendet wird |

## Zustellungen schlagen fehl

Zippendo wertet eine Zustellung nur dann als erfolgreich, wenn dein System innerhalb von 10 Sekunden mit einem Erfolgsstatus (200-299) antwortet. Andernfalls versucht es innerhalb von etwa einer Minute noch einige Male, insgesamt 5 Versuche. Danach wird das Ereignis nicht erneut gesendet.

| Was das Zustellprotokoll zeigt | Wahrscheinliche Ursache | Was du tun kannst |
| - | - | - |
| 404 | Die **Endpunkt-URL** ist falsch, oder die Adresse hat sich auf deiner Seite geändert | Korrigiere die **Endpunkt-URL** unter **Bearbeiten** |
| 401 oder 403 | Dein System verlangt ein Passwort oder einen Token oder blockiert unbekannte Absender | Lass Nachrichten von Zippendo durch und prüfe sie stattdessen anhand der Signatur (siehe unten) |
| 500-599 | Dein System ist beim Verarbeiten der Nachricht abgestürzt | Prüfe das Fehlerprotokoll deines Systems |
| **k. A.** mit einem Timeout-Fehler | Dein System hat länger als 10 Sekunden zum Antworten gebraucht | Antworte sofort und erledige die langsame Arbeit danach |
| **k. A.** mit einem Verbindungsfehler | Die Adresse ist aus dem Internet nicht erreichbar, oder ihr Zertifikat ist ungültig | Nutze eine öffentliche `https://`-Adresse mit gültigem Zertifikat |

Klicke nach der Behebung der Ursache beim Webhook auf **Test senden**. Du siehst **Testereignis gesendet**, und im **Zustellprotokoll** erscheint eine neue Zeile.

<Note>
  Zippendo sendet fehlgeschlagene Ereignisse später nicht erneut. Wenn dein System eine Weile nicht erreichbar war, suche die verpassten Sendungen oder Bestellungen in der Zippendo-App oder rufe sie über die API ab.
</Note>

## Dein System lehnt die Signatur ab

Jede Nachricht trägt einen Header `X-Webhook-Signature`, damit dein System prüfen kann, dass sie wirklich von Zippendo kommt. Es ist ein HMAC-SHA256 des rohen Nachrichtenkörpers, erstellt mit dem Secret des Webhooks. Häufige Fehler:

* Die Signatur wird über die Nachricht berechnet, nachdem sie geparst und umgeschrieben wurde, statt über den rohen Körper genau so, wie er empfangen wurde.
* Es wird das Secret eines anderen Webhooks verwendet. Jeder Webhook hat sein eigenes Secret.

Details und Codebeispiele: [Webhooks-Schnellstart](/docs/de/quickstarts/webhooks).

## Dasselbe Ereignis kommt zweimal an

Wenn dein System zu langsam oder mit einem Fehler geantwortet hat, versucht Zippendo es erneut, auch wenn dein System den ersten Versuch verarbeitet hat. Nutze den Header `X-Webhook-Id`, um eine bereits verarbeitete Nachricht zu erkennen.

Siehe auch: [Webhooks](/docs/de/how-to/webhooks), [Webhook-Einstellungen](/docs/de/settings/webhooks).


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