Schema Reference Overview
ODS-E defines a minimal, interoperable contract for energy asset data exchange.
The schema is split into three complementary surfaces:
energy-timeseries: operational records for generation, consumption, and net flowsasset-metadata: context for assets, sites, and building characteristicserp-enrichment: maintenance history, spare parts inventory, procurement context, failure taxonomy, and alarm frequency analytics sourced from ERP/EAM and SCADA systems
Design Principles
- Keep required fields small and stable
- Normalize the highest-friction OEM differences (timestamps, energy semantics, error states)
- Preserve optional room for richer domain context without breaking interoperability
How to Read the Spec
- Start with Energy Timeseries for record-level requirements.
- Add Asset Metadata for benchmarking, segmentation, and integration use cases.
- See Grid Capacity / Connection Status for GCAR and grid access lifecycle fields.
- Use Inverter API Access to operationalize OEM onboarding and transform verification.
- Add ERP Enrichment Schemas for maintenance, inventory, procurement, and alarm frequency analytics.
- Run Schema Validation before using records in analytics.
Core Record Example
{
"timestamp": "2026-02-05T14:00:00Z",
"kWh": 847.5,
"error_type": "normal"
}