Go back
Digital Container
Shipping
Association
Event naming convention and
Structure 1.0
January 2020
2 | Copyright © 2020 DCSA. All rights reserved.
Legal disclaimer
Copyright 2020 Digital Container Shipping Association (DCSA)
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in
compliance with the License.
You may obtain a copy of the License here: License
Unless required by applicable law or agreed to in writing, software distributed under the License is
distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
implied. See the License for the specific language governing permissions and limitations under the License.
3 | Copyright © 2020 DCSA. All rights reserved.
Naming Convention for Track & Trace Events
INTRODUCTION
Through the years Track & Trace solutions have become a common
service in the container shipping industry. However, due to misalignment
of terminology and ways of working each carrier have designed their own
events, which are published on their webpage.
To align this across the industry the DCSA has developed a Naming
Convention, which sets the standard for naming as well as understanding
of customer facing Track & Trace events.
PURPOSE
Two primary purposes have been defined for the DCSA Event Naming
Convention for Track & Trace:
To ensure equal interpretation of events published through carrier owned
Track & Trace portals.
To ensure that business needs are adequately reflected in the
development of data and interface standards for Track & Trace.
4 | Copyright © 2020 DCSA. All rights reserved.
Booking
Load
Gate-out
Departure
Arrival
Gate-in
Discharge
High-level customer T&T events
Depending on the shipment at hand the multimodal life cycle of a container will go several events across five overall phases. Each phase can repeat itself depending on the need
for additional transport legs. The events in the below overview can take place in a number of different contexts. The DCSA Naming convention ensures, that the context and
understanding of all events are interpreted equally across the industry.
Pre-shipment
Empty
Pre-ocean
Laden
Ocean
Laden
Post-ocean
Laden
Post-shipment
Empty
Stuffing
VGM
Shipping instructions
Load
Gate-out
Departure
Arrival
Gate-in
Discharge
Load
Transport document handling
Departure
Pilot disembarked*
Arrival notice
Arrival at Vessel Traffic
Service*
Arrival at Pilot Station*
Arrival at berth*
Arrival / Mooring complete*
Discharge
Transportation document
surrendered
Shipment release
Load
Gate-out
Departure
Arrival
Gate-in
Discharge
Stripping
Load
Gate-out
Departure
Arrival
Gate-in
Discharge
*: Events marked in red are added to create operational context. These are not included in the customer facing events and will be defined by DCSA during 2020.
5 | Copyright © 2020 DCSA. All rights reserved.
The DCSA Event Naming
Convention
6 | Copyright © 2020 DCSA. All rights reserved.
Event structure
The terminology used in the Event Naming Convention is based on three primary categories of terms, Journeys, Parameters and Values.
EventClassifer TransportMode EventType FacilityType
Value
Value Value
Value
Parameters
EventClassifer TransportMode EventType FacilityType
Planned
Rail
Arrival
Inland
terminal
Structure introduction
The structure leverages the journey types
agreed upon in the IBP 1.0. This means that a
separate syntax exists for the Equipment
Journey, Transport Journey and Shipment
Journey.
For each journey a separate syntax exists. The
syntax is a combination of parameters.
Each parameter can take a number of values.
Each combination of values will generate a
unique event.
All elements including the journeys, parameters
and values have been defined. This means that
for each combination of values, an implicit
definition exists.
EXAMPLE FROM THE TRANSPORT JOURNEY
TERMINOLOGY
7 | Copyright © 2020 DCSA. All rights reserved.
Presentation of structure
The structure is separated into three specific syntaxes based on the already agreed upon journeys.
STRUCTURE
Event
Classifier
Event Type Empty
Indicator
Facility
Type
Equipment Journey
Event
Classifier
Transport
Mode
Event Type Facility
Type
Transport Journey
Shipment
Information
Type
Event Type
Shipment Journey
The journeys
Equipment Journey
The structure of the Equipment Journey governs the naming and understanding of events, which are
driven by physical occurrences related to the equipment in question.
Transport Journey
The structure of the Transport Journey governs the naming and understanding of events, which are
driven by occurrences in the general transport of a shipment. The Transport journey includes all
customer relevant events carried out by one or more modes of transport.
Shipment Journey
The structure of the Shipment Journey governs the naming and understanding of events, which are
driven by occurrences in the documentation flow tied to a shipment. A Shipment can consist of
FCL/LCL and move on CY/CY or CFS/CFS (or combination thereof) basis.