Core Module Aggregation Event
Aggregation events capture the grouping of individual products into a single logistical unit, typically for logistical purposes. Aggregation events are always reversible, meaning the products can always be separated from the logistical unit and retain their original identities.
Event Profile
Aggregation events are identified by the following event characteristics.
KDE | Value |
type | AggregationEvent |
action | ADD |
disposition | active |
bizStep | packing |
KDE Requirements
The following KDEs are required on the root of an aggregation event.
| KDE | Description | Example Value |
|---|---|---|
| eventID | A URN formatted universally unique ID (UUID) | urn:uuid:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx |
| childEPCs | The EPCs of the products being aggregated. Used when the input product is traced at instance level | urn:epc:id:sgtin:0614141.107346.0001 |
| childQuantityList | The EPCs and quantity of the products being aggregated. Used when the input product is traced at lot level (epcClass, quantity, and uom elements should be included) |
{ "epcClass": "urn:gdst:example.org:product:lot:class:examplePrefix.processedfish.final1", "quantity": 15876, "uom": "KGM" } |
| parentID | A URN formatted SSCC identifying the EPC of the parent product the child products are aggregated into | urn:epc:id:sscc:08600031303.solution1 |
| 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 | +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 |
Full JSON Example
{
"@context": [
"https://ref.gs1.org/standards/epcis/epcis-context.jsonld",
{
"gdst": "https://traceability-dialogue.org/epcis"
}
],
"type": "AggregationEvent",
"eventTime": "2026-04-19T13:08:41.6112327+00:00",
"eventTimeZoneOffset": "+00:00",
"eventID": "urn:uuid:a5d495c6-16cc-4b15-96cf-5dfabbe6e585",
"parentID": "urn:epc:id:sscc:08600031303.solution1",
"childEPCs": [],
"action": "ADD",
"bizStep": "packing",
"disposition": "active",
"bizLocation": {
"id": "urn:gdst:example.org:location:loc:solution.processorplant"
},
"childQuantityList": [
{
"epcClass": "urn:gdst:example.org:product:lot:class:solution.processedfish.final1",
"quantity": 15876,
"uom": "KGM"
}
]
}