Skip to main content

Represents a tariff - a rate plan - for a metering point, including eligibility criteria, availability period and one or more Tariff Components, which describe the cost structure and how it's changed over time.

These are long-lived, like "Fuse Tariff 20A", offered by some Party acting as a System Operator.

​
eligibility
Eligibility · object
required

Criteria the customer and metering point must meet.

Example:
{
  "fuse_size": { "unit": "A", "value": 20 },
  "metering_grid_area_ids": [
    "0199c317-25ec-7c00-b1a0-a1b2c3d4e5f6",
    "0199c317-25ec-7c00-b1a0-f6e5d4c3b2a1"
  ],
  "other": ["fuse_based"],
  "type": "system_operator"
}
​
id
string
required

Unique identifier within the Engrate systems.

Example:

"0199c317-25ec-7cf7-94cc-32a39f068433"

​
name
string
required

Tariff name as given by the system operator.

Example:

"Säkringsabonnemang - 20 A"

​
tariff_components
TariffComponent · object[]
required

Tariff components applicable for this tariff.

Example:
[
  {
    "applicable_from": "2025-01-01T00:00:00+01:00",
    "cost": {
      "id": "cost",
      "resolution": "hourly",
      "unit": "SEK"
    },
    "datasets": [
      {
        "id": "quarter-hourly-energy-offtake",
        "resolution": "quarter_hourly",
        "unit": "kWh"
      }
    ],
    "functions": [
      {
        "aggregation_function": "sum",
        "function": "aggregate",
        "input": {
          "id": "quarter-hourly-energy-offtake",
          "resolution": "quarter_hourly",
          "unit": "kWh"
        },
        "output": {
          "id": "hourly-energy",
          "resolution": "hourly",
          "unit": "kWh"
        },
        "resolution": "hourly"
      },
      {
        "function": "multiply",
        "left": {
          "id": "hourly-energy",
          "resolution": "hourly",
          "unit": "kWh"
        },
        "output": {
          "id": "cost",
          "resolution": "hourly",
          "unit": "SEK"
        },
        "right": { "unit": "SEK_per_kWh", "value": 0.536 }
      }
    ],
    "name": "Energiskatt",
    "timezone": "Europe/Stockholm"
  },
  {
    "applicable_from": "2025-01-01T00:00:00+01:00",
    "cost": {
      "id": "cost",
      "resolution": "monthly",
      "unit": "SEK"
    },
    "datasets": [],
    "functions": [
      {
        "function": "constant",
        "output": {
          "id": "cost",
          "resolution": "monthly",
          "unit": "SEK"
        },
        "resolution": "monthly",
        "value": { "unit": "SEK", "value": 187.5 }
      }
    ],
    "name": "Abonnemangsavgift",
    "timezone": "Europe/Stockholm"
  }
]
​
annotations
string | null

Additional remarks, meant for human reading.

Example:

"Tariff needs to be actively requested."

​
available_from
string<date-time> | null

ISO 8601 formatted datetime from when the tariff becomes available, if any. If null, available immediately.

Example:

"2024-01-01T00:00:00+01:00"

​
available_to
string<date-time> | null

ISO 8601 formatted datetime after which the tariff ceases to be available. If null, available until further notice.

Example:

"2026-01-01T00:00:00+01:00"

​
summary
string | null

Brief human-readable summary of the tariff and its tariff components.

Example:

"Fuse-based tariff for 20A with energy tax and monthly subscription fee."