status-ontology · v3
TrackJet Status-Ontologie
Acht kanonische Zustände, in die jede Carrier-Formulierung abgebildet wird — dieselbe Taxonomie, die Website-Zeitleiste, REST/GraphQL-API, Webhooks und MCP-Tools ausgeben. Maschinenlesbar: status-ontology.json.
| Zustand | Bedeutung | Beispiel-Carrier-Formulierungen |
|---|---|---|
pending |
Sendung bekannt, noch keine Bewegung erfasst. | Label created · Auftragsdaten übermittelt · Pre-advice |
in_transit |
Bewegung zwischen Standorten. | Processed at parcel center · Departed hub · In Zustellbasis angekommen |
out_for_delivery |
Im finalen Zustellfahrzeug. | Out for delivery · In Zustellung · With delivery courier |
delivered |
Am Ziel übergeben. | Delivered · Zugestellt · Entregado |
exception |
Etwas blockiert den normalen Verlauf. | Held by customs · Address insufficient · Damaged |
returned |
Geht oder ging zurück zum Absender. | Return to sender · Retoure eingeleitet |
cancelled |
Vor der Zustellung abgesagt — weder Fehler noch Rücksendung. | Order cancelled · Storniert · Envío anulado |
unknown |
Carrier-Formulierung konnte nicht klassifiziert werden — wird unverändert gezeigt, nie geraten. | (anything unclassifiable) |
Design-Regeln
- Normalisierung ist additiv: Die ORIGINAL-Formulierung des Carriers bleibt immer neben dem kanonischen Zustand erhalten — wir klassifizieren, wir schreiben die Historie nie um.
- Nicht klassifizierbare Formulierungen werden auf
unknownabgebildet, nie auf eine Vermutung. exceptionist ein Flag, kein Endzustand — Sendungen erholen sich regelmäßig davon.- Zustände sind bewusst wenige: Acht Zustände decken den Carrier-übergreifenden Vergleich ab; feinere Unterschiede bleiben in der Originalformulierung.
Änderungsprotokoll
- v3 (2026-07-27) —
cancelledergänzt: eine abgesagte Sendung ist weder Ausnahme noch Rücksendung. Additiv — bestehende Konsumenten brechen nicht. - v2 (2026-06-10) — als offene Spec veröffentlicht; JSON-Download; genutzt von Zeitleiste, API, Webhooks, MCP.
- v1 (2026) — interne Normalisierung mit der REST-API eingeführt.
Siehe auch: Spec der prüfbaren Zeitleiste · REST-API-Doku · MCP-Server.