Tracking lifecycle

Shipment States Overview

The following states are applicable to vessel tracking shipments:

State	Description
`SCHEDULED`	Initial state when a shipment is created with expected payload and planned events
`IN-TRANSIT`	Active tracking state after geofence detection at Port of Loading within the planned departure window
`COMPLETED`	Final state indicating vessel arrival at Port of Discharge with confirmed geofence detection within the planned arrival window
`TRACKING_ENDED_DUE_TO_TIMEOUT`	Terminal state occurring 30 days after planned Port of Discharge arrival when: - No geofence detection occurs at either port - Provided vessel identifiers do not correspond to vessels in the Project44 system

State Transition Details

SCHEDULED State

The initial state upon shipment creation.

Transitions from this state:

To IN-TRANSIT
- Occurs when geofence detection confirms departure at Port of Loading within the planned departure window.
To TRACKING_ENDED_DUE_TO_TIMEOUT
- Occurs in the following scenarios:
  - No geofence detection within planned windows for Port of Loading and Port of Discharge
  - Vessel identifiers do not match Project44 system records
    - System displays: "Tracking initiate failed. No vessel found matching the provided IMO, MMSI, or name."
    - Note: Tracking may resume by updating identifiers via PUT request
  - 30 days elapse from planned Port of Discharge arrival

IN-TRANSIT State

Indicates active vessel tracking after geofence detection for departure from Port of Loading.

Transitions from this state:

To COMPLETED
- Occurs upon geofence detection at Port of Discharge
- Must be within planned arrival window
To TRACKING_ENDED_DUE_TO_TIMEOUT
- Occurs when:
  - No geofence detection within planned arrival window at Port of Discharge
  - 30 days elapse from planned Port of Discharge arrival

COMPLETED State

Indicates successful completion of vessel tracking.

Final state achieved upon confirmed arrival at Port of Discharge
No further transitions occur from this state

Geofence Detection Windows

The system utilizes geofence detection windows to verify vessel presence at ports of loading and discharge. These windows are defined as follows:

Transportation Mode Geofence Detection Window

OCEAN DEPARTURE_FROM_STOP: starts with 2 days before and 8 days after the provided planned departure time at the port of loading.
ARRIVAL_AT_STOP: Starts with 2 days before and 8 days after the provided planned arrival time at the port of discharge.

Example: If planned departure time at Port of loading is 2025-07-10, geofence detection window will start from 2025-07-08 and end at 2025-07-18.

BARGE DEPARTURE_FROM_STOP: starts with the provided planned departure time and end at 1 day after the planned departure time.
ARRIVAL_AT_STOP: starts with the provided planned arrival time and end at 1 day after the planned arrival time.

Example: If planned departure time at Port of loading is 2025-07-10, geofence detection window will start from 2025-07-10 and end at 2025-07-11.

Transportation Mode	Geofence Detection Window
`OCEAN`	`DEPARTURE_FROM_STOP`: starts with `2 days` before and `8 days` after the provided planned departure time at the port of loading. `ARRIVAL_AT_STOP`: Starts with `2 days` before and `8 days` after the provided planned arrival time at the port of discharge. Example: If planned departure time at Port of loading is 2025-07-10, geofence detection window will start from 2025-07-08 and end at 2025-07-18.
`BARGE`	`DEPARTURE_FROM_STOP`: starts with the provided planned departure time and end at `1 day` after the planned departure time. `ARRIVAL_AT_STOP`: starts with the provided planned arrival time and end at `1 day` after the planned arrival time. Example: If planned departure time at Port of loading is 2025-07-10, geofence detection window will start from 2025-07-10 and end at 2025-07-11.