status-ontology · v3
Ontología de estados de TrackJet
Ocho estados canónicos a los que se mapea cada formulación de transportista — la misma taxonomía que emiten la cronología del sitio, la API REST/GraphQL, los webhooks y las herramientas MCP. Legible por máquina: status-ontology.json.
| Estado | Significado | Ejemplos de formulaciones de transportistas |
|---|---|---|
pending |
Envío conocido, sin movimiento registrado aún. | Label created · Auftragsdaten übermittelt · Pre-advice |
in_transit |
En movimiento entre instalaciones. | Processed at parcel center · Departed hub · In Zustellbasis angekommen |
out_for_delivery |
En el vehículo de entrega final. | Out for delivery · In Zustellung · With delivery courier |
delivered |
Entregado en destino. | Delivered · Zugestellt · Entregado |
exception |
Algo bloquea el avance normal. | Held by customs · Address insufficient · Damaged |
returned |
Volviendo o devuelto al remitente. | Return to sender · Retoure eingeleitet |
cancelled |
Cancelado antes de entregarse — ni fallo ni devolución. | Order cancelled · Storniert · Envío anulado |
unknown |
La formulación del transportista no se pudo clasificar — se muestra tal cual, nunca adivinada. | (anything unclassifiable) |
Reglas de diseño
- La normalización es aditiva: la formulación ORIGINAL del transportista siempre se conserva junto al estado canónico — clasificamos, nunca reescribimos el historial.
- Las formulaciones inclasificables se mapean a
unknown, nunca a una suposición. exceptiones una marca, no un estado terminal — los envíos se recuperan de ella habitualmente.- Los estados son deliberadamente pocos: ocho estados cubren la comparación entre transportistas; las distinciones más finas quedan en la formulación original.
Registro de cambios
- v3 (2026-07-27) — se añade
cancelled: un envío cancelado no es una excepción ni una devolución. Aditivo — no rompe a los consumidores existentes. - v2 (2026-06-10) — publicada como spec abierta; descarga JSON; consumida por cronología, API, webhooks, MCP.
- v1 (2026) — normalización interna introducida con la API REST.
Ver también: Spec de la cronología verificable · Doc de la API REST · Servidor MCP.