Skip to Content
ShipmentsTracking

Shipment Tracking

Orderly tracks shipments across all connected carriers, providing a unified view of delivery progress.

How Tracking Works

  1. Label creation — When a shipment is created with a tracking number, Orderly starts monitoring it
  2. Event polling — Tracking events are fetched from carrier APIs on a schedule
  3. Webhooks — Carriers with webhook support push events in real-time
  4. Status mapping — Carrier-specific statuses are mapped to Orderly’s unified status model

Tracking Events

Each tracking event includes:

FieldDescription
timestampWhen the event occurred
statusNormalized status
descriptionHuman-readable description from the carrier
locationCity/state/country where the event occurred
carrierCodeRaw status code from the carrier

Viewing Tracking

Portal

The shipment detail page shows a timeline of all tracking events. The order detail page also shows associated shipment tracking inline.

API

GET /api/shipment-tracking/:trackingNumber

Returns the latest tracking data for any tracking number, regardless of carrier.

Tracking Webhooks

For carriers that support it, Orderly registers tracking webhooks automatically. This provides near-instant status updates compared to polling.

Supported webhook carriers:

  • FedEx (Track API webhooks)
  • UPS (Quantum View)
  • Shopify (fulfillment event webhooks)

Delivery Confirmation

When a shipment is marked as delivered:

  1. The shipment status updates to delivered
  2. The linked order’s fulfillment status is recalculated
  3. If all shipments for an order are delivered, the order status moves to delivered
  4. An activity is logged on the order
FieldsActions