Shipment Tracking¶
LoupeFactory integrates with EasyPost to give you real-time package tracking and delivery status for every shipment you create. This guide covers how to create shipments, connect them to orders, and monitor delivery progress from within the platform.
Creating a Shipment¶
You can create a shipment directly from an order or from the Shipments module.
From an Order¶
The most common workflow is to create a shipment from a confirmed order:
- Navigate to the Orders module and open the order you want to ship.
- Click Create Shipment on the order detail page.
- Verify or update the Ship To address.
- Select a Carrier (e.g., UPS, FedEx, USPS) from the dropdown.
- Enter the package weight and dimensions.
- Click Create Shipment.
LoupeFactory sends the shipment details to EasyPost, which returns a tracking number and a shipping label.
Screenshot: Create Shipment Panel
A screenshot will be added here showing the Create Shipment panel on the order detail page, including the carrier selector, address fields, and package dimensions form.
Suggested image: assets/shipment-create-panel.png
From the Shipments Module¶
You can also create a standalone shipment not tied to a specific order:
- Navigate to Shipments from the main dashboard.
- Click New Shipment in the top-right corner.
- Fill in the recipient address, carrier, and package details.
- Optionally link the shipment to an existing order using the Order field.
- Click Create Shipment to generate the tracking number and label.
Screenshot: New Shipment Form
A screenshot will be added here showing the standalone New Shipment form with all fields visible, including the optional Order link field.
Suggested image: assets/shipment-new-form.png
EasyPost Integration¶
LoupeFactory uses EasyPost as its shipping carrier API. EasyPost connects to all major carriers and provides a unified interface for label generation and tracking.
How It Works¶
When you create a shipment in LoupeFactory:
- The platform sends the package details and addresses to EasyPost.
- EasyPost validates the address and returns available carrier rates.
- LoupeFactory selects the configured carrier and purchases the label.
- A tracking number is assigned and stored against the shipment record.
- EasyPost begins polling the carrier for tracking updates.
Screenshot: EasyPost Carrier Rates
A screenshot will be added here showing the carrier rate comparison view returned by EasyPost, with available services and estimated delivery times.
Suggested image: assets/shipment-carrier-rates.png
Supported Carriers¶
EasyPost supports a wide range of carriers. Commonly used carriers in LoupeFactory include:
| Carrier | Domestic | International |
|---|---|---|
| UPS | Yes | Yes |
| FedEx | Yes | Yes |
| USPS | Yes | Limited |
| DHL | No | Yes |
Contact your LoupeFactory administrator to configure which carriers are available in your account.
Downloading Shipping Labels¶
After a shipment is created, you can download the shipping label directly from the shipment detail page:
- Open the shipment from the Shipments list.
- Click Download Label to save the label as a PDF.
- Print and attach the label to your package.
Screenshot: Shipment Detail with Label Download
A screenshot will be added here showing the shipment detail page with the Download Label button and the tracking number displayed.
Suggested image: assets/shipment-detail-label.png
Tracking Packages¶
Once a shipment is created and the package is in transit, LoupeFactory automatically fetches tracking updates from EasyPost.
Viewing Tracking Status¶
To view the current status of a shipment:
- Navigate to Shipments from the main dashboard.
- Find the shipment in the list — the current status is shown in the Status column.
- Click the shipment to open the detail view and see the full tracking timeline.
Screenshot: Shipment List with Status
A screenshot will be added here showing the Shipments list with the status column, tracking number column, and carrier icons visible.
Suggested image: assets/shipment-list-status.png
Delivery Status Values¶
Each shipment moves through the following statuses as it progresses:
| Status | Description |
|---|---|
| Label Created | Shipping label generated; package not yet picked up |
| In Transit | Package picked up and moving through the carrier network |
| Out for Delivery | Package is on the delivery vehicle |
| Delivered | Package confirmed delivered |
| Exception | Carrier reported an issue (e.g., address problem, failed delivery attempt) |
| Returned | Package returned to sender |
Screenshot: Tracking Timeline
A screenshot will be added here showing the tracking timeline on a shipment detail page, with each status event listed in chronological order including timestamps and carrier scan locations.
Suggested image: assets/shipment-tracking-timeline.png
Handling Delivery Exceptions¶
If a shipment enters Exception status, LoupeFactory displays an alert on the shipment detail page with the carrier's exception message. Common causes include:
- Incorrect or incomplete delivery address
- Recipient unavailable for signature
- Package refused by recipient
- Customs hold (for international shipments)
To resolve an exception:
- Open the shipment detail page.
- Review the exception message from the carrier.
- Contact the carrier directly using the tracking number to arrange re-delivery or correction.
- Update the shipment notes in LoupeFactory to record the resolution steps.
Warning
LoupeFactory cannot modify a shipment with the carrier after the label has been purchased. Address corrections must be handled directly with the carrier.
Screenshot: Shipment Exception Alert
A screenshot will be added here showing the exception alert banner on a shipment detail page with the carrier's exception message and the shipment notes field.
Suggested image: assets/shipment-exception-alert.png
Linking Shipments to Orders¶
Shipments created from an order are automatically linked. You can also link a standalone shipment to an order after the fact:
- Open the shipment detail page.
- Click Link to Order in the shipment details panel.
- Search for and select the order.
- Click Save.
Once linked, the order status updates to Shipped and the tracking number appears on the order detail page.
Screenshot: Link Shipment to Order
A screenshot will be added here showing the Link to Order dialog on the shipment detail page with the order search field.
Suggested image: assets/shipment-link-order.png
Next Steps¶
- Order Management — Create and manage orders that generate shipments.
- Invoicing — Generate invoices linked to fulfilled orders.
- Customer & Supplier Management — Manage the recipient addresses used in shipments.
- Reporting & Analytics — View shipment reports and export delivery data.