Core Module Shipping Event
Shipping events record products leaving one physical location destined for another physical location.
Event Profile
Core shipping events are identified by the following characteristics.
KDE | Value |
type | ObjectEvent |
action | OBSERVE |
disposition | in_transit |
bizStep | shipping |
KDE Requirements
The following properties are required on the root of a core shipping event.
| KDE | Description | Example Value |
|---|---|---|
| eventID | A URN formatted universally unique ID (UUID) | urn:uuid:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx |
| action | The action says how an event relates to the lifecycle of the entity being described. ADD means the entity in question has been created or added to. OBSERVE means the entity in question has not been changed. DELETE means the entity in question has been removed from or destroyed altogether |
ADD, DELETE, OBSERVE |
| disposition | The disposition field of an event specifies the business condition of the event's objects, subsequent to the event. The disposition is assumed to hold true until another event indicates a change of disposition. A full list of disposition values and their definitions is available in the EPCIS Core Business Vocabulary | active |
| eventTime | A string value formatted as an ISO datetime | 2026-01-01T00:00:00.000Z |
| eventTimeZoneOffset | The time zone offset in effect at the time and place the event occurred, expressed as an offset from UTC. The purpose of eventTimeZoneOffset is to provide additional business context about the event, namely to identify what time zone offset was in effect at the time and place the event was captured. | "+00:00" |
| bizLocation | A URN formatted GLN or GDST location identifier validated as a GLN with related master data | urn:epc:id:gln:1234567890123, urn:gdst:example.org:location:loc:examplePrefix.0 |
Source List Requirements
The location must be set on the source list. The source list is an array property of objects that have a type and source property. Entries in sourceList tie the shipment to originating locations and product owners.
| KDE | Description | Example Value |
|---|---|---|
| type | Indicates what is identified by the value, typically the owning party or location | urn:epcglobal:cbv:sdt:owning_party, urn:epcglobal:cbv:sdt:location |
| source | Either a PGLN or GDST party identifier to indicate the owning party or a GLN or GDST location identifier to indicate the location. | urn:epc:id:sgln:08600031303.0.0, urn:gdst:example.org:party:example_prefix.0, urn:gdst:example.org:location:loc:example_prefix.0 |
Example
[
{
"type": "urn:epcglobal:cbv:sdt:owning_party",
"source": "urn:gdst:traceability-solution.com:party:0048000.vessel_owner"
},
{
"type": "urn:epcglobal:cbv:sdt:location",
"source": "urn:gdst:traceability-solution.com:location:loc:0048000.fishing_vessel"
}
]Destination List Requirements
The location must be set on the destination list. The destination list is an array property of objects that have a type and source property. Entries in destinationList tie the shipment to destination locations and product owners.
| KDE | Description | Example Value |
|---|---|---|
| type | Indicates what is identified by the value, typically the owning party or location | urn:epcglobal:cbv:sdt:owning_party, urn:epcglobal:cbv:sdt:location |
| destination | Either a PGLN or GDST party identifier to indicate the owning party or a GLN or GDST location identifier to indicate the location. | urn:epc:id:sgln:08600031303.0.0, urn:gdst:example.org:party:example_prefix.0, urn:gdst:example.org:location:loc:example_prefix.0 |
Example
[
{
"type": "urn:epcglobal:cbv:sdt:owning_party",
"destination": "urn:gdst:traceability-solution.com:party:0048000.port_operator"
},
{
"type": "urn:epcglobal:cbv:sdt:location",
"destination": "urn:gdst:traceability-solution.com:location:loc:0048000.port"
}
]Full JSON Example
{
"@context": [
"https://ref.gs1.org/standards/epcis/epcis-context.jsonld",
{
"gdst": "https://traceability-dialogue.org/epcis"
}
],
"type": "ObjectEvent",
"eventTime": "2026-04-19T11:08:41.6112327+00:00",
"eventTimeZoneOffset": "+00:00",
"eventID": "urn:uuid:c091f489-1088-4848-a06c-74077f98ca5d",
"epcList": [],
"action": "OBSERVE",
"bizStep": "shipping",
"disposition": "in_transit",
"bizLocation": {
"id": "urn:gdst:example.org:location:loc:solution.port"
},
"quantityList": [
{
"epcClass": "urn:gdst:example.org:product:lot:class:solution.wildfish.lot2",
"quantity": 9876,
"uom": "KGM"
}
],
"sourceList": [
{
"type": "location",
"source": "urn:gdst:example.org:location:loc:solution.port"
}
],
"destinationList": [
{
"type": "location",
"destination": "urn:gdst:example.org:location:loc:solution.processorplant"
}
]
}