Nummer

BP-AT-006

Maßstab

1 : 1

Datum

2026-05-25

Rev.

A

Werkstatt 4notify · LogistikFreigegeben

Bauplan BP-AT-006 von BP-AT-008 · Logistik

SMSE-MailWebhook

Österreichische Post, DPD AT und GLS — Sendungsverfolgung-Webhooks

Normalisierte Trackingstatus für Post Empfangsbox, Self-Service-Stationen und Hauszustellung

§ ADas Problem

Ohne Normalisierung hat jeder Carrier sein eigenes Vokabular: Post nennt es ’Übernahme von Versender', DPD ’Pickup completed', GLS ’Inbound at hub’. Schreibt die E-Commerce-Plattform alle Status 1:1 weiter, sieht der Endkunde in der Bestellhistorie ein Patchwork aus deutschen, englischen und gemischten Begriffen, oft mit Carrier-spezifischen Tippfehlern. Outcome: Support-Tickets steigen, der Kunde glaubt, sein Paket sei in zwei verschiedenen Stadien gleichzeitig.

§ BHauptansicht

Der österreichische Paketmarkt teilt sich zwischen Österreichischer Post (≈ 56 %), DPD Austria (≈ 22 %), GLS Austria (≈ 12 %) und einer Reihe kleinerer Anbieter (Hermes, FedEx, UPS). Jeder Anbieter pflegt eigene Status-Codes, eigene Webhook-Formate und eigene Empfangsbox-Logiken — die Post Empfangsbox am Haus, DPD Pickup-Stationen, GLS ParcelShops. Für E-Commerce-Plattformen mit gemischtem Carrier-Mix ist die Normalisierung dieser Status der entscheidende Hebel: Kunden wollen eine konsistente Sprache (’Paket im Hub angekommen', ’Paket in Zustellung', ’Abholbereit in Mariahilf'), unabhängig vom Carrier. 4notify empfängt die rohen Webhooks, normalisiert auf eine kanonische Status-Liste und fächert auf die konfigurierten Endpoints aus.

§ CMaterialliste

Kanal	Primärer Anbieter	Fallback
Post-Webhook	post.at/sendungsverfolgung/webhook	REST API polling (5 min)
DPD-Webhook	DPD MyAccount push	DPD CSV-Export per E-Mail
GLS-Webhook	GLS Track & Trace API	GLS event polling (10 min)
Kanonischer Status-Mapper	4notify Status-Normalizer	Default-Mapping mit Warnung
Kunden-SMS Abholerinnerung	BP-AT-002 SMS-Routing	E-Mail mit Karten-Link

§ DToleranzen

Webhook → Kunden-Notify

≤ 60Sekunden

Status-Mapping-Coverage

100% kanonisch + 0,5 % unknown

Abholerinnerung Vorlauf

48 + 24Stunden vor Ablauf

Webhook-Retention

90Tage (PostmarktG)

Idempotency-Window

24Stunden

§ ENormverweise

PostmarktG 2025 § 26

Verbraucher haben Anspruch auf Statustransparenz bei Paketsendungen. Carrier müssen die Statushistorie für mindestens 90 Tage abrufbar halten.

DSGVO Art. 5 (1) (b) — Zweckbindung

Empfängeradresse + Telefonnummer dürfen nur für die Zustellung verwendet werden. Marketing-Reaktivierung auf Basis von Tracking-Events ist unzulässig ohne separate Einwilligung.

ABGB § 1419 — Annahmeverzug

Wenn der Empfänger das Paket nicht innerhalb der Lagerfrist (Post: 14 Tage, DPD: 7 Tage, GLS: 7 Tage) abholt, gerät er in Annahmeverzug. Statusbenachrichtigungen helfen, das zu vermeiden.

§ FBauschritte

Webhooks bei allen drei Carriern registrieren

Bei Post über das Geschäftskunden-Portal post.at/business; bei DPD über DPD MyAccount → Webhook-Konfiguration; bei GLS über das Track-&-Trace-Backoffice. Jeder Carrier nutzt eigene Authentifizierung — Post: HMAC, DPD: Basic Auth, GLS: API-Key. 4notify abstrahiert das hinter einer einheitlichen Connection-Konfiguration.

Roh-Status auf kanonisches Vokabular mappen

Die Status-Tabelle: `created`, `picked_up`, `at_origin_hub`, `in_transit`, `at_destination_hub`, `out_for_delivery`, `delivered`, `at_pickup_point`, `picked_up_by_recipient`, `returned`, `lost`. Jeder Carrier-Roh-Status wird auf einen dieser elf kanonischen Werte abgebildet; unbekannte Status werden mit Warning geloggt und an einen Default (`in_transit`) gemappt.

Empfangsbox-Spezifika erkennen und vermerken

Post Empfangsbox = zugestellt, aber an die Empfangsbox am Haus (nicht direkt an den Empfänger). Der Status bleibt `delivered`, aber ein zusätzliches Feld `pickup_location: empfangsbox` wird gesetzt — so kann die SMS-Vorlage zwischen ’Paket geliefert’ und ’Paket in Empfangsbox an der Haustür’ unterscheiden.

Abholerinnerungen 48 h + 24 h vor Lagerfrist-Ende

Bei Status `at_pickup_point` wird automatisch ein Timer angelegt: 48 h vor Ablauf der Lagerfrist (Post 14, DPD 7, GLS 7 Tage) erste Erinnerung, 24 h vor Ablauf zweite. Bei Abholung (Status `picked_up_by_recipient`) werden die Timer abgebrochen.

§ GPrüfprotokoll

Testprotokoll: (1) Test-Sendung über Post / DPD / GLS Sandbox einlegen — drei Sendungs-IDs gleichzeitig. (2) Statuswechsel an Sandbox triggern (Pickup → In Transit → At Hub → Out for Delivery). (3) Bei jedem Wechsel innerhalb von 60 Sekunden Kunden-SMS prüfen, kanonischer Status muss korrekt sein. (4) Sendung an Pickup Point statt Haustür simulieren — Status `at_pickup_point` muss eingehen, Timer für 48 h + 24 h vor Ablauf angelegt sein. (5) Empfangsbox-Lieferung simulieren — Status `delivered` mit `pickup_location: empfangsbox`, SMS-Text muss ’Empfangsbox’ enthalten.

§ HCode

bash
curl -X POST https://api.4notify.net/v1/shipments/register \
  -H "Authorization: Bearer $API_KEY' \
  -H "Content-Type: application/json' \
  -d '{
    "carrier': 'post_at",
    "tracking_number': 'AT123456789",
    "recipient_phone': '+436641234567",
    "notify_on": [
      "out_for_delivery",
      "delivered",
      "at_pickup_point",
      "returned"
    ],
    "pickup_reminders_hours_before_deadline": [48, 24],
    "carrier_webhook_signature': 'sha256=…"
  }'

§ IBeispielnachricht

SMS

Post.at: Ihr Paket AT123456789 liegt in der Post-Filiale 1070 Wien, Mariahilfer Str. 88, bis 09.06. zur Abholung. Mit Ausweis.

§ JInbetriebnahme-Checkliste

Webhooks bei allen relevanten Carriern aktiviert (Post / DPD / GLS minimal)
Idempotency-Key pro Event implementiert (24-h-Fenster gegen Duplikate)
Status-Mapping-Tabelle mit Roh-Status-Verläufen jedes Carriers abgeglichen
Empfangsbox-Erkennung in Post-Webhooks aktiv
Abholerinnerungen mit korrekten Lagerfristen pro Carrier konfiguriert
Unbekannte Status werden geloggt und an support@ gemeldet (kein silent fail)

Was 4notify anders macht

Statt Carrier-Status 1:1 weiterzureichen, normalisiert 4notify auf elf kanonische Werte — und erkennt Empfangsbox-Spezifika, ohne die der Endkunde nicht weiß, ob das Paket in der Wohnung oder im Vorgarten liegt.

§ KHäufige Fragen

Was, wenn ein Carrier-Webhook ausfällt?

4notify schaltet auf Polling um (5–10 min Intervall, je nach Carrier) und triggert eine Operations-Alarm-Notify. Webhooks haben Replay-Capability über 30 Tage; nach Wiederherstellung werden verpasste Events nachgespielt, ohne Duplikate (Idempotency-Key).

Wie geht ihr mit Hermes / FedEx / UPS um?

Adapter-Komponenten existieren für FedEx und UPS (API-basierte Webhooks). Hermes Österreich nutzt aktuell ein Polling-API; wir fragen alle 10 Minuten und schreiben Ereignisse in den gleichen kanonischen Status-Strom. Statusabdeckung ist 100 % für Post/DPD/GLS und ~92 % für die kleineren Anbieter.

Können wir Kunden auch zwischen mehreren Versandadressen erinnern?

Ja. Wenn der Empfänger im Online-Account mehrere Adressen pflegt (Privat + Büro), kann 4notify die Sendung an ’Büro’ mit zusätzlicher SMS ’Achtung: Versand an Bürotor’ begleiten. Logikgrenze: Adressen-Tagging passiert in der E-Commerce-Plattform; 4notify übernimmt nur den Tag.