Tracking Deliveries in Real-Time

Shaloz provides comprehensive real-time tracking for all deliveries, allowing you to monitor driver location, delivery status, and communicate with drivers throughout the delivery process.

__________________________________________________

Accessing Delivery Tracking

From Fulfillment Data Page:

1. Navigate to Fulfillment Data page
2. Find the order you want to track
3. Click on the order row or "Track" button
4. Tracking Modal opens showing full delivery details

From Dashboard:

1. Click on pending or processing order notifications
2. Direct access to tracking view

__________________________________________________

Tracking Modal Features

What You See:

1. Order Information

• Order ID
• Customer name and address
• Scheduled delivery date
• Package details (description, weight, dimensions)

2. Driver Information (when assigned)

• Driver name
• Driver photo
• Phone number (for contact)
• Vehicle information (type, license plate)
• Driver rating

3. Real-Time Map

• Driver's current location (live GPS tracking)
• Pickup location marker
• Drop-off location marker
• Route polyline
• Estimated time of arrival (ETA)

4. Delivery Timeline

• All status updates with timestamps
• Current status highlighted
• Location data for each update

5. Action Buttons

• Refresh Status
• Contact Driver
• Cancel Delivery (if not completed)
• Close Modal

__________________________________________________

Understanding Delivery Statuses

Complete Status Flow:

1. Pending

• Order created but not yet fulfilled
• No driver assigned
• Payment not processed

2. Sent for Delivery

• Order fulfilled and paid
• System searching for available drivers
• Driver notifications being sent

3. Assigned to Driver

• Driver accepted the route
• Driver has order details
• Driver preparing to head to pickup

4. En Route to Pickup

• Driver started trip in app
• Navigating to your pickup location
• ETA to pickup shown

5. Arrived at Pickup

• Driver marked arrival at pickup location
• Ready to collect package
• Awaiting verification code confirmation

6. Picked Up / En Route to Drop-off

• Driver confirmed pickup with verification code
• Package in driver's possession
• Navigating to customer address
• ETA to customer shown

7. Arrived at Drop-off

• Driver at customer's address
• Preparing to hand off package
• Final delivery imminent

8. Completed

• Package delivered successfully
• Photo proof captured
• Payment captured
• Delivery finished

Other Statuses:

Cancelled

• Delivery cancelled by business or system
• Payment authorization released
• No delivery occurred

__________________________________________________

Real-Time Driver Location Tracking

Live GPS Updates:

How It Works:

• Driver's phone sends location updates every 10-30 seconds
• Map updates automatically (no refresh needed)
• Uses WebSocket for instant updates

Map Features:

• Blue dot - Driver's current location
• Pickup marker - Your pickup location
• Drop-off marker - Customer address
• Route line - Planned driving route
• Zoom controls - Zoom in/out on map
• Center button - Re-center on driver

Location Accuracy:

• Typically accurate within 10-50 feet
• Depends on driver's GPS signal
• Urban areas: Very accurate
• Rural areas: May have slight delays

__________________________________________________

Tracking Timeline

What Timeline Shows:

Each Event Includes:

• Status name (e.g., "Assigned to Driver")
• Timestamp (exact date and time)
• Location (if GPS data available)
• Additional details (driver name, etc.)

Example Timeline:

 Completed - Nov 1, 2025 3:45 PM
  Photo proof captured, delivery successful

 Arrived at Drop-off - Nov 1, 2025 3:42 PM
  123 Main St, Boston, MA

 En Route to Drop-off - Nov 1, 2025 3:25 PM
  Package picked up, heading to customer

 Arrived at Pickup - Nov 1, 2025 3:20 PM
  456 Warehouse Rd, Boston, MA

 Assigned to Driver - Nov 1, 2025 3:10 PM
  Driver: John Smith

__________________________________________________

Contacting the Driver

When to Contact:

• Driver can't find pickup location
• Package not ready yet
• Special instructions needed
• Checking on delivery progress

How to Contact:

From Tracking Modal:

1. Click "Contact Driver" or phone icon
2. Phone call initiated via Twilio proxy
3. Your number hidden - Driver sees anonymous number
4. Conversation handled normally
5. Hang up when finished

Privacy Protection:

• Driver never sees your real phone number
• You never see driver's real number
• Calls routed through Shaloz system
• Privacy maintained for both parties

Alternative Contact:

• Messages/notes feature (if available)
• Contact support to relay message

__________________________________________________

Refreshing Delivery Status

Automatic Updates:

• Status updates via WebSocket (real-time)
• No manual refresh needed normally
• Updates appear instantly across all open tabs

Manual Refresh:

When to Use:

• Checking for latest status
• WebSocket disconnected
• Verifying completion

How to Refresh:

1. Click "Refresh Status" button in tracking modal
2. Or close and reopen tracking modal
3. Or refresh entire page

__________________________________________________

Canceling a Delivery in Progress

When You Can Cancel:

• Status: "Pending", "Sent for Delivery", "Assigned to Driver"
• Driver hasn't picked up package yet
• Delivery not completed

When You CANNOT Cancel:

• Driver already picked up package
• Delivery completed
• Package already with customer

How to Cancel:

From Tracking Modal:

1. Click "Cancel Delivery" button
2. Confirm cancellation in dialog
3. Optional: Provide reason
4. Submit cancellation

What Happens:

• Driver notified immediately
• Driver assignment removed
• Payment authorization released
• Order status → "Cancelled"
• Customer notified (if applicable)

__________________________________________________

Viewing Delivery Photo Proof

After Delivery Completes:

Accessing Photo:

1. Open completed order in Fulfillment Data
2. Click "View Delivery Proof" or photo icon
3. Photo modal opens showing delivery photo

Photo Includes:

• Package at delivery location
• Timestamp of photo
• GPS coordinates where taken
• Confirmation of delivery

Why Photo Proof Matters:

• Confirms delivery occurred
• Protects against "package not received" claims
• Shows package location
• Timestamp verification

__________________________________________________

Estimated Time of Arrival (ETA)

How ETA is Calculated:

• Based on current GPS location
• Real-time traffic data
• Driving distance to destination
• Driver's current speed
• Historical delivery time data

ETA Updates:

• Recalculates automatically as driver moves
• Adjusts for traffic conditions
• Becomes more accurate as driver gets closer

ETA Shown For:

• Pickup (when driver en route to pickup location)
• Drop-off (when driver en route to customer)

Example:

ETA to Pickup: 8 minutes
ETA to Customer: 22 minutes

__________________________________________________

Notifications for Tracking Updates

Automatic Notifications:

You Receive Notifications For:

• Driver assigned to order
• Driver en route to pickup
• Driver arrived at pickup
• Package picked up
• Driver en route to customer
• Delivery completed

Notification Channels:

• In-Portal: Bell icon notifications
• Toast Popups: On-screen notifications (if enabled)
• Sound Alerts: Audio notification (if enabled)
• Email: Status update emails (if configured)

Managing Notifications:

1. Click bell icon in header
2. Click gear/settings icon
3. Toggle notification preferences:
4. Toast notifications on/off
5. Sound alerts on/off
6. Save preferences

__________________________________________________

Customer Tracking

What Customers See:

If WooCommerce Integration Active:

• Tracking link in order confirmation email
• Tracking link on order details page
• Similar tracking interface (simplified)
• Driver location on map
• Delivery status updates
• ETA to their address

Customer Cannot:

• Contact you directly from tracking
• Cancel delivery
• Change delivery address
• See driver's personal info

__________________________________________________

Tracking Multiple Deliveries

Dashboard View:

1. Go to Fulfillment Data page
2. Filter by "Processing" status
3. See all active deliveries
4. Click any to view tracking details

Bulk Monitoring:

• View pending by center on Dashboard
• See count of active deliveries
• Identify delays or issues
• Monitor team performance

__________________________________________________

Troubleshooting Tracking Issues

Issue: Driver Location Not Updating

Possible Causes:

• Driver's GPS signal lost
• Driver app in background (phone locked)
• Network connectivity issue
• WebSocket disconnected

Solutions:

• Wait 30-60 seconds for reconnection
• Refresh tracking modal
• Contact driver to ensure app is open
• Check your internet connection

Issue: Can't See Driver Info

Cause: Driver not yet assigned

Solution:

• Status still "Sent for Delivery"
• Wait for driver acceptance
• Usually takes 1-5 minutes
• Contact support if delayed >15 minutes

Issue: ETA Seems Inaccurate

Reasons:

• Traffic conditions changed
• Driver made unexpected stop
• GPS signal interference
• Driver took alternate route

Solution:

• ETA recalculates continuously
• Will become accurate as driver progresses
• Contact driver if concerned

Issue: Tracking Modal Won't Open

Solutions:

• Refresh page
• Clear browser cache
• Try different browser
• Check internet connection
• Contact support

__________________________________________________

Best Practices

For Smooth Tracking:

1. Monitor Active Deliveries

• Check processing orders regularly
• Watch for status changes
• Respond to driver contacts quickly

2. Enable Notifications

• Turn on toast notifications
• Enable sound alerts
• Check notifications frequently

3. Prepare for Pickup

• Have packages ready when driver arrives
• Provide verification code promptly
• Communicate any issues immediately

4. Customer Communication

• Share tracking link with customers
• Set delivery expectations
• Notify customers of any delays

5. Document Issues

• Screenshot tracking if problems occur
• Note timestamps of issues
• Keep delivery photos for records

__________________________________________________

Advanced Tracking Features

Filter and Search:

• Filter by status
• Search by order ID or customer name
• Date range filtering
• Export tracking history

Analytics:

• Average delivery time
• On-time delivery rate
• Driver performance metrics
• Center performance comparison

__________________________________________________

Need Help?

Tracking Not Working?

• Verify order was fulfilled (not just created)
• Check order status is not "Pending"
• Ensure internet connection stable
• Contact support: help.shaloz.com

Questions About Driver Location?

• GPS accuracy varies by location
• Updates every 10-30 seconds
• Driver must have app open

Contact driver directly if urgent