Skip to main content

Costs in euros

Description​

Calculating costs in euros allows end users to visualize their energy consumption (kWh) converted to monetary costs (€). This feature helps users understand their expenses.

Requirements​

To ensure the euros functionality works correctly for your users, they must meet the following requirements:

1. Active electricity contract​

Users must have an active electricity contract in the app.

warning

For now, this functionality is only available for contracts with 2.0TD tariff access. Gas contracts are not supported yet.

2. Contract configured with its prices​

The contract must be configured with its correct import and surplus tariffs, and with its prices for both power and energy, depending on the tariff.

Contracts are usually retrieved from your ERP. If you send them through the Connect API, you can configure them there. See Contracts in the developer guide.

The following information must be accurately set up:

Tariff type:

  • Import: the tariff type for the energy the user consumes from the grid
  • Surplus: the tariff type for the energy the user exports to the grid

Fixed costs:

  • Contracted power: the maximum power (kW) contracted with the energy provider
  • Power tariff: daily cost per kW of contracted power

Variable costs:

  • Price per kWh: the cost per kilowatt-hour of energy consumed, according to the type of tariff (see the table below)
tip

The tariff types described below apply to both importTariffType and surplusTariffType. Each one is independent, so a contract can use a different type for import and for surplus.

Tariff typePrice used for each hour
FIXEDThe same price for all hours.
PERIODThe same price for every hour of each period (peak, flat, off-peak).
PVPCThe regulated PVPC price for that hour, which Clevergy retrieves automatically.
INDEXEDThe OMIE price of that hour, applying the formula of each energy retailer: A * OMIE + B.
CUSTOMThe prices sent to the contract by your ERP or through the Connect API.

For INDEXED tariffs, you need to provide us with the formula of estimation costs (the values of A and B).

Already billed prices can also be loaded into the contract, through your ERP or the Connect API, so the calculation uses the prices of the invoice.

How cost is calculated​

We use the energy data received from the distributor and calculate, hour by hour, the fixed costs and the variable costs separately. The sum of both gives the cost in euros.

Fixed costs​

Fixed costs do not depend on the energy consumed:

  • Contracted power: the power (kW) contracted by the user
  • Power tariff: the price of the contracted power, in €/kW/day
  • Social bonus financing: the cost is 0.024688 €/day
  • Equipment rental: the cost is 0.0266 €/day
  • Electricity tax (IE): 5.113%
  • VAT: 21%
Hourly fixed cost = { [ (Contracted kW * Power tariff) / 24 + (Social bonus financing €/day / 24) ] * (1 + IE) + (Equipment rental / 24) } * (1 + VAT)

Variable costs​

Variable costs depend on the energy consumed each hour and the price per kWh of import and surplus.

  • Energy import: kWh consumed * import price per kWh.
  • Energy surplus: kWh exported * surplus price per kWh.
Hourly energy import = (kWh imported * Import price) * (1 + IE) * (1 + VAT)
Hourly energy surplus = (kWh exported * Surplus price) * (1 + IE) * (1 + VAT)
info

Import and surplus are calculated separately. When we show the result to the end user, the variable cost is import minus surplus, with a minimum of 0, so it is never negative. This minimum only applies to the variable costs, not to the fixed costs.

Microfrontends that include Euros​

The following app microfrontends include the euros functionality for your users:

  • Invoice estimation: users can see how much they have spent in the current billing period and the estimate of their next bill
  • Alerts settings: users can set spending limits in euros and receive notifications
  • Solar amortization: users can see the savings of their solar installation in euros and when it will pay for itself

These microfrontends also include euros and are still active, but they will be deprecated soon:

  • Energy chart: users can see the evolution of their expenses in euros over time
  • Consumption breakdown: users can analyze what part of their bill corresponds to each type of expense

Frequently asked questions​

Why don't the euros in the app match my users' bills?​

The euros in the app are calculated from the distributor's energy data and the prices configured in the contract. Any differences with actual bills are typically due to billing periods or specific contract terms that may vary from the calculation used in the app.

That is why we always talk about an "estimated value": the euros are a reference to understand expenses, not an exact match to the cent with the bill.

Why do the costs have a delay?​

Hourly consumption comes from the distributor, and distributors send it with an average delay of between 2 and 7 days. The costs in the app are calculated from that data, so they are updated once the distributor sends it.

Can my users set custom spending limits?​

Yes, users can configure spending alerts by going to My profile → Alerts Settings, setting limits in euros for different periods, and receiving notifications when they exceed them.

Do the euros include all costs from my users' bills?​

Almost all of them. The euros include:

  • Energy imported and energy surplus
  • Contracted power
  • Social bonus financing
  • Equipment rental
  • Taxes

The euros do not include the discounts and credits applied from the virtual battery.

If you have any other questions, contact our support team.