Core Module Disaggregation Event

Disaggregation events record the breaking down of logistical units into their individual components, allowing each item to once again be tracked on its own.

Event Profile

Disaggregation events are identified by the following characteristics.

KDE

Value

type

AggregationEvent

action

DELETE

disposition

inactive

bizStep

unpacking

KDE Requirements

The following KDEs are required on the root of a disaggregation event. The child product fields are the exception described below.

KDE Description Example Value
eventID A URN formatted universally unique ID (UUID) urn:uuid:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
parentID A URN formatted SSCC identifying the EPC of the parent product being disaggregated urn:epc:id:sscc:08600031303.solution1
childEPCs The EPCs of the products that were disaggregated. Used when the product is traced at instance level urn:epc:id:sgtin:0614141.107346.0001
childQuantityList The EPCs and quantity of the products that were disaggregated. Used when the 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" }
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
Disaggregation events MAY not list any child products in the childQuantityList or childEPCs properties to indicate that all child products were disaggregated from the parent product. In this scenario, you must query for the aggregation event that created the parentID EPC and look up the child products on that event.

Full JSON Example

{
              "@context": [
                  "https://ref.gs1.org/standards/epcis/epcis-context.jsonld",
                  {
                      "gdst": "https://traceability-dialogue.org/epcis"
                  }
              ],
              "type": "AggregationEvent",
              "eventTime": "2026-04-19T16:08:41.6112327+00:00",
              "eventTimeZoneOffset": "+00:00",
              "eventID": "urn:uuid:19c1cfb7-5d89-4214-bc96-39b9ba220295",
              "parentID": "urn:epc:id:sscc:08600031303.solution1",
              "childEPCs": [],
              "action": "DELETE",
              "bizStep": "unpacking",
              "disposition": "inactive",
              "bizLocation": {
                  "id": "urn:gdst:example.org:location:loc:solution.importerwarehouse"
              }
          }


How did we do?

Powered by HelpDocs (opens in a new tab)

Powered by HelpDocs (opens in a new tab)