Tariff

{
  "available_from": "2024-01-01T00:00:00+01:00",
  "eligibility": {
    "fuse_size": {
      "unit": "A",
      "value": 20
    },
    "metering_grid_area_ids": [
      "0199c317-25ec-7c00-b1a0-a1b2c3d4e5f6",
      "0199c317-25ec-7c00-b1a0-f6e5d4c3b2a1"
    ],
    "other": [
      "offtake",
      "fuse_based"
    ],
    "type": "system_operator"
  },
  "id": "0199c317-25ec-7cf7-94cc-32a39f068433",
  "name": "Säkringsabonnemang - 20 A",
  "summary": "Fuse-based tariff for 20A with energy tax and monthly subscription fee.",
  "tariff_components": [
    {
      "applicable_from": "2026-01-01T00:00:00+01:00",
      "cost": {
        "id": "cost",
        "resolution": "quarter_hourly",
        "unit": "SEK"
      },
      "datasets": [
        {
          "id": "quarter-hourly-energy-offtake",
          "resolution": "quarter_hourly",
          "unit": "kWh"
        }
      ],
      "functions": [
        {
          "left": {
            "id": "quarter-hourly-energy-offtake",
            "resolution": "quarter_hourly",
            "unit": "kWh"
          },
          "output": {
            "id": "cost",
            "resolution": "quarter_hourly",
            "unit": "SEK"
          },
          "right": {
            "unit": "SEK_per_kWh",
            "value": 0.36
          },
          "type": "multiply"
        }
      ],
      "name": "Energiskatt",
      "timezone": "Europe/Stockholm"
    },
    {
      "applicable_from": "2025-01-01T00:00:00+01:00",
      "cost": {
        "id": "cost",
        "resolution": "monthly",
        "unit": "SEK"
      },
      "datasets": [],
      "functions": [
        {
          "output": {
            "id": "cost",
            "resolution": "monthly",
            "unit": "SEK"
          },
          "resolution": "monthly",
          "type": "constant",
          "value": {
            "unit": "SEK",
            "value": 187.5
          }
        }
      ],
      "name": "Abonnemangsavgift",
      "timezone": "Europe/Stockholm"
    }
  ]
}

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.

Show child attributes

Example:

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

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.

Show child attributes

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",
        "input": {
          "id": "quarter-hourly-energy-offtake",
          "resolution": "quarter_hourly",
          "unit": "kWh"
        },
        "output": {
          "id": "hourly-energy",
          "resolution": "hourly",
          "unit": "kWh"
        },
        "resolution": "hourly",
        "type": "aggregate"
      },
      {
        "left": {
          "id": "hourly-energy",
          "resolution": "hourly",
          "unit": "kWh"
        },
        "output": {
          "id": "cost",
          "resolution": "hourly",
          "unit": "SEK"
        },
        "right": { "unit": "SEK_per_kWh", "value": 0.536 },
        "type": "multiply"
      }
    ],
    "name": "Energiskatt",
    "timezone": "Europe/Stockholm"
  },
  {
    "applicable_from": "2025-01-01T00:00:00+01:00",
    "cost": {
      "id": "cost",
      "resolution": "monthly",
      "unit": "SEK"
    },
    "datasets": [],
    "functions": [
      {
        "output": {
          "id": "cost",
          "resolution": "monthly",
          "unit": "SEK"
        },
        "resolution": "monthly",
        "type": "constant",
        "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 at which the tariff ceases to be available (exclusive — the tariff is not available at this instant). 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."

In Optimisation Tariff Component

⌘I

Core

Cost of Energy

Schedule Management

Settlement Management (MaBiS)