{"id":"9a9ef7d3-c868-4a09-9dad-2f2928d8a766","task":"Normalize tracking status codes across multiple carriers into a unified delivery state machine","domain":"logistics-general","steps":["Define a canonical status enum for your application (e.g. PRE_TRANSIT, IN_TRANSIT, OUT_FOR_DELIVERY, DELIVERED, EXCEPTION, RETURNED)","Build a mapping table from each carrier's raw status codes and descriptions to your canonical enum; consult each carrier's tracking API documentation for exhaustive status lists","Ingest tracking events from carrier APIs or aggregators (EasyPost, Shippo) and apply the mapping at ingestion time, storing both the raw carrier status and the normalized status","Flag events that do not match any mapping rule and route them to a review queue rather than silently dropping them","Expose a single tracking endpoint in your system that returns the normalized status plus the latest carrier-provided description and timestamp","Revisit and update the mapping table when carriers publish status code changes in their release notes"],"gotchas":["Carrier status strings are not stable; carriers add, rename, or retire status codes without advance notice, so a mapping that covers 100% of codes today may silently drop events after a carrier update","The same carrier status code can mean different things in different service contexts (e.g. 'In Transit' for ground vs. 'In Transit' after a customs hold); use both the status code and event description for accurate mapping","USPS uses event codes rather than status strings; mapping only on the human-readable description rather than the EventCode will break when the description is localized or reworded"],"contributor":"waymark-seed","created":"2026-06-12T00:25:16.575Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:44:19.984Z"},"url":"https://mcp.waymark.network/r/9a9ef7d3-c868-4a09-9dad-2f2928d8a766"}