On constructor - the array with tariffs is initiated.
// init collection
var tariffs = new Kikker.Edsn.Tariffs.CaptarTariffs();
// Find all tarifs for single CAPTAR code
List<Tariff> foundTariffs = tariffs.FindTariffsForCaptar("8742030116116");
Console.WriteLine("Found tariffs for captar 8742030116116");
foreach (var tariff in foundTariffs)
{
Console.WriteLine(tariff);
}
// Look for single tariff. Result could be NULL (not found)
Tariff? singleTariff = tariffs.FindTariff("8742030116116", new DateTime(2023, 11, 10));
if (singleTariff is not null)
{
Console.WriteLine("Found single tariff:");
Console.WriteLine(singleTariff);
}
else
{
Console.WriteLine("Tariff not found");
}
Result:
Found tariffs for captar 8742030116116
Product = ELK CapTarCode = 8742030116116 DayTariff = 4.7726 From = 2020-01-01 Until = 2020-03-01
Product = ELK CapTarCode = 8742030116116 DayTariff = 4.7726 From = 2020-03-01 Until = 2021-01-01
Product = ELK CapTarCode = 8742030116116 DayTariff = 5.0478 From = 2021-01-01 Until = 2022-01-01
Product = ELK CapTarCode = 8742030116116 DayTariff = 5.3832 From = 2022-01-01 Until = 2023-01-01
Product = ELK CapTarCode = 8742030116116 DayTariff = 8.0586 From = 2023-01-01 Until = 2024-01-01
Product = ELK CapTarCode = 8742030116116 DayTariff = 9.4850 From = 2024-01-01 Until = null
Found single tariff:
Product = ELK CapTarCode = 8742030116116 DayTariff = 8.0586 From = 2023-01-01 Until = 2024-01-01
Tariff class
Single tariff is represented with 5 parameters:
Product of type string can be ELK or GAS,
CapTarCode of type string ,
DayTariff of type decimal,
From of type DateTime represents from which date this tariff is valid,
Until of type DateTime represents until which date this tariff is valid.
Until can be null which means that the tariff is still valid.
Usage - Grid operators and their connections prices
You can also request a list of connections that belong to the grid operator. For every connection you can see the "human friendly" name, captar code and price.
Price depends on your request. You can request details with specific date, specific year or without any date parameter - that will apply today automatically.
var gridOperator = tariffs.FindGridOperatorPrices("8716921000006");
Console.WriteLine(gridOperator);
This will take all grid operators and their connection and apply prices from 2023-01-01
Understand connection price structure
On every GridOperator are assigned several connecrions. Every connection has the CAPTAR designator and it is used to find appropriate price (for the date).
Every connection has fields:
Product of type string can be ELK or GAS
Default of type boolean - it is used from frontend to assume the default (most common) connection type
Connection of type string - it is human friendly connection description
UsageFrom of type decimal - only applicable for GAS connections
UsageUntil of type decimal - only applicable for GAS connection
DayPriceNoVAT of type decimal - it is daily price excluding the VAT
DayPriceVAT of type decimal - that is daily price including the VAT
YearPriceNoVAT of type decimal - it is yearly price excluding the VAT
YearPriceVAT of type decimal - that is yearly price including the VAT
Updating tariffs and bumping up the version
Download new tariffs (csv) from EDSN
Place file in the folder InputFiles and rename the file to contain word tariffs in the name (for maintenance friendly - also include the year in the name).
Update .csproj file to include that file as EmbeddedResource in the ItemGroup section