{"id":6425,"plugin_id":"plugin_asdk_app_6a3be8ce7d0c81918cb8bcc8f6d0008e","kind":"skill","collection_source":null,"comparison_source":null,"observed_at":"2026-09-30T22:48:21.857Z","digest":"e69cc81f70cd550bab7d40f1946307fe083ac6bf93928d9790997462b513393e","against":null,"payload":{"name":"tracking","description":"Track packages across carriers, view tracking history, and set up tracking webhooks via the Shippo API","included_files":[{"relative_path":"shippo/references/address-formats.md","size_in_bytes":4083},{"relative_path":"shippo/references/carrier-guide.md","size_in_bytes":5690},{"relative_path":"shippo/references/csv-format.md","size_in_bytes":5976},{"relative_path":"shippo/references/customs-guide.md","size_in_bytes":9321},{"relative_path":"shippo/references/error-reference.md","size_in_bytes":11389},{"relative_path":"shippo/references/international-shipping.md","size_in_bytes":6910},{"relative_path":"shippo/references/label-formats.md","size_in_bytes":2825},{"relative_path":"shippo/references/rate-shopping-guide.md","size_in_bytes":4320},{"relative_path":"shippo/references/response-envelope.md","size_in_bytes":1184},{"relative_path":"shippo/references/tool-reference.md","size_in_bytes":15981}],"skill_md_contents":"---\nname: tracking\ndescription: Track packages across carriers, view tracking history, and set up tracking webhooks via the Shippo API\nmetadata:\n  version: \"1.5.2\"\n---\n\n# Package Tracking\n\n## Track by Number\n\n1. Determine carrier and tracking number. Carrier must be a lowercase Shippo token (e.g., `usps`, `ups`, `fedex`, `dhl_express`). See `shippo/references/carrier-guide.md` for tracking number format hints per carrier. If uncertain, ask the user.\n2. Call `GetTrack` with `carrier` and `tracking_number`.\n3. Key response fields: `tracking_status` (status, status_details, status_date, location), `tracking_history`, `eta`.\n4. Each tracking event includes a `substatus` object with `code`, `text`, and `action_required` (boolean). Include substatus details when presenting tracking history -- these provide more specific information about what happened at each step.\n5. Present: current status, location, ETA, substatus details, and chronological event history (most recent first).\n\n---\n\n## Status Values\n\nSee `shippo/references/carrier-guide.md` for carrier-specific status nuances. Standard values:\n\n| Status | Meaning |\n|---|---|\n| PRE_TRANSIT | Label created, carrier has not received the package |\n| TRANSIT | Package is in transit |\n| DELIVERED | Delivered |\n| RETURNED | Being returned or returned to sender |\n| FAILURE | Delivery failed |\n| UNKNOWN | No tracking information from carrier |\n\nThe `eta` field is provided by most major carriers (USPS, UPS, FedEx, DHL Express) but availability is carrier-dependent, it may be `null` for regional carriers or for shipments before the carrier has finalized routing. Treat absence as informational, not as an error condition.\n\n---\n\n## Find Trackable Packages\n\nCall `ListTransactions`. Filter for `object_status: SUCCESS`. Each successful transaction has `tracking_number` and carrier info. Then call `GetTrack` for selected items.\n\n---\n\n## Register a Tracking Webhook\n\n1. Get the user's HTTPS webhook URL.\n2. Call `createWebhook` with `url` and `event: track_updated`.\n3. Optionally call `CreateTrack` with carrier and tracking number to register a specific shipment for push updates.\n\n---\n\n## Quick Reference\n\n**Track a package:**\n`GetTrack` with carrier + tracking number\n\n**Find past shipment tracking:**\n`ListTransactions` -> filter SUCCESS -> `GetTrack`\n"},"changes":[],"summary":"First saved snapshot. No earlier version is available for comparison.","summary_kind":"deterministic","summary_metadata":{}}