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.

Event Profile

Transformation events are identified by the following event characteristics.

KDE

Value

type

Transformation Event

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
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"
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
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": "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"
              }
          }


How did we do?

Powered by HelpDocs (opens in a new tab)

Powered by HelpDocs (opens in a new tab)