Express Kurier. Direkt.
Auch Overnight.
x25pronto Schweiz bringt Ware direkt ans Ziel. Für kleine Ware fährt ein Auto. Für mehr Platz gibt es Transporter oder XL. Direkt, Express und Overnight fahren von Montag bis Sonntag. Freie Zeiten stehen im Kalender.
Webhook-Integration: Echtzeit-Statusupdates für Ihre Kurierprozesse
So richten Sie Webhooks für Kurieraufträge ein, welche Events wichtig sind, wie Sie Sicherheit und Zustell-Retries planen und wie Echtzeitdaten Ihre Prozesse in Zürich, Bern oder Basel beschleunigen.
Kurzantwort
Webhooks senden Echtzeit-Statusupdates (z. B. Pickup, Out-for-Delivery, Delivered) von x25pronto an Ihre Systeme. Sie erhalten sofortige Benachrichtigungen, automatisieren Workflows und reduzieren manuelle Nachfragen für Sendungen in Städten wie Zürich oder Genf. Richtig konfiguriert bieten Webhooks zuverlässige, sichere und nachvollziehbare Statusmeldungen.
Was ist ein Webhook und wie hilft er Ihrem Versand
Ein Webhook ist eine kurze HTTP-Nachricht, die x25pronto an Ihre Server schickt, sobald sich der Zustand einer Sendung ändert. Statt Ihre IT ständig bei unserer API nachzufragen, liefern Webhooks Updates automatisch. So wissen Ihre Teams in Zürich, Basel oder Lausanne sofort, wenn eine Sendung abgeholt oder zugestellt wurde. Das spart Zeit und verbessert die Kundenauskunft.
Typische Events: Pickup, Out-for-Delivery, Delivered und mehr
Wichtige Events, die Sie abonnieren sollten: - pickup: Kurier hat die Sendung übernommen. - out_for_delivery: Kurier ist unterwegs zur Zustellung. - delivered: Sendung wurde erfolgreich übergeben. - failed_delivery: Zustellung gescheitert (keine Empfangsperson). - exception: Unerwartetes Ereignis wie Verzögerung oder Adressproblem. Jeder Event enthält Sendungs-ID, Zeitstempel, Standortdaten (sofern vorhanden) und optionale Signatur- oder Foto-Metadaten.
Payload-Formate und minimale Anforderungen
Webhooks liefern typischerweise JSON. Ein Standard-Payload enthält: event_type, shipment_id, timestamp, courier_id, location {lat, lon, address}, metadata. Halten Sie einen kurzen, idempotenten Endpunkt bereit, der eingehende POST-Anfragen akzeptiert, prüft und 200 OK zurückliefert. Verarbeiten Sie jedes Event eindeutig anhand der shipment_id und eines event-sequenzfelds oder timestamp.
Sicherheitsaspekte: Authentifizierung und Integritätsprüfung
Sichern Sie Webhooks mit mindestens einer der folgenden Methoden: - HMAC-Signatur: x25pronto signiert Payloads mit einem gemeinsamen Geheimnis. Prüfen Sie Signatur-Header vor dem Verarbeiten. - IP-Whitelist: Akzeptieren Sie Requests nur von x25pronto-IP-Adressen, falls verfügbar. - TLS: Akzeptieren Sie nur HTTPS-Verbindungen. Kombinieren Sie Methoden für höhere Sicherheit. Loggen Sie eingehende Events mit Headern und Body für Auditzwecke.
Retry-Strategien und Idempotenz
Netzwerkfehler kommen vor. x25pronto versucht Webhooks mehrfach zu senden. Ihre Seite muss: - Idempotent arbeiten: Wiederholte Events dürfen keine doppelten Aktionen auslösen. - Teeilen Sie Antwortcodes: 2xx = erfolgreich, 4xx = fehlerhaft (nicht erneut senden), 5xx = vorübergehend (erneut versuchen). - Backoff beachten: Implementieren Sie exponentielles Backoff bei eigenen ausgehenden Calls. Loggen Sie Fehlversuche, damit Supportfälle schnell geklärt werden können.
Praxisbeispiel: Automatische Kundenbenachrichtigung bei Zustellung
Szenario: Kunde in Bern bestellt eine teilmontierte Maschine. Wenn x25pronto das 'out_for_delivery'-Event sendet, aktiviert Ihr System eine SMS/Email mit ETA. Nach 'delivered' prüft das System die Foto-Metadaten und sendet eine Zustellbestätigung an den Empfänger. Alle Schritte laufen ohne manuelles Eingreifen und reduzieren Rückfragen an Ihre Logistik.
Häufige Fragen
Wie richte ich einen Webhook-Endpunkt ein?
Erstellen Sie einen HTTPS-Endpunkt, der POST-Requests mit JSON annimmt. Implementieren Sie Prüfung der Signatur (HMAC) und antworten Sie schnell mit 200 OK, wenn das Event gültig ist.
Was passiert, wenn mein Server vorübergehend nicht erreichbar ist?
x25pronto versucht das Event erneut zu senden. Ihr Endpunkt sollte Idempotenz sicherstellen, sodass doppelte Events keine Doppelaktionen auslösen.
Welche Events sind für mich am wichtigsten?
Für die meisten Unternehmen sind pickup, out_for_delivery und delivered zentral. Ergänzen Sie failed_delivery und exception für bessere Fehlerbehandlung.
Wie kann ich die Sicherheit der Webhooks erhöhen?
Nutzen Sie HMAC-Signaturen, TLS und wenn möglich IP-Whitelisting. Prüfen und loggen Sie alle Header und Payloads für Audits.