Tracking Return Shipments
Return Shipment Tracking
Stay on top of every return with comprehensive tracking, real-time notifications, and automated status workflows.
Tracking Dashboard Overview
Access all return shipments at Dashboard → Returns → Active Returns
At-a-Glance Metrics:
- Total returns in transit
- Returns awaiting drop-off
- Returns delivered today
- Overdue returns (past expected delivery)
- Pay-on-use labels unused
Return Status Lifecycle
| Status | Description | Typical Duration |
|---|---|---|
| Label Created | Return label generated | Until customer drops off |
| Awaiting Drop-off | Customer has label/QR code | 0-7 days |
| Dropped Off | Package scanned at carrier | — |
| In Transit | Moving through carrier network | 1-5 days |
| Out for Delivery | On vehicle for delivery | Same day |
| Delivered | Received at return address | — |
| Processing | Being inspected/restocked | 1-3 days |
| Completed | Refund issued, return closed | — |
Status-Based Actions
Label Created → Wait or send reminder
Awaiting Drop-off → Send reminder after 5 days
In Transit → No action needed
Delivered → Trigger inspection workflow
Processing → Quality check in progress
Completed → Refund processed
Setting Up Notifications
For Your Team
Navigate to Settings → Notifications → Returns
Recommended Alerts:
| Event | Channel | Urgency |
|---|---|---|
| Return delivered | Email + Slack | Normal |
| High-value return | SMS | High |
| Return overdue | Normal | |
| Delivery exception | Email + SMS | High |
For Customers
Automatic notifications sent at key milestones:
-
Return Approved
- Label/QR code attached
- Drop-off instructions
- Tracking link
-
Package Scanned
- Confirmation of drop-off
- Expected delivery date
- Tracking link
-
Return Received
- Confirmation of delivery
- Processing timeline
- Expected refund date
-
Refund Processed
- Refund amount
- Processing time (3-5 business days)
- Thank you message
Real-Time Tracking Features
Carrier Integration
atoship provides unified tracking across all carriers:
- USPS — Real-time scan events
- UPS — Delivery notifications
- FedEx — GPS-based tracking
- Regional carriers — Where available
Webhook Events
Set up webhooks for real-time updates:
POST https://yourserver.com/webhooks/returns
{
"event": "return.delivered",
"return_id": "RET-67890",
"tracking_number": "9400111899223456789012",
"carrier": "usps",
"delivered_at": "2024-01-15T14:30:00Z",
"signed_by": "WAREHOUSE"
}
Available Events:
return.createdreturn.label_scannedreturn.in_transitreturn.out_for_deliveryreturn.deliveredreturn.exceptionreturn.completed
Handling Delivery Issues
Return Not Scanned (5+ Days)
Automated Workflow:
- Day 5: Send reminder email with drop-off instructions
- Day 10: Send final reminder
- Day 14: Expire return request (configurable)
Manual Steps:
- Contact customer to confirm drop-off
- Check carrier tracking directly
- Verify correct QR code/label was used
Return Lost in Transit
- Wait 2 business days past expected delivery
- File carrier inquiry through atoship
- Check carrier claims requirements
- Issue refund based on your policy
- Document for future reference
Delivery Exception
Common exceptions:
- Address issue — Contact warehouse, verify address
- Damaged package — File carrier claim
- Refused delivery — Investigate warehouse procedures
Wrong Item Returned
- Photo document received item
- Contact customer about discrepancy
- Options:
- Ship correct item back
- Issue partial refund
- Keep item, process refund anyway (green returns)
Bulk Return Management
For high-volume returns (100+ daily):
Export & Reporting
- Export return data to CSV
- Daily summary reports
- Exception-only alerts
API Integration
// Get all returns in transit
GET /v1/returns?status=in_transit
// Get returns delivered today
GET /v1/returns?status=delivered&delivered_date=today
// Get overdue returns
GET /v1/returns?status=awaiting_dropoff&created_before=7_days_ago
Automated Workflows
- Auto-close returns 30 days after delivery
- Auto-escalate stuck returns
- Auto-refund on delivery confirmation
Return Analytics
Key Tracking Metrics
| Metric | Benchmark | Your Target |
|---|---|---|
| Avg transit time | 3-5 days | Track trend |
| Drop-off rate | 70-80% | Maximize |
| Delivery exceptions | <2% | Minimize |
| Time to refund | 5-7 days | Reduce |
Dashboard Reports
Navigate to Reports → Returns:
- Returns by status over time
- Average transit time by carrier
- Drop-off rate trends
- Exception rate analysis
- Refund processing time