Core Module Transformation Event
Transformation events record existing input products being consumed to produce new output products. These events represent any process that changes a product's physical form, composition, or packaging in a way that affects its traceability. Unlike the other events, a transformation has no action field.
Event Profile
Transformation events are identified by the following event characteristics.
KDE | Value |
type | TransformationEvent |
disposition | active |
bizStep | commissioning |
KDE Requirements
The following KDEs are required on the root of a transformation event.
| KDE | Description | Example Value |
|---|---|---|
| eventID | A URN formatted universally unique ID (UUID) | urn:uuid:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx |
| transformationID | Identifier for long-running transformations, used to link distinct transformation events. Only applicable when the transformation spans more than one event | urn:uuid:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx |
| inputEpcList | The EPCs of the products being transformed. Used when the input product is traced at instance level | urn:epc:id:sgtin:0614141.107346.0001 |
| inputQuantityList | The EPCs and quantity of the products being transformed. 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.wildfish.lot2", "quantity": 9876, "uom": "KGM" } |
| outputEpcList | The EPCs of the products produced by the transformation. Used when the output product is traced at instance level | urn:epc:id:sgtin:0614141.207346.5001 |
| outputQuantityList | The EPCs and quantity of the products produced by the transformation. Used when the output 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 |
A transformation that spans more than one event repeats the same transformationID on each event, so they can be linked as one transformation.Full JSON Example
{
"@context": [
"https://ref.gs1.org/standards/epcis/epcis-context.jsonld",
{
"gdst": "https://traceability-dialogue.org/epcis"
}
],
"type": "TransformationEvent",
"eventTime": "2026-04-19T22:08:41.6112327+00:00",
"eventTimeZoneOffset": "+00:00",
"eventID": "urn:uuid:b4e07e3a-54cb-47e0-b8f4-6a63d5fc99ee",
"inputQuantityList": [
{
"epcClass": "urn:gdst:example.org:product:lot:class:solution.wildfish.lot2",
"quantity": 9876,"uom": "KGM"
},
{
"epcClass": "urn:gdst:example.org:product:lot:class:solution.farmedfish.lot1",
"quantity": 6000,"uom": "KGM"
}
],
"outputQuantityList": [
{
"epcClass": "urn:gdst:example.org:product:lot:class:solution.processedfish.final1",
"quantity": 15876,
"uom": "KGM"
}
],
"bizStep": "commissioning",
"disposition": "active",
"bizLocation": {
"id": "urn:gdst:example.org:location:loc:solution.processorplant"
}
}