Shipment Journey

Define shipment lifecycles with milestones and conditions

Last updated 05 Sept 2024

A Shipment journey is a way of defining the lifecycle of a shipment. The journey is defined by a set of milestones and their conditions that are used to determine the current state of the shipment. This can be very powerful as it allows you to define the journey of a shipment in a very flexible way. As an example, you can define a shipment journey for international shipments that have to go through customs and another journey for domestic shipments that do not have to go through customs.

Anatomy of a Shipment Journey

Shipment Journey Anatomy
gantt section Journey Journey Initialization :a1, 2024-07-01, 1d Journey Milestones :milestones, after a1, 6d section Milestones Milestone 1 :m1, after a1, 2d Milestone 2 :m2, after m1, 2d Milestone 3 :m3, after m2, 2d section Conditions Condition 1 :c1, after a1, 2d Condition 2 :c2, after m1, 2d Condition 3 :c3, after m2, 2d Condition 4 :c3, after m2, 2d section Events Event 1 for Milestone 1 :e1, after a1, 1d Event 2 for Milestone 1 :e2, after e1, 1d Event 1 for Milestone 2 :e3, after m1, 1d Event 2 for Milestone 2 :e4, after m1, 1d Event 3 for Milestone 2 :e5, after e3, 1d Event 1 for Milestone 3 :e6, after e5, 1d Event 2 for Milestone 3 :e7, after e6, 1d Event 3 for Milestone 3 :e8, after e6, 1d

A Shipment Journey is a collection of milestones, conditions, and events that define the lifecycle of a shipment. When a new shipment is created, it is assigned a journey that defines the milestones that the shipment has to go through and the conditions that must be met for the milestones to be considered reached. Each time an event is received for the shipment, the journey is evaluated to determine if any of the milestones have been reached.

Milestones

Milestones are the key points in the shipment journey. They have a name, a description, and a set of conditions that must be met for the milestone to be considered reached. They can be used to create rulesets that define the conditions for sending notifications or triggering actions. For example, you can define a milestone for when the shipment has been picked up by the carrier, and another milestone for when the shipment has been delivered to the recipient.

Conditions
Milestone Sequences
Final Milestones

Below you can read the description for each terms used in the Shipment Journey:

TermDescription
JourneyA complete timeline consisting of multiple Milestones and Conditions.
MilestoneMajor steps a shipment can take along its journey

Example: The shipment reached to the customs in Germany.
ConditionSet of logical evaluations that will be either true or false, determining if the milestone is reached

Example: The shipment is cleared from Customs

Onboarding

Shipment Journey and milestones can be used out of the box with Skrym. To get started, Skrym provides a set of predefined milestones that can be used to define the journey of a shipment:

MilestoneDescription
Order ReceivedWarehouse received notification about the order.
Order SentWarehouse handed over the package to carrier.
Order Delayedin transport: Transporter sent delay event.
Order DeliveredPackage delivered to the final location.

These milestones are assigned to you by default during onboarding and Skrym creates a default journey. That means you can start using them right away without any additional setup. You can simply create a new shipment and assign the predefined journey to it. Skrym will then evaluate the journey each time an event is received for the shipment and update the status of the shipment accordingly.

Of course, these milestones can be fully customized to fit your specific needs, or you can create your own milestones from scratch. Read more about this in here

Pages in this folder