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.
| Field | Value |
|---|---|
@type | ObjectEvent |
action | ADD |
bizStep | commissioning |
disposition | active |
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.
| Field | Value |
|---|---|
@type | ObjectEvent |
action | OBSERVE |
bizStep | accepting |
disposition | in_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.
| Field | Value |
|---|---|
@type | ObjectEvent |
action | OBSERVE |
bizStep | notifying |
disposition | conformant |
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.
| Field | Value |
|---|---|
@type | ObjectEvent |
action | OBSERVE |
bizStep | inspecting |
disposition | active |
It can carry the following sensor reports:
| Type | Description | Unit |
|---|---|---|
battery:stateOfHealth | Capacity-based SoH | P1 (%) |
battery:stateOfCharge | Current charge level | P1 (%) |
battery:remainingCapacity | Current max capacity | AH |
battery:hasRemainingUsableEnergy | Current max energy | KWH |
battery:cycleCount | Full cycles completed | - |
battery:capacityFade | Capacity degradation | P1 (%) |
battery:internalResistance | Pack resistance | OHM |
battery:energyThroughput | Cumulative energy | KWH |
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 Type | Description | Unit |
|---|---|---|
battery:stateOfCertifiedEnergy | SOCE percentage | P1 (%) |
battery:capacityThroughput | Cumulative capacity | AH |
battery:powerFade | Power degradation | P1 (%) |
battery:roundTripEfficiencyFade | RTE degradation | P1 (%) |
battery:hasCurrentSelfDischargingRate | Self-discharge rate | P1 (%/month) |
Per-instance masterdata travels in masterDataAvailableFor:
battery:certifiedUsableEnergy,battery:remainingUsableEnergy: declared values for this unit at this measurementbattery:capacityThresholdForExhaustion,battery:expectedRemainingCycles: design value and projection for this unitbattery: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 Type | Description | Unit |
|---|---|---|
battery:carbonFootprintTotal | Total lifecycle CFP | KGM (kg CO2e/kWh) |
battery:carbonFootprintRawMaterialExtraction | Raw material phase | KGM |
battery:carbonFootprintProduction | Manufacturing phase | KGM |
battery:carbonFootprintDistribution | Distribution phase | KGM |
battery:carbonFootprintRecycling | End-of-life phase | KGM |
Masterdata for each declaration travels in masterDataAvailableFor:
battery:carbonFootprintPerformanceClass: performance class (A to E) of this declared footprintbattery:carbonFootprintStudyUrl: link to the study supporting this declarationbattery:carbonFootprintDeclarationId: declaration record IDbattery: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.
| Field | Value |
|---|---|
@type | ObjectEvent |
action | OBSERVE |
bizStep | inspecting |
disposition | damaged |
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 incidentbattery:inspectorId: GLN or GIAI of the inspectorbattery: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.
| Field | Value |
|---|---|
@type | ObjectEvent |
action | OBSERVE |
bizStep | inspecting |
disposition | needs_replacement or active |
It uses these sensor types:
battery:maximumTemperature: high temperature exposurebattery:minimumTemperature: low temperature exposureTemperature: 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 excursionbattery:exposureEndTime: when the excursion endedbattery:transportConditions: context such as carrier and routebattery: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"
}
}
| Field | Description |
|---|---|
time | When measurement was taken |
deviceID | GIAI URI of measuring device |
deviceMetadata | URL to device specifications |
dataProcessingMethod | Standard used for measurement |
bizRules | Business rules applied |
Unit Codes Reference
All measurements use UN/CEFACT Rec 20 codes:
| Measurement | Code | Symbol | Example |
|---|---|---|---|
| Percentage | P1 | % | SoH, SoC, Fade |
| Ampere-hour | AH | Ah | Capacity |
| Kilowatt-hour | KWH | kWh | Energy |
| Volt | VLT | V | Voltage |
| Kilowatt | KWT | kW | Power |
| Ohm | OHM | Ω | Resistance |
| Celsius | CEL | °C | Temperature |
| Kilogram | KGM | kg | Weight, CO2 |
bizStep and disposition Values
bizStep (Business Step)
| Value | Use Case |
|---|---|
commissioning | Battery creation |
inspecting | Measurements, assessments |
accepting | Ownership transfer |
notifying | Regulatory notifications |
shipping | Transport |
receiving | Receipt at destination |
disposition (Disposition)
| Value | Use Case |
|---|---|
active | Normal operation |
in_transit | Being transported |
conformant | Compliance confirmed |
damaged | Physical damage |
needs_replacement | End of service life |
Event Sequence Example
Over a typical battery lifecycle, the events occur in this order:
| Order | Event | bizStep | disposition |
|---|---|---|---|
| 1 | Commissioning | commissioning | active |
| 2 | Regulatory Filing | notifying | conformant |
| 3 | Carbon Footprint | inspecting | active |
| 4 | Sale/Transfer | accepting | in_transit |
| 5 | Periodic SoH | inspecting | active |
| 6 | Incident (if any) | inspecting | damaged |
| 7 | SOCE Measurement | inspecting | active |
| 8+ | Ongoing monitoring | inspecting | varies |