EPCIS Event Types

Complete reference for all EPCIS event types and sensor measurements in the Battery DPP

Masterdata that travels with events. masterDataAvailableFor is a GS1 Web Vocabulary term; it maps via @context and needs no gs1: prefix. It carries lot- or serial-level masterdata that belongs to a specific instance or batch: production batch, declaration references, incident records, regulatory citations. GTIN-level masterdata (product name, generic specifications and basic technical attributes that apply to every unit of that GTIN) belongs on the resolver, where it is POSTed once via POST /products/{gtin}, and must not appear in masterDataAvailableFor. Extension vocabularies (battery:, eudr:, textile:, electronics:) must keep their prefix and are declared in the document's @context.

Disclaimer: This reference is not official GS1 guidance. All event patterns follow official GS1 and EPCIS standards:

  • EPCIS 2.0: ObjectEvent structure, sensorElementList
  • CBV 2.0: bizStep (commissioning, inspecting), disposition (active, damaged)
  • UN/CEFACT Rec 20: unit codes (P1, KWH, CEL)

In line with GS1 best practice, every event carries full provenance (who, what, when, where), sensor metadata and links to master data. Feedback is welcome.

Event Types Overview

The Battery DPP records the data that changes over a battery's lifecycle as EPCIS 2.0 events. Each section below describes one event type with its fixed fields, the sensor reports and masterdata it carries, and an example.

Lifecycle Events

Commissioning Event

The commissioning event records the creation of a battery and its initial measurements.

FieldValue
@typeObjectEvent
actionADD
bizStepcommissioning
dispositionactive

It requires sensor reports for battery:stateOfHealth (100%), battery:cycleCount (0) and battery:stateOfCharge. A commissioning event looks like this:

{
  "@context": "https://ref.gs1.org/standards/epcis/epcis-context.jsonld",
  "type": "ObjectEvent",
  "action": "ADD",
  "bizStep": "commissioning",
  "disposition": "active",
  "epcList": [
    "https://id.gs1.org/01/09521234000013/21/BAT2024-001"
  ],
  "sensorElementList": [
    {
      "sensorReport": [
        {
          "type": "battery:stateOfHealth",
          "value": 100,
          "uom": "P1"
        },
        {
          "type": "battery:cycleCount",
          "value": 0
        }
      ]
    }
  ],
  "masterDataAvailableFor": [
    {
      "id": "https://id.gs1.org/01/09521234000013/21/BAT2024-001",
      "lotNumber": "BATCH-2024-03-A"
    }
  ]
}

GTIN-level fields (productName, generic specs, batteryCategory) live on the resolver. The batch identifier is lot-level, so it travels with the event in masterDataAvailableFor.

Ownership Transfer Event

The ownership transfer event records a change of ownership or possession.

FieldValue
@typeObjectEvent
actionOBSERVE
bizStepaccepting
dispositionin_transit

It requires a sourceList and a destinationList, each with an owning_party entry, and a bizTransactionList that references the purchase order or invoice:

{
  "@context": "https://ref.gs1.org/standards/epcis/epcis-context.jsonld",
  "@type": "ObjectEvent",
  "action": "OBSERVE",
  "bizStep": "accepting",
  "disposition": "in_transit",
  "sourceList": [
    {
      "type": "owning_party",
      "source": "https://id.gs1.org/417/9521234000006"
    }
  ],
  "destinationList": [
    {
      "type": "owning_party",
      "destination": "https://id.gs1.org/417/9521987000001"
    }
  ],
  "bizTransactionList": [
    {
      "type": "po",
      "bizTransaction": "https://buyer.example.com/orders/PO-2024-0089"
    }
  ]
}

Regulatory Notification Event

The regulatory notification event records the regulatory compliance status of a battery.

FieldValue
@typeObjectEvent
actionOBSERVE
bizStepnotifying
dispositionconformant

The event references the unit's Declaration of Conformity:

{
  "@context": "https://ref.gs1.org/standards/epcis/epcis-context.jsonld",
  "type": "ObjectEvent",
  "action": "OBSERVE",
  "bizStep": "notifying",
  "disposition": "conformant",
  "persistentDisposition": {
    "set": [
      "conformant"
    ]
  },
  "epcList": [
    "https://id.gs1.org/01/09521234000013/21/BAT2024-001"
  ],
  "masterDataAvailableFor": [
    {
      "id": "https://id.gs1.org/01/09521234000013/21/BAT2024-001",
      "regulatoryInformation": [
        {
          "regulationType": "BATTERY_DIRECTIVE",
          "regulatoryAct": "EU 2023/1542",
          "regulatoryIdentifierType": "EU_DECLARATION_OF_CONFORMITY",
          "regulatoryReferenceNumber": "DoC-BAT-2024-00123"
        }
      ]
    }
  ]
}

regulatoryInformation is a GS1 Web Vocabulary term and needs no gs1: prefix. The declaration is serial-specific because it identifies the Declaration of Conformity of this one unit, so it travels with the event inside masterDataAvailableFor. The compliance state itself is captured on the event as persistentDisposition: "conformant".

Measurement Events

State of Health (SoH)

The State of Health event records the current health status of a battery.

FieldValue
@typeObjectEvent
actionOBSERVE
bizStepinspecting
dispositionactive

It can carry the following sensor reports:

TypeDescriptionUnit
battery:stateOfHealthCapacity-based SoHP1 (%)
battery:stateOfChargeCurrent charge levelP1 (%)
battery:remainingCapacityCurrent max capacityAH
battery:hasRemainingUsableEnergyCurrent max energyKWH
battery:cycleCountFull cycles completed-
battery:capacityFadeCapacity degradationP1 (%)
battery:internalResistancePack resistanceOHM
battery:energyThroughputCumulative energyKWH

A typical set of sensor reports from a periodic measurement:

{
  "sensorReport": [
    { "type": "battery:stateOfHealth", "value": 94.2, "uom": "P1" },
    { "type": "battery:cycleCount", "value": 847 },
    { "type": "battery:capacityFade", "value": 5.8, "uom": "P1" },
    { "type": "battery:internalResistance", "value": 2.4, "uom": "OHM" }
  ]
}

State of Certified Energy (SOCE)

The SOCE event records the State of Certified Energy as defined in the EU Battery Regulation, using these sensor types:

Sensor TypeDescriptionUnit
battery:stateOfCertifiedEnergySOCE percentageP1 (%)
battery:capacityThroughputCumulative capacityAH
battery:powerFadePower degradationP1 (%)
battery:roundTripEfficiencyFadeRTE degradationP1 (%)
battery:hasCurrentSelfDischargingRateSelf-discharge rateP1 (%/month)

Per-instance masterdata travels in masterDataAvailableFor:

  • battery:certifiedUsableEnergy, battery:remainingUsableEnergy: declared values for this unit at this measurement
  • battery:capacityThresholdForExhaustion, battery:expectedRemainingCycles: design value and projection for this unit
  • battery:soceMeasurementId: the measurement record ID

A complete SOCE event:

{
  "@context": [
    "https://ref.openepcis.org/extensions/eu/battery/battery-context.jsonld",
    "https://ref.gs1.org/standards/epcis/epcis-context.jsonld"
  ],
  "type": "ObjectEvent",
  "action": "OBSERVE",
  "bizStep": "inspecting",
  "epcList": [
    "https://id.gs1.org/01/09521234000013/21/BAT2024-001"
  ],
  "sensorElementList": [
    {
      "sensorReport": [
        {
          "type": "battery:stateOfCertifiedEnergy",
          "value": 85.3,
          "uom": "P1"
        },
        {
          "type": "battery:stateOfCertifiedEnergy",
          "battery:certifiedUsableEnergy": {
            "value": "14.3",
            "unitCode": "KWH"
          },
          "battery:remainingUsableEnergy": {
            "value": "12.2",
            "unitCode": "KWH"
          }
        }
      ]
    }
  ],
  "masterDataAvailableFor": [
    {
      "id": "https://id.gs1.org/01/09521234000013/21/BAT2024-001",
      "battery:capacityThresholdForExhaustion": 70,
      "battery:expectedRemainingCycles": 4753,
      "battery:soceMeasurementId": "SOCE-2025-00156"
    }
  ]
}

Carbon Footprint Declaration

The carbon footprint declaration records the lifecycle carbon footprint of a battery, broken down by phase:

Sensor TypeDescriptionUnit
battery:carbonFootprintTotalTotal lifecycle CFPKGM (kg CO2e/kWh)
battery:carbonFootprintRawMaterialExtractionRaw material phaseKGM
battery:carbonFootprintProductionManufacturing phaseKGM
battery:carbonFootprintDistributionDistribution phaseKGM
battery:carbonFootprintRecyclingEnd-of-life phaseKGM

Masterdata for each declaration travels in masterDataAvailableFor:

  • battery:carbonFootprintPerformanceClass: performance class (A to E) of this declared footprint
  • battery:carbonFootprintStudyUrl: link to the study supporting this declaration
  • battery:carbonFootprintDeclarationId: declaration record ID
  • battery:calculationStandard: methodology applied

A complete carbon footprint declaration:

{
  "@context": [
    "https://ref.openepcis.org/extensions/eu/battery/battery-context.jsonld",
    "https://ref.gs1.org/standards/epcis/epcis-context.jsonld"
  ],
  "type": "ObjectEvent",
  "action": "OBSERVE",
  "bizStep": "inspecting",
  "epcList": [
    "https://id.gs1.org/01/09521234000013/21/BAT2024-001"
  ],
  "sensorElementList": [
    {
      "sensorReport": [
        {
          "type": "battery:carbonFootprintTotal",
          "value": 61.2,
          "uom": "KGM"
        },
        {
          "type": "battery:carbonFootprintRawMaterialExtraction",
          "value": 24.5,
          "uom": "KGM"
        },
        {
          "type": "battery:carbonFootprintProduction",
          "value": 28.3,
          "uom": "KGM"
        },
        {
          "type": "battery:carbonFootprintDistribution",
          "value": 4.2,
          "uom": "KGM"
        },
        {
          "type": "battery:carbonFootprintRecycling",
          "value": 4.2,
          "uom": "KGM"
        }
      ]
    }
  ],
  "masterDataAvailableFor": [
    {
      "id": "https://id.gs1.org/01/09521234000013/21/BAT2024-001",
      "battery:carbonFootprintPerformanceClass": "B",
      "battery:calculationStandard": "ISO 14067:2018",
      "battery:carbonFootprintDeclarationId": "CFP-2024-00042"
    }
  ]
}

Adverse Events

Negative Event (Damage/Accident)

The negative event records an accident, damage or a safety incident.

FieldValue
@typeObjectEvent
actionOBSERVE
bizStepinspecting
dispositiondamaged

Two properties sit at event level: battery:incidentSeverity holds the severity classification (Minor, Moderate, Major, Critical), and battery:eventDate records when the incident occurred. Masterdata for each incident travels in masterDataAvailableFor:

  • battery:incidentId: unique ID for this incident
  • battery:inspectorId: GLN or GIAI of the inspector
  • battery:recommendedAction: what to do next

A negative event for minor damage:

{
  "@context": [
    "https://ref.openepcis.org/extensions/eu/battery/battery-context.jsonld",
    "https://ref.gs1.org/standards/epcis/epcis-context.jsonld"
  ],
  "type": "ObjectEvent",
  "action": "OBSERVE",
  "bizStep": "inspecting",
  "disposition": "damaged",
  "epcList": [
    "https://id.gs1.org/01/09521234000013/21/BAT2024-001"
  ],
  "battery:incidentSeverity": "Minor",
  "sensorElementList": [
    {
      "sensorReport": [
        {
          "type": "battery:stateOfHealth",
          "value": 93.8,
          "uom": "P1"
        }
      ]
    }
  ],
  "masterDataAvailableFor": [
    {
      "id": "https://id.gs1.org/01/09521234000013/21/BAT2024-001",
      "battery:incidentId": "INC-2025-00023",
      "battery:recommendedAction": "Schedule follow-up inspection in 30 days"
    }
  ]
}

Temperature Excursion

The temperature excursion event records exposure to temperatures outside safe limits.

FieldValue
@typeObjectEvent
actionOBSERVE
bizStepinspecting
dispositionneeds_replacement or active

It uses these sensor types:

  • battery:maximumTemperature: high temperature exposure
  • battery:minimumTemperature: low temperature exposure
  • Temperature: actual temperature reading (GS1 Web Vocabulary, unprefixed)

The sensor reports can additionally carry battery:exposureDurationMinutes, battery:exceedanceThreshold, minValue, maxValue, meanValue and sDev. Masterdata for each excursion travels in masterDataAvailableFor:

  • battery:temperatureExcursionId: unique ID for this excursion
  • battery:exposureEndTime: when the excursion ended
  • battery:transportConditions: context such as carrier and route
  • battery:estimatedImpact: the assessor's note on the consequence

A temperature excursion that calls for replacement:

{
  "@context": [
    "https://ref.openepcis.org/extensions/eu/battery/battery-context.jsonld",
    "https://ref.gs1.org/standards/epcis/epcis-context.jsonld"
  ],
  "type": "ObjectEvent",
  "action": "OBSERVE",
  "bizStep": "inspecting",
  "disposition": "needs_replacement",
  "epcList": [
    "https://id.gs1.org/01/09521234000013/21/BAT2024-001"
  ],
  "sensorElementList": [
    {
      "sensorReport": [
        {
          "type": "battery:maximumTemperature",
          "value": 65.2,
          "uom": "CEL",
          "minValue": 52.0,
          "maxValue": 65.2,
          "meanValue": 58.4
        },
        {
          "type": "Temperature",
          "value": 65.2,
          "uom": "CEL",
          "battery:exposureDurationMinutes": 127,
          "battery:exceedanceThreshold": 50
        }
      ]
    }
  ],
  "masterDataAvailableFor": [
    {
      "id": "https://id.gs1.org/01/09521234000013/21/BAT2024-001",
      "battery:temperatureExcursionId": "TEMP-EXC-2025-00089",
      "battery:estimatedImpact": "Potential minor capacity degradation",
      "battery:exposureEndTime": "2025-07-17T08:27:00.000Z"
    }
  ]
}

Sensor Metadata

Every sensor measurement should include metadata that identifies the measuring device, the time of the measurement and the method behind it:

{
  "sensorMetadata": {
    "@type": "sensorMetadata",
    "time": "2025-06-15T09:30:00.000Z",
    "deviceID": "https://id.gs1.org/8004/9521987BMS-001",
    "deviceMetadata": "https://bms-vendor.example.com/devices/BMS-3000",
    "dataProcessingMethod": "https://www.iec.ch/standards/62660-1",
    "bizRules": "SoH measurement per EU Battery Regulation 2023/1542"
  }
}
FieldDescription
timeWhen measurement was taken
deviceIDGIAI URI of measuring device
deviceMetadataURL to device specifications
dataProcessingMethodStandard used for measurement
bizRulesBusiness rules applied

Unit Codes Reference

All measurements use UN/CEFACT Rec 20 codes:

MeasurementCodeSymbolExample
PercentageP1%SoH, SoC, Fade
Ampere-hourAHAhCapacity
Kilowatt-hourKWHkWhEnergy
VoltVLTVVoltage
KilowattKWTkWPower
OhmOHMΩResistance
CelsiusCEL°CTemperature
KilogramKGMkgWeight, CO2

bizStep and disposition Values

bizStep (Business Step)

ValueUse Case
commissioningBattery creation
inspectingMeasurements, assessments
acceptingOwnership transfer
notifyingRegulatory notifications
shippingTransport
receivingReceipt at destination

disposition (Disposition)

ValueUse Case
activeNormal operation
in_transitBeing transported
conformantCompliance confirmed
damagedPhysical damage
needs_replacementEnd of service life

Event Sequence Example

Over a typical battery lifecycle, the events occur in this order:

OrderEventbizStepdisposition
1Commissioningcommissioningactive
2Regulatory Filingnotifyingconformant
3Carbon Footprintinspectingactive
4Sale/Transferacceptingin_transit
5Periodic SoHinspectingactive
6Incident (if any)inspectingdamaged
7SOCE Measurementinspectingactive
8+Ongoing monitoringinspectingvaries