Your Transportation Management Data Template

project44
Your Transportation Management Data Template

Your Transportation Management Data Template

This template provides a comprehensive guide for extracting and structuring your project44 transportation data. It outlines the essential attributes to collect and the key activities to track, enabling deep analysis of your shipment process. Use this resource to identify bottlenecks, optimize carrier performance, and reduce operational costs.
  • Recommended attributes to collect
  • Key activities to track
  • Extraction guidance
New to event logs? Learn how to create a process mining event log.

Transportation Management Attributes

These are the recommended data fields to include in your event log for comprehensive analysis of your transportation management process in project44.
5 Required 7 Recommended 9 Optional
Name Description
Activity Name
ActivityName
The name of a specific event or milestone that occurred within the shipment lifecycle.
Description

The Activity Name describes a discrete step or status update in the transportation process, such as 'Carrier Assigned', 'Goods Picked Up', or 'Shipment Delayed'. These activities form the nodes of the process map, and their sequence defines the shipment's journey.

Analyzing these activities is the core of process mining. By examining the order, frequency, and duration between activities, analysts can identify bottlenecks, rework loops, and inefficient process variants. This attribute is essential for building dashboards that track process flow and calculating KPIs related to specific process steps.

Why it matters

This attribute defines the steps in the transportation process, allowing for the visualization of the process flow and the identification of bottlenecks.

Where to get

Derived from event type or status update fields within the project44 event tracking data streams.

Examples
Shipment CreatedGoods Picked UpCustoms ClearedGoods Delivered
Event Time
EventTime
The timestamp indicating when a specific activity or event occurred.
Description

Event Time is the date and time recorded for each activity in the shipment's lifecycle. This chronological data is the backbone of process mining, as it allows for the reconstruction of the process flow exactly as it happened.

This attribute is used to calculate all duration-based metrics, including cycle times, waiting times, and processing times. It is fundamental for identifying delays, measuring performance against schedules, and understanding the temporal dynamics of the transportation process. All time-related KPIs, such as On-Time Delivery Rate and Average Transit Time, depend on accurate Event Time data.

Why it matters

This mandatory timestamp enables the chronological ordering of activities and is the basis for all performance and duration calculations.

Where to get

This corresponds to the timestamp associated with each event in the project44 data feed.

Examples
2023-10-26T10:00:00Z2023-10-27T14:30:00Z2023-11-05T09:15:00Z
Shipment
Shipment
The unique identifier for a single movement of goods, serving as the primary case for process analysis.
Description

The Shipment attribute is the central case identifier that groups all related events and activities for a single transportation order. It allows for a complete, end-to-end analysis of the shipment lifecycle, from its creation and carrier assignment through transit, delivery, and final payment processing.

In process mining, analyzing by Shipment is fundamental. It enables the visualization of process maps, calculation of cycle times for individual shipments, and the identification of common or deviant process paths. All other attributes, such as carrier, delay reason, or cost, are analyzed in the context of this unique identifier.

Why it matters

This is the essential Case ID that connects all related transportation events, making it possible to trace the end-to-end journey of each shipment.

Where to get

This is the primary key for shipment data within project44, often referred to as Shipment ID or Tracking Number in the platform's API and user interface.

Examples
SHP-2023-00123SHP-2023-00456SHP-2023-00789
Last Data Update
LastDataUpdate
The timestamp indicating when the data for this record was last refreshed from the source system.
Description

This attribute records the date and time the data was last extracted or updated from project44. It provides crucial metadata about the freshness of the analysis.

Analysts use this information to understand if they are viewing the most current data available. It is essential for operational dashboards that monitor ongoing shipments and for ensuring that any conclusions drawn from the analysis are based on up-to-date information.

Why it matters

Indicates the freshness of the data, ensuring that analyses are based on current information and supporting operational monitoring.

Where to get

This timestamp is generated and added during the data extraction and loading (ETL) process.

Examples
2023-11-10T02:00:00Z2023-11-11T02:00:00Z
Source System
SourceSystem
The system from which the event data originated.
Description

This attribute identifies the source system providing the data, which in this case is 'project44'. In broader scenarios, it could also specify data coming from an integrated TMS, ERP, or carrier system.

Understanding the source system is important for data governance and troubleshooting. It helps in assessing data quality and reliability, especially when data is aggregated from multiple platforms. For this analysis, it confirms that the events are being tracked via the project44 visibility platform.

Why it matters

Identifies the origin of the data, which is crucial for data governance, quality assessment, and understanding the data's context.

Where to get

This is typically a static value ('project44') added during data ingestion to label the dataset's origin.

Examples
project44P44
Carrier Name
CarrierName
The name of the transportation carrier responsible for the shipment.
Description

This attribute identifies the logistics company or carrier handling the transport of the goods. It could be a trucking company, airline, or ocean liner.

Analyzing performance by carrier is a primary goal of transportation management analysis. This attribute allows for the segmentation of KPIs like On-Time Delivery Rate and Average Transit Time by carrier. It directly supports the 'Carrier Performance and Compliance' dashboard, helping to identify top-performing and underperforming partners.

Why it matters

This is critical for evaluating and comparing carrier performance, enabling data-driven carrier selection and negotiation.

Where to get

Available within the shipment details in the project44 platform, associated with each shipment.

Examples
FedEx FreightMaersk LineXPO LogisticsDHL Express
Delay Reason
DelayReason
A code or description explaining the cause of a shipment delay.
Description

When a shipment is delayed, this attribute provides the reason, such as 'Weather Conditions', 'Customs Hold', or 'Port Congestion'. This information is captured when a 'Shipment Delayed' event occurs.

This is a key attribute for root cause analysis. It powers the 'Delivery Delay Root Cause Analysis' dashboard by allowing analysts to categorize and quantify the most common sources of delays. By understanding why delays happen, organizations can develop targeted strategies to mitigate risks and improve on-time performance.

Why it matters

Enables root cause analysis of delays, helping to identify the most common problems and focus improvement efforts effectively.

Where to get

Captured as part of a delay event or status update within the project44 data stream.

Examples
WEATHER_DELAYCUSTOMS_INSPECTIONTRAFFIC_CONGESTIONMECHANICAL_FAILURE
Destination Country
DestinationCountry
The country where the shipment is scheduled to be delivered.
Description

This attribute specifies the country where the shipment's journey ends. It is part of the destination location details.

Paired with Origin Country, this attribute is crucial for analyzing transportation lanes. It helps uncover performance differences between domestic and international routes, highlights countries with frequent customs delays, and provides context for variations in transit times and costs. It is essential for dashboards focusing on geographic performance and delay hotspots.

Why it matters

Crucial for analyzing transportation lanes, comparing domestic vs. international performance, and pinpointing cross-border issues.

Where to get

Part of the destination address information associated with the shipment in project44.

Examples
CANUSAFRAJPN
Mode Of Transport
ModeOfTransport
The method of transportation used for the shipment, such as Truck, Air, Ocean, or Rail.
Description

This attribute specifies the transportation mode. A single shipment may involve multiple modes, but this typically refers to the primary mode used for the main leg of the journey.

Segmenting analysis by Mode of Transport is crucial for understanding performance variations. Different modes have distinct process flows, costs, and typical durations. This attribute allows for apples-to-apples comparisons and helps tailor improvement initiatives to the specific challenges of truckload, LTL, air freight, or ocean shipping.

Why it matters

Allows for performance and cost analysis to be segmented by transportation mode, which is essential due to their different operational characteristics.

Where to get

A standard data point associated with shipment details in project44.

Examples
TruckloadLTLOceanAirRail
Origin Country
OriginCountry
The country where the shipment originates.
Description

This attribute specifies the country from which the shipment begins its journey. It is part of the origin location details.

Geographic analysis is vital for identifying regional performance issues. By using Origin Country and Destination Country, analysts can create performance maps, identify problematic lanes, and understand how customs or cross-border movements impact cycle times. It directly supports the 'Geographic Shipment Performance Map' dashboard.

Why it matters

Enables geographic analysis of performance, helping to identify region-specific bottlenecks, especially for international shipments.

Where to get

Part of the origin address information associated with the shipment in project44.

Examples
USADEUCHNMEX
Requested Delivery Date
RequestedDeliveryDate
The delivery date requested by the customer or agreed upon in the transportation order.
Description

This attribute stores the target delivery date for the shipment. It serves as the baseline against which actual delivery performance is measured.

This date is essential for calculating the 'On-Time Delivery Rate' KPI. It is compared with the timestamp of the 'Goods Delivered' activity to determine if a shipment was on-time, early, or late. This analysis is fundamental to measuring customer satisfaction and supply chain reliability.

Why it matters

This is the benchmark for calculating the On-Time Delivery Rate KPI, a critical measure of service level and customer satisfaction.

Where to get

Typically part of the initial shipment order data, sourced from a TMS or ERP and visible in project44.

Examples
2023-11-15T23:59:59Z2023-12-01T23:59:59Z2023-12-10T23:59:59Z
Transportation Cost
TransportationCost
The total freight cost associated with the shipment.
Description

This attribute represents the actual or accrued cost for transporting the goods. This can include freight charges, fuel surcharges, and other accessorial fees.

Cost is a critical dimension for process mining analysis. By linking cost data to process data, organizations can identify which process variants, carriers, or delays are driving up expenses. It directly supports the 'Transportation Cost Overrun Insights' dashboard by allowing analysts to correlate high-cost shipments with specific process inefficiencies.

Why it matters

Integrating cost data with process flow allows for the identification of cost drivers and inefficiencies, enabling true cost-to-serve analysis.

Where to get

This information may come from an integrated TMS or ERP system, or from freight audit and payment processes linked to project44 data.

Examples
550.751250.003400.50
Customer Name
CustomerName
The name of the customer or consignee receiving the shipment.
Description

This attribute identifies the end customer for the shipment. This information is critical for understanding performance from a customer-centric point of view.

Analyzing performance by customer helps identify if specific customers are experiencing higher delay rates or longer cycle times. It supports the 'On-Time Delivery Performance Trend' dashboard by allowing segmentation by customer, revealing valuable insights for customer relationship management and service improvement.

Why it matters

Allows for customer-centric analysis, helping to identify service level issues and improve satisfaction for key accounts.

Where to get

This data is typically part of the shipment order information, originating from an ERP or TMS and passed to project44.

Examples
Global Retail Inc.Manufacturing Corp.Pharma Solutions LLC
Event End Time
EventEndTime
The timestamp indicating when a durational activity or event ended.
Description

While EventTime (StartTime) marks the beginning of an activity, EventEndTime marks its completion. This is particularly relevant for activities that have a duration, such as 'Customs Clearance' or 'At Border Crossing'.

Having both a start and end time allows for the precise calculation of activity processing times. For example, the 'Customs Clearance Duration' KPI is calculated as the difference between the EventEndTime and EventTime for the 'Customs Cleared' activity. This provides much more accurate insights into bottlenecks than just measuring the time between different activities.

Why it matters

Enables the precise calculation of durations for activities that span a period of time, such as customs clearance or dwell time.

Where to get

For some events, project44 may provide both a start and end timestamp. Otherwise, it might be the timestamp of the next event.

Examples
2023-11-02T18:00:00Z2023-11-03T11:45:00Z2023-11-08T09:00:00Z
Is On-Time Delivery
IsOnTimeDelivery
A boolean flag indicating if the shipment was delivered on or before the requested delivery date.
Description

This calculated attribute simplifies performance analysis by providing a clear 'true' or 'false' value for on-time status. It is derived by comparing the timestamp of the 'Goods Delivered' activity against the 'RequestedDeliveryDate'.

In dashboards and reports, this flag allows for easy counting, filtering, and visualization of on-time versus late shipments. It is the basis for calculating the overall 'On-Time Delivery Rate' KPI and can be used to segment performance across various dimensions like carrier, route, or customer.

Why it matters

Provides a simple, binary outcome for delivery performance, which is ideal for calculating KPIs and creating summary dashboards.

Where to get

This attribute is not in the source system. It is calculated during data transformation by comparing 'EventTime' of the 'Goods Delivered' activity with the 'RequestedDeliveryDate'.

Examples
truefalse
Proof of Delivery ID
ProofOfDeliveryId
An identifier for the proof of delivery document associated with the shipment.
Description

This attribute stores a reference number or link to the Proof of Delivery (POD) document, which confirms the shipment was received. The 'Proof of Delivery Received' activity marks when this document is available.

Tracking the POD is critical for the financial settlement part of the process. This ID helps link the physical delivery to the administrative processes of invoicing and payment. It is used in the 'POD and Payment Processing Times' dashboard to analyze the efficiency of post-delivery operations.

Why it matters

Links the physical shipment to the financial settlement process, enabling analysis of the time taken to receive delivery confirmation for invoicing.

Where to get

This information is often captured in an event or document management system integrated with project44.

Examples
POD-987654DOC-IMG-5432177A8F9B2-C123-4DEF-B456-1A2B3C4D5E6F
Scheduled Delivery Date
ScheduledDeliveryDate
The planned date and time for the carrier to deliver the goods to the destination.
Description

This attribute contains the scheduled timestamp for the final delivery. This is often a more specific appointment time than the overall 'RequestedDeliveryDate'.

This timestamp is crucial for calculating the 'Delivery Schedule Adherence' KPI. It allows for a more granular analysis of final-mile performance by comparing the scheduled appointment with the actual 'Goods Delivered' timestamp. This helps identify issues with delivery appointments and driver punctuality.

Why it matters

Provides the benchmark for the 'Delivery Schedule Adherence' KPI, enabling analysis of final-mile execution and carrier punctuality.

Where to get

Available in the appointment or scheduling data within project44, often set via the TMS.

Examples
2023-11-05T15:00:00Z2023-11-10T10:00:00Z2023-11-20T16:00:00Z
Scheduled Pickup Date
ScheduledPickupDate
The planned date and time for the carrier to pick up the goods.
Description

This attribute stores the scheduled timestamp for the pickup. It is established during the planning phase, after a carrier is assigned.

This date is used to measure 'Pickup Schedule Adherence'. By comparing the 'ScheduledPickupDate' with the actual timestamp of the 'Goods Picked Up' activity, organizations can assess the reliability of carriers and the efficiency of their own warehouse operations. It helps pinpoint delays that occur at the very beginning of the shipment journey.

Why it matters

Serves as the baseline for the 'Pickup Schedule Adherence' KPI, measuring the punctuality of carriers and shipper readiness.

Where to get

Available in the appointment or scheduling data within project44, often set via the TMS.

Examples
2023-10-26T14:00:00Z2023-10-28T09:00:00Z2023-11-06T11:00:00Z
Shipment Cycle Time
ShipmentCycleTime
The total duration of the shipment from the first event to the last event.
Description

This metric calculates the total elapsed time for each shipment case. It is typically measured from 'Shipment Created' to 'Payment Processed' to represent the full end-to-end process.

Average Shipment Cycle Time is a headline KPI for overall process efficiency. Analyzing the distribution of cycle times helps identify outliers and understand what drives long-running cases. This calculated metric is fundamental for the 'End-to-End Shipment Performance Overview' dashboard and for high-level process health monitoring.

Why it matters

Measures the overall end-to-end efficiency of the transportation process, providing a high-level KPI for performance tracking.

Where to get

This attribute is not in the source system. It is calculated by subtracting the timestamp of the first event from the timestamp of the last event for each unique Shipment ID.

Examples
25 days 4 hours15 days 11 hours32 days 1 hour
Shipment Status
ShipmentStatus
The current high-level status of the shipment.
Description

This attribute provides a snapshot of the shipment's current state in the process, such as 'In Transit', 'Delivered', or 'Exception'. It often reflects the last major activity that occurred.

While process mining derives the flow from activities, a status attribute is useful for filtering and creating high-level summary dashboards. For example, an operational dashboard might focus only on shipments with an 'In Transit' status. It provides a quick way to segment and categorize shipments without analyzing the full event history.

Why it matters

Provides a current-state summary of a shipment, which is useful for filtering, reporting, and operational monitoring dashboards.

Where to get

A standard field in project44 that summarizes the shipment's progress based on the latest event.

Examples
At PickupIn TransitAt DeliveryDelivered
Transit Time
TransitTime
The duration from when goods were picked up until they were delivered.
Description

This calculated metric measures the in-transit portion of the shipment lifecycle. It is calculated as the time difference between the 'Goods Picked Up' and 'Goods Delivered' activities.

This KPI is used to evaluate the efficiency of the core transportation leg, excluding pre-transit planning and post-delivery administration. It helps in assessing carrier speed, route efficiency, and the impact of in-transit delays. It is a key metric for the 'Carrier Performance and Compliance' dashboard.

Why it matters

Isolates the performance of the actual transportation phase, allowing for a focused analysis of carrier and route efficiency.

Where to get

This attribute is not in the source system. It is calculated by finding the duration between the 'Goods Picked Up' and 'Goods Delivered' events for each shipment.

Examples
8 days 2 hours3 days 18 hours12 days 5 hours
Required Recommended Optional

Transportation Management Activities

These are the key process steps and milestones to capture in your event log for accurate process discovery and optimization of your transportation operations.
6 Recommended 8 Optional
Activity Description
Arrival At Destination
The shipment has physically arrived at the destination facility but has not yet been officially unloaded or received. This event precedes the final delivery confirmation.
Why it matters

Marks the end of the in-transit journey. The time between arrival and final delivery can reveal unloading delays or detention issues at the destination.

Where to get

A common visibility event captured from a carrier's EDI 214 status update, telematics, or a geofence event at the destination address.

Capture

Captured from a carrier status update (e.g., EDI 214 with status code 'X1' - Arrived at Delivery Location) or geofence entry.

Event type explicit
Customs Cleared
The shipment has successfully passed all customs inspections and has been released by the authorities to continue its journey. This marks the end of a potential bottleneck for international transit.
Why it matters

This milestone concludes the customs process. Analyzing the time between 'At Border Crossing' and this event directly measures the Customs Clearance Cycle Time KPI.

Where to get

Typically received as an explicit status update from the carrier or a customs broker integrated with the system. The update confirms that customs has released the freight.

Capture

Captured from a carrier or broker status update (e.g., EDI 214 status code 'C1' - Released from Customs).

Event type explicit
Goods Delivered
The shipment has been successfully delivered to the consignee, and the physical transportation portion of the process is complete. This is the primary event for measuring on-time performance.
Why it matters

This is a critical milestone that concludes the transit phase. Its timestamp is used to calculate On-Time Delivery Rate, Average Transit Time, and overall cycle time.

Where to get

This is a core visibility event in project44, captured from a carrier EDI 214 status update, driver app confirmation, or electronic signature capture upon delivery.

Capture

Captured from an explicit carrier delivery confirmation update (e.g., EDI 214 with status 'D1' or 'P1').

Event type explicit
Goods Picked Up
The carrier has physically collected the goods from the origin location, and the shipment is now officially in transit. This is a crucial milestone, often confirmed by the driver or a carrier status update.
Why it matters

This activity marks the true start of the physical transportation. It is essential for calculating actual transit times and measuring carrier pickup performance against the schedule.

Where to get

This is a core visibility event in project44, typically captured from a carrier's EDI 214 status update, telematics data, or a mobile driver app update confirming departure from the pickup location.

Capture

Captured from an explicit carrier status update (e.g., EDI 214 with status code 'AF' or 'X3') or geofence exit event.

Event type explicit
Proof of Delivery Received
The signed Proof of Delivery (POD) document has been received and uploaded into the system. This is an administrative step that is crucial for triggering the invoicing and payment process.
Why it matters

The time taken to receive the POD is a key performance indicator for administrative efficiency. Delays here directly impact the time to bill the customer and pay the carrier.

Where to get

This event corresponds to the timestamp when the POD document image or data is uploaded and associated with the shipment in project44 or an integrated TMS.

Capture

The timestamp of the POD document upload or status update confirming its receipt.

Event type explicit
Shipment Created
This activity marks the creation of the shipment record in the tracking system, typically initiated by an order or transportation request from an upstream system like a TMS or ERP. It represents the start of the shipment lifecycle and the initial data entry for tracking.
Why it matters

This is the primary start event for the process. Analyzing the time between this and subsequent planning activities helps identify delays in shipment planning and initiation.

Where to get

This event is typically captured when a shipment is created via API call or data feed from a Transportation Management System (TMS). It corresponds to the creation timestamp of the shipment entity in project44.

Capture

The creation timestamp of the shipment record ingested from a source system.

Event type explicit
At Border Crossing
The shipment has physically arrived at a national border, indicating the start of the customs clearance process. This is a common point for delays in international shipments.
Why it matters

Pinpoints the start of the customs process, enabling precise measurement of clearance duration. It helps isolate delays caused by border agencies versus other in-transit issues.

Where to get

This event is captured via carrier status updates (e.g., EDI 214 status 'A7' - Arrived at Customs) or by geofencing a known border crossing location.

Capture

Derived from specific carrier status updates or location data indicating arrival at a customs facility.

Event type explicit
Carrier Assigned
A carrier is officially selected and assigned to handle the shipment. This follows the planning and tendering phase and is a prerequisite for booking and scheduling the pickup.
Why it matters

Tracking the time to assign a carrier reveals the efficiency of the planning and procurement process. Delays here can have a cascading effect on the entire shipment schedule.

Where to get

This information is usually part of the shipment master data, updated from a TMS. The event can be inferred from the timestamp when the carrier field is first populated for the shipment.

Capture

Inferred from the timestamp of the update that first populates the carrier name or SCAC code on the shipment record.

Event type inferred
Delivery Scheduled
A specific date and time for the final delivery to the consignee has been arranged. This is a key step in coordinating the final mile of the shipment's journey.
Why it matters

Provides the baseline for measuring the 'Delivery Schedule Adherence %' KPI. It helps analyze the efficiency of final mile logistics and appointment setting.

Where to get

This event is captured from carrier data feeds confirming the delivery appointment. It corresponds to the population of the scheduled delivery appointment timestamp fields.

Capture

Based on delivery appointment data provided by the carrier via EDI, API, or other communication methods.

Event type explicit
ETA Updated
The system has generated a new Estimated Time of Arrival (ETA) based on real-time data such as GPS location, traffic, and carrier updates. This event occurs dynamically throughout the shipment's journey.
Why it matters

Frequent ETA updates are key to proactive transportation management. Analyzing these events helps understand the frequency of changes and the accuracy of initial estimates.

Where to get

This event is generated by project44's platform. It is logged whenever the predictive ETA for the shipment changes by a significant margin or at regular intervals.

Capture

Logged automatically by the project44 platform when its machine learning algorithm recalculates the ETA.

Event type explicit
Freight Bill Audited
The carrier's freight bill has been received, reviewed against the agreed rates and services rendered, and approved for payment. This is a key financial control step.
Why it matters

This activity tracks the efficiency of the accounts payable process. Identifying bottlenecks in freight audit can help reduce payment cycle times and avoid late fees.

Where to get

This is a financial activity that typically occurs in an ERP or a specialized Freight Audit and Pay system. The event can be captured if the status is passed to project44 via an integration.

Capture

A status update from an external financial system indicating the audit is complete.

Event type explicit
Payment Processed
The final payment for the freight services has been executed to the carrier. This activity concludes the entire transportation lifecycle from order to cash.
Why it matters

This is the final end event of the process. Analyzing the time from delivery to payment provides a complete view of the end-to-end cycle and financial efficiency.

Where to get

This event occurs in a financial or ERP system. Its capture relies on an integration that sends a confirmation timestamp or status update back to the visibility platform.

Capture

A timestamped status update from an ERP or financial system confirming payment execution.

Event type explicit
Pickup Scheduled
A specific date and time for the pickup of goods has been arranged with the assigned carrier. This activity signifies the transition from planning to the execution phase of the shipment.
Why it matters

This event provides a baseline for measuring pickup performance and adherence to schedules. It is a critical input for the 'Pickup Schedule Adherence %' KPI.

Where to get

Captured from carrier data feeds or updates from a TMS. It corresponds to the population of the scheduled pickup appointment timestamp fields in project44.

Capture

Based on appointment data provided by the carrier or shipper via EDI, API, or manual update.

Event type explicit
Shipment Delayed
The shipment is identified as being late compared to its scheduled or original estimated delivery time. This can be triggered by a carrier status update or project44's predictive analytics.
Why it matters

This activity is critical for delay root cause analysis. It allows for the isolation of delayed shipments and analysis of associated attributes like carrier, route, and delay reason.

Where to get

This can be an explicit status (e.g., EDI 214 delay code) from the carrier or a calculated event where project44's current ETA exceeds the planned delivery time. The associated delay reason code is often provided.

Capture

Captured from a carrier delay notification or calculated by comparing the current ETA to the appointment time.

Event type explicit
Recommended Optional

Extraction Guides

How to get your data from project44