| Ship Date ↕ | Tracking # | Shipping PDC ↕ | Service | Recipient ↕ | Destination | Wt (lbs) ↕ | Dims | Cost ↕ | Zone | Status |
|---|
Import ProShip Data
Import your ProShip CSV export to populate the shipment dashboard.
Importing… this may take 30–60 seconds for large files.
Tracking History
Universal Shipment Tracking
Track any parcel,
anywhere in the world.
UPS · FedEx · USPS · DHL · Amazon · 900+ carriers
Locating shipment…
Spend & Volume Reports
Agile TM Documentation
Agile TM is a multi-carrier shipment visibility platform built around ProShip shipping data. Import your ProShip CSV export to instantly get a filterable shipment dashboard, per-shipment live tracking, full cost breakdowns, and spend reports — a self-hosted replacement for tools like Shippeo.
Quick Start
- Go to Import and load your ProShip CSV (by URL or file upload).
- Return to Dashboard — it populates automatically with all shipments, stats, and status badges.
- Click any row to open the Shipment Detail view — live tracking from the carrier, a mapped route, and a full cost breakdown are fetched on demand.
- Use Reports for spend analysis by carrier, service, and zone over any time window.
Stats Bar
The six cards at the top of the dashboard summarise your shipment data in real time, scoped to whatever filters are currently active.
| Card | What it shows |
|---|---|
| Total Shipments | Count of all non-voided shipments matching the current filters. |
| In Transit | Shipments with an In Transit or Out for Delivery status. |
| Exceptions | Shipments flagged as Exception or Attempt Failed. |
| Delivered | Confirmed delivered shipments. Shipments shipped more than 10 days ago without a known exception are also inferred as delivered. |
| Total Spend | Sum of all shipment costs for the filtered set, in USD. |
| Total Weight | Sum of all billed weights in pounds for the filtered set. |
Carrier Filter Pills
Below the stats bar, clickable pills show each Shipping PDC (carrier/distribution center) with its shipment count. Clicking a pill filters the entire dashboard to that carrier. Click the same pill again to clear the filter.
Filters & Search
The filter bar narrows the shipment list by multiple criteria simultaneously. All filters combine with AND logic.
| Filter | Behavior |
|---|---|
| Search box | Searches tracking number, recipient company, city, and reference fields (Ref 1–5, Shipper Ref). Updates as you type with a short debounce delay. |
| Shipping PDC | Filters to a single carrier or distribution center. Options are populated dynamically from your imported data. |
| Service | Filters to a single service level (e.g., FedEx Ground, UPS 2nd Day Air). |
| Status | Filters to a specific delivery status. See the Status Labels reference for definitions. |
| Ship Date From / To | Date range on the ProShip ship date. Both fields are optional — you can set just one boundary. |
| Show Voided | When checked, voided (cancelled) shipments are included in results and displayed dimmed. |
| Clear | Resets all filters and search fields to defaults in one click. |
Shipment Table
The main table lists all shipments matching the current filters, 50 rows per page. Click any row to open the full Shipment Detail view.
| Column | Description |
|---|---|
| Ship Date | Date the label was created in ProShip. |
| Tracking # | Carrier tracking number, shown in monospace for readability. |
| Shipping PDC | The carrier or physical distribution center that processed the shipment. |
| Service | ProShip service level — e.g., FedEx Ground, UPS Next Day Air. |
| Recipient | Consignee company name. |
| Destination | Consignee city, state, and country. |
| Wt (lbs) | Actual package weight in pounds. |
| Dims | Package dimensions as recorded in ProShip (L×W×H). |
| Cost | Total shipment cost from ProShip, including all surcharges. |
| Zone | Shipping zone used to calculate the carrier rate. |
| Status | Current delivery status — either live from the carrier or inferred from ship date. See Status Labels. |
Sorting
Columns marked with ↕ are sortable. Click the column header once to sort ascending; click again to reverse. The active column shows ↑ (ascending) or ↓ (descending).
Sortable columns: Ship Date, Shipping PDC, Recipient, Wt (lbs), Cost. Default sort is Ship Date descending (most recent first).
Import from URL
The recommended method for large files. Provide a public URL to a ProShip CSV export — the server streams and imports it directly without buffering the entire file, making it viable for files over 500 MB.
Steps
- Navigate to Import.
- Confirm the Import from URL tab is active.
- Paste the direct link to your
.csvfile. - Click Import CSV. A progress indicator appears showing rows imported so far, updated every 3 seconds.
- When complete, the dashboard refreshes automatically.
Re-importing & Duplicates
Each import uses INSERT OR IGNORE keyed on the ProShip internal ID — duplicate rows are silently skipped. It is safe to re-import an updated or extended CSV export; only new records are added.
Upload File
If your CSV is on your local machine, use the Upload File tab on the Import page.
- Switch to the Upload File tab.
- Drag and drop a
.csvfile onto the drop zone, or click browse to select one from your file system. - Click Import CSV to begin the upload and import.
Required CSV Format
The file must be a standard ProShip history export with column headers in the first row. Key columns required for full functionality:
| Column | Purpose |
|---|---|
TRACKING_NUMBER | Primary carrier tracking number. Rows missing this are skipped. |
SHIPPER_SYMBOL | Carrier code (used as Shipping PDC identifier). |
SHIPPER_PLAINTEXT | Carrier display name. |
PROSHIP_SHIPDATE | Ship date in MM/DD/YYYY format. |
TOTAL | Total shipment cost. |
PROSHIP_SERVICE_PLAINTEXT | Service level name. |
Status & Header
Clicking any row opens the Shipment Detail view. The header shows key at-a-glance information:
- Tracking number — full carrier tracking number
- Shipping PDC pill — carrier or distribution center name
- Status badge — current delivery status, color-coded by type
- ETA block — estimated delivery date from the carrier, or a ✓ if confirmed delivered
The ← Dashboard button returns you to the shipment list, preserving your filters and scroll position.
On load, the view immediately shows a loading state while the API fetches fresh data — the previous shipment's information is never shown between navigations.
Live Tracking Map
The map plots every location the shipment has scanned through, numbered chronologically.
| Marker | Meaning |
|---|---|
| Gold 1 | Origin — first recorded scan location |
| Navy N | Most recent known location (current position) |
| ✦ | Destination — shown if package hasn't arrived yet |
| Solid line | Travelled route between scan locations |
| Dashed line | Projected leg from current location to destination |
Click any marker to see all scan events at that location with timestamps and carrier messages. The map automatically fits its zoom to show the full route.
Tracking Timeline
The timeline lists every carrier scan event from newest to oldest. Each entry shows the timestamp, carrier event description, and the location of the scan. The topmost event (most recent) is highlighted.
Duplicate events across carrier systems are automatically deduplicated — if a tracking number is registered with multiple carriers, their events are merged and sorted by time.
Shipment Details Panel
The right sidebar shows all ProShip data recorded at the time the label was created. This data comes directly from your CSV export and is static — it reflects what ProShip captured, not live carrier data.
Fields shown include: tracking & alternate tracking numbers, Shipping PDC, service level, ship date, commitment time, full recipient address, consignee account number, actual and billed weight, dimensions, zone, payment terms, shipper reference, up to 5 miscellaneous reference fields, and the ProShip operator who processed the shipment.
Cost Breakdown
The cost card below the shipment details panel itemises each charge component as recorded in ProShip.
| Line Item | Description |
|---|---|
| Base Rate | Carrier's published or contracted rate for the zone and weight. |
| Discount | Negotiated account discount applied to the base rate. |
| Fuel Surcharge | Carrier fuel surcharge, typically a percentage of base rate. |
| Residential Fee | Surcharge applied when delivering to a residential address. |
| Extended Area Fee | Surcharge for delivery to rural or remote ZIP codes. |
| Additional Handling | Surcharge for oversized, heavy, or irregular packages. |
| Total | Sum of all charges after discounts. This is the value used throughout the dashboard and reports. |
Refreshing Tracking Data
Live tracking data is fetched from the carrier via 17track the first time you open a shipment, then cached for 2 hours on the server. The Refresh button forces a new live fetch from the carrier, bypassing the cache.
The note below the button shows how long ago the data was last fetched.
Period Selector
The period selector controls the date range for all five charts and the summary stat cards simultaneously. Changing the period reloads all data instantly.
| Option | Date range |
|---|---|
| All Time | Every shipment in the database regardless of ship date. |
| Last Year | Shipments with a ship date within the last 365 days. |
| 90 Days | Shipments with a ship date within the last 90 days. |
| 30 Days | Shipments with a ship date within the last 30 days. |
Charts
All charts are interactive — hover over any bar, segment, or data point for exact values. Tooltips show both spend and shipment count where applicable.
| Chart | What it shows |
|---|---|
| Monthly Spend & Volume | Dual-axis chart: navy bars = total spend per month (left axis), gold line = shipment count (right axis). Identifies seasonal patterns and month-over-month cost trends. |
| Spend by Shipping PDC | Horizontal bar chart ranking each carrier or distribution center by total spend. Hover to see shipment count alongside the dollar amount. |
| Spend by Service | Horizontal bar chart ranking each service level by total spend. Use this to identify which service tiers are driving the most cost. |
| Spend by Zone | Doughnut chart showing spend share across shipping zones. Higher zone numbers represent longer distances and higher rates. |
| Status Breakdown | Doughnut chart showing how many shipments are in each delivery status for the selected period. |
Status Labels
Agile TM uses standardised status labels across the dashboard, detail view, and reports, sourced from the 17track API and normalised to a common set.
| Status | Meaning |
|---|---|
| In Transit | The carrier has the package and it is moving toward its destination. |
| Out for Delivery | The package is on a delivery vehicle and expected to be delivered today. |
| Delivered | Confirmed delivered by the carrier, or inferred from ship date (shipped more than 10 days ago without a known exception). |
| Exception | A problem occurred — address issue, weather delay, customs hold, damage, etc. |
| Attempt Failed | A delivery was attempted but the recipient was unavailable or the location was inaccessible. |
| Available for Pickup | The package is held at a carrier facility awaiting recipient pickup. |
| Info Received | A shipping label was created but the carrier has not yet received or scanned the package. |
Status Inference Logic
Because live tracking is only fetched on demand (when you open a shipment detail), most records in the database start without a carrier-confirmed status. Agile TM applies the following inference in order:
- If a confirmed terminal status exists in the database (Delivered, Exception, Attempt Failed, Expired, Available for Pickup), that status is always used.
- If the ship date is more than 10 days ago and no exception is recorded, the shipment is displayed as Delivered.
- If the ship date is within the last 10 days and no live status has been fetched, the shipment is displayed as In Transit.
Opening any shipment detail fetches the latest carrier status via 17track and permanently updates the database record, replacing the inferred status.