Transport Leg

Overview

Transport Leg represents an individual execution leg of a transport job. Each leg represents one pickup-to-delivery segment, containing all operational details including routing, telematics, carbon tracking, and delivery confirmation.

Key Fields

Basic Information

• Transport Job: Parent transport job (required)
• Status: Open, Assigned, Started, Completed, Billed (required)
• Date: Leg execution date (required)
• Run Date: Date from assigned Run Sheet
• Priority: Low, Normal, High
• Order: Sequence order in run sheet (read-only)

Transport Details

• Transport Job Type: Type of transport (required)
• Vehicle Type: Vehicle type for this leg (required)
• Hazardous: Hazardous cargo indicator (read-only, from job)
• Refrigeration: Refrigeration required indicator (read-only, from job)

Pickup Information

• Facility Type From: Type of origin facility
• Facility From: Origin facility
• Pick Address: Physical pickup address
• Pick Mode: Pickup mode
• Pick Window Start: Pickup window start time
• Pick Window End: Pickup window end time

Delivery Information

• Facility Type To: Type of destination facility
• Facility To: Destination facility
• Drop Address: Physical delivery address
• Drop Mode: Delivery mode
• Drop Window Start: Delivery window start time
• Drop Window End: Delivery window end time

Run Sheet Assignment

• Run Sheet: Assigned run sheet
• Sales Invoice: Link to sales invoice (read-only)

Routing

• Distance (km): Planned distance
• Duration (min): Planned duration
• Actual Distance (km): Actual distance traveled (read-only)
• Actual Duration (min): Actual time taken (read-only)
• Start Date: Actual start date/time
• End Date: Actual end date/time
• Routing Provider: Provider used for routing (read-only)
• Routing Profile: Routing profile used (read-only)
• Route Map: Visual route map

Telematics

• ETA at Drop: Estimated time of arrival at delivery
• Remaining (km): Remaining distance
• Remaining (min): Remaining time
• Auto Arrival Enabled: Auto-detect arrival
• Auto Departure Enabled: Auto-detect departure
• Arrival Radius (m): Radius for arrival detection (default: 200m)
• Departure Radius (m): Radius for departure detection
• Route Failure Reason: Reason if routing fails

Carbon Tracking

• CO2e (kg): Carbon dioxide equivalent
• Emission Method: PERTONKM or PER_KM
• Emission Scope Applied: Scope of emissions
• Emission Factor: Factor used for calculation
• Emission Factor (g/scop): Factor in grams per scope
• Carbon Provider: Provider used for calculation
• Carbon Source: Source of carbon data
• Carbon Last Computed: Last computation time
• Cargo Weight (kg): Weight of cargo

Delivery Confirmation

• Signature: Delivery signature
• Signed By: Name of person signing
• Date Signed: Date and time of signature (read-only)

Operations

• Delay Reasons: Reasons for delays
• Exception Handling Notes: Notes about exceptions

Status Flow

1. Open: Leg created but not assigned to run sheet
2. Assigned: Leg assigned to a Run Sheet
3. Started: Leg execution has started
4. Completed: Leg execution finished
5. Billed: Leg has been invoiced

Workflow

1. Create Transport Leg

   • Created automatically from Transport Job legs
   • Or created manually
   • Linked to Transport Job

2. Assign to Run Sheet

   • Select Run Sheet in leg
   • Status changes to "Assigned"
   • Leg appears in Run Sheet

3. Calculate Routing

   • System calculates distance and duration
   • Route map is generated
   • ETA is calculated

4. Start Execution

   • Update Start Date when leg starts
   • Status changes to "Started"
   • Telematics tracking begins

5. Track Progress

   • Monitor ETA and remaining distance
   • Auto-arrival/departure detection
   • Update actual distance and duration

6. Complete Delivery

   • Update End Date when completed
   • Capture delivery signature
   • Status changes to "Completed"

7. Billing

   • Create Sales Invoice from completed leg
   • Status changes to "Billed"

Routing

Routing is automatically calculated based on Transport Settings:

• OSRM: Open Source Routing Machine (free)
• Mapbox: Mapbox Directions API (requires API key)
• Google: Google Maps Directions API (requires API key)
• Disabled: Manual entry only

Routing calculates: - Distance between pickup and delivery - Estimated duration - Route map visualization - ETA at delivery location

Telematics

Real-time tracking features:

• ETA Updates: Continuous ETA calculation
• Remaining Distance/Time: Live updates
• Auto Arrival/Departure: Automatic detection when vehicle enters/exits radius
• Route Failure Handling: Alerts if routing fails

Carbon Tracking

Automatic carbon emission calculation:

• Method: PERTONKM or PER_KM
• Emission Factors: Configurable by vehicle type
• Provider: FACTORTABLE, CLIMATIQ, CARBONINTERFACE, or CUSTOM_WEBHOOK
• Auto Compute: Automatic calculation based on distance and cargo weight

Delivery Signature

Capture delivery confirmation:

• Signature: Digital signature capture
• Signed By: Name of person signing
• Date Signed: Automatically recorded

Related Documents

• Transport Job: Parent document
• Run Sheet: Assignment document
• Sales Invoice: Billing document
• Address: Pickup and delivery addresses
• Facility: Origin and destination facilities

Notes

• Transport Leg is the execution unit
• Status updates automatically based on dates and assignments
• Routing requires proper address formatting
• Telematics requires configured provider
• Carbon calculation requires distance and cargo weight
• Signature capture is available on mobile devices
• Actual distance and duration are read-only after submission