> ## Documentation Index
> Fetch the complete documentation index at: https://docs.prezio.eu/llms.txt
> Use this file to discover all available pages before exploring further.

# Tariff Components explained

> Understanding the components of electricity pricing

Electricity pricing consists of multiple tariff elements from different organizations. These elements combine to form the total price that end users pay for electricity.

## Element Structure

Each tariff contains multiple components that represent different charges, coming from various organizations in the electricity value chain.

<CardGroup cols={3}>
  <Card title="DSO Elements" icon="tower-cell" color="#83b5ab">
    **Grid costs** from Distribution System Operators:

    * Fixed charges (monthly/yearly subscription fees)
    * Capacity-based charges (based on fuse size/connection capacity)
    * Usage-based charges (per kWh consumed)
    * Time-of-use variations (different prices for day/night)
  </Card>

  <Card title="TSO Elements" icon="tower-broadcast" color="#3f8376">
    **Transmission costs** from Transmission System Operators:

    * System charges for high-voltage grid maintenance
    * Balancing costs for grid stability
    * Capacity fees for transmission infrastructure
  </Card>

  <Card title="Retailer Elements" icon="store" color="#c7beff">
    **Energy costs** from electricity retailers:

    * Energy procurement costs
    * Retailer markup/operating costs
    * Risk premiums (for fixed contracts)
    * Spot market pass-through charges (for variable contracts)
  </Card>

  <Card title="Tax Elements" icon="money-bill" color="#ffb07c">
    **Government charges**:

    * Value Added Tax (VAT)
    * Electricity taxes
    * Renewable energy surcharges
    * Environmental fees
  </Card>

  <Card title="Authority Elements" icon="building-columns" color="#8099a8">
    **Regulatory charges**:

    * Renewable subsidy fees
    * Grid development charges
    * Energy efficiency program funding
  </Card>

  <Card title="Other Elements" icon="shapes" color="#e4e9e8">
    **Miscellaneous charges**:

    * Special local fees
    * Municipal charges
    * Specialized program funding
  </Card>
</CardGroup>

## Element Types by Charging Model

Tariff elements use different calculation methods depending on their purpose:

<AccordionGroup>
  <Accordion title="Per kWh Elements" icon="bolt" defaultOpen>
    Charges that scale with energy consumption:

    * Most common element type
    * Directly proportional to electricity usage
    * Expressed in currency per kilowatt-hour (e.g., €/kWh)

    ```json theme={null}
    {
      "element_id": "com_123",
      "element_name": "Energy Fee",
      "unit": "per_kwh",
      "cost": "0.1045"
    }
    ```
  </Accordion>

  <Accordion title="Fixed Elements" icon="calendar">
    Charges that occur regardless of consumption:

    * Monthly or annual subscription fees
    * Connection fees
    * Administrative charges
    * Expressed as flat currency amount (e.g., €/month)

    ```json theme={null}
    {
      "element_id": "com_456",
      "element_name": "Monthly Subscription",
      "unit": "fixed",
      "cost": "15.00"
    }
    ```
  </Accordion>

  <Accordion title="Capacity-Based Elements" icon="gauge-high">
    Charges based on connection capacity or peak usage:

    * Fuse size fees (e.g., different rates for 16A vs. 25A)
    * Peak power charges
    * Demand charges
    * Expressed in currency per capacity unit (e.g., €/kW or €/A)

    ```json theme={null}
    {
      "element_id": "com_789",
      "element_name": "Capacity Fee",
      "unit": "per_kw",
      "cost": "4.50"
    }
    ```
  </Accordion>
</AccordionGroup>

## Elements in API Responses

Price elements appear in API responses with identifiers, costs, and organization information:

```json theme={null}
{
  "tariff_elements": [
    {
      "element_id": "com_123",
      "element_name": "Grid Usage Fee",
      "organization_id": "org_456",
      "organization_name": "Stockholm Grid",
      "organization_type": "DSO"
    },
    {
      "element_id": "com_789",
      "element_name": "Energy Cost",
      "organization_id": "org_101",
      "organization_name": "Nordic Power",
      "organization_type": "RET"
    }
  ],
  "results": [
    {
      "interval_start": "2023-10-15T14:00:00Z",
      "elements": [
        {
          "id": "com_123",
          "price": "0.052100"
        },
        {
          "id": "com_789",
          "price": "0.104500"
        }
      ],
      "interval_price": "0.156600"
    }
  ]
}
```

## Detail Level Control

Control the granularity of elements in responses using the `detail` parameter:

<Tabs>
  <Tab title="Full Detail">
    Returns complete breakdown of all price components:

    ```json theme={null}
    {
      "elements": [
        {"id": "com_123", "price": "0.052100", "name": "Grid Usage Fee"},
        {"id": "com_456", "price": "0.104500", "name": "Energy Cost"},
        {"id": "com_789", "price": "0.032500", "name": "Electricity Tax"}
      ],
      "interval_price": "0.189100"
    }
    ```

    Use: `detail=full` (default)
  </Tab>

  <Tab title="Semi Detail">
    Aggregates components by organization type:

    ```json theme={null}
    {
      "elements": [
        {"id": "key_DSO", "price": "0.052100"},
        {"id": "key_RET", "price": "0.104500"},
        {"id": "key_TAX", "price": "0.032500"}
      ],
      "interval_price": "0.189100"
    }
    ```

    Use: `detail=semi`
  </Tab>

  <Tab title="Summarized">
    Returns only the total price:

    ```json theme={null}
    {
      "interval_price": "0.189100"
    }
    ```

    Use: `detail=summarized`
  </Tab>
</Tabs>

## VAT Handling

The Prezio API offers flexible VAT handling using the `vat` parameter:

<CardGroup cols={3}>
  <Card title="Excluded" icon="circle-minus" color="#83b5ab">
    All prices excluding VAT (default behavior)

    ```bash theme={null}
    vat=excluded
    ```
  </Card>

  <Card title="Included" icon="circle-plus" color="#c7beff">
    VAT included in each price component

    ```bash theme={null}
    vat=included
    ```
  </Card>

  <Card title="Separated" icon="layer-group" color="#ffb07c">
    VAT shown as a separate component

    ```bash theme={null}
    vat=separated
    ```
  </Card>
</CardGroup>

<Note>
  VAT rates vary by country and sometimes by element type. The Prezio API automatically applies the correct VAT rates based on location and element classification.
</Note>

## Usage in Applications

<Tip>
  When displaying electricity costs to end users, consider presenting key component groups (grid, energy, taxes) separately to help users understand their bill structure.
</Tip>

For charts and visualizations, the semi-detailed response format is often ideal, showing the breakdown between major cost categories while avoiding overwhelming detail.