Using the Tariff V2 Endpoint for Time of Use

🛠️ Good Practices
1

TariffV2

Tariff Types

TariffV2 supports 3 different types of grid offtake and grid feedin:

  • Static: Weekly recurring prices that are fixed
  • Market Data: Prices are based on EPEX Spot Day-ahead prices
  • External: Prices are provided via API, no calculation is done

Static and Market Data can be mixed, External can’t be mixed with any other tariff.

One system can have one TariffV2.

Creation

All three types can be used via the TariffV2 Endpoint by setting the offtakeType and feedinType.

Get: Retrieve the tariff v2 of a system

Create: Set the tariff v2 of a system

Update: Update the tariff v2 of a system

Static Periods

Static periods are weekly recurring periods with static prices. They are used for example for completely static, day/night and weekend tariffs.If one of offtakeType or feedinType is set to MARKET_DATA , the field marketDataSettings has to be set!

Static periods have to form a closed loop. The loop must cover the whole week:

  1. A period has to end at the start of the next period. The end of the last period has to be the start of the first period.

  2. The weekday field is a numerical identifier for the weekday. 0 = Sunday, 6 = Saturday

  3. The secondsOfDay field is the second of the day of the weekday specified with the corresponding field. A few examples:

  • 0 = midnight
  • 3600 = 1AM – One hour of the day → 60 minutes * 60 seconds
  • 64.800 = 6 PM – 18 Hours * 60 minutes * 60 seconds

Market Data Tariffs

Market data tariffs are calculated based on the market prices from the biddingzone where the system is in. The biddingzone of a system is determined by the biddingzone of the parent accounts.

If one of is set to MARKET_DATA, the field marketDataSettings has to be set!

Market data tariffs have the following settings:

  • offtakeOffset
  • feedinOffset
  • providerFee
  • vat

The formula for calculation the end prices is:

  • Offtake price: (marketPrice + offtakeOffset) * (1 + vat) + provider fee
  • Feedin price: marketPrice + feedinOffset

External Tariffs

External tariffs are tariffs where all prices are sent via API. An external tariff has both offtakeType and feedinType set to EXTERNAL. They can’t be mixed with another type!

Prices can be send with this endpoint: Set tariff end prices of a system

The prices sent to this endpoint have a few restrictions:

  • They have to have a 15 min resolution
  • No gaps to previously stored prices are allowed. Will be explained in detail below.

The prices sent to us can be in a supported foreign currency and will be converted to Euro before storing them.
If not specified, it will be assumed that the sent prices have the same currency as the underlying tariff!

Gaps

Prices sent via API must not have gaps ! This applies to the sent periods itself, but also to when they start. When sending new periods, the first period has to be at or before the last stored period, otherwise a gap would be created.

A few examples:

Valid:

Existing periods: Period 1 | Period 2
New periods     :                     | Period 3 | Period 4

Valid:

Existing periods: Period 1 | Period 2
New periods     :          | Period 2 | Period 3 | Period 4

Overwriting existing periods is allowed, because it doesn’t create gaps.

Invalid:

Existing periods: Period 1 | 
New periods     :          |          | Period 3 | Period 4

Between Period 1 and Period 3 would be a gap

Invalid:

Existing periods: Period 1 | 
New periods     :          | Period 2 |          | Period 4

The sent periods have a gap in themselves.