Grid Tariff API ger dig Göteborg Energi Nät AB:s elnätstariffer i maskinläsbart format. Varje tariff beskriver alla avgifter som en kund betalar för sin elnätsanslutning, och exakt hur varje avgift beräknas. Med det kan du till exempel:
visa kunder vilka tariffer som finns och vad de kostar,
räkna ut vad en kunds elnätsavgift blir utifrån förbrukningen,
flytta elanvändning, som elbilsladdning eller uppvärmning, till timmar när elnätsavgiften är låg.
Bassökväg: /gridtariff/v0, på bas-URL:en för UAT eller produktion (se Kom igång).
API:et följer den svenska datastandarden för elnätstariffer (Eltariff API). Standarden tas fram av svenska elnätsföretag tillsammans med fordonstillverkare och aktörer inom smart laddning, i ett projekt som koordineras av RISE Research Institutes of Sweden och finansieras av Energimyndigheten.
Elnätsföretag som inför standarden publicerar sina tariffer i samma format, så kod som du skriver för Göteborg Energi kan även användas mot dem.
elnätsavgift.se: om standarden och projektet.
Eltariff API-specifikationen på GitHub: OpenAPI-specifikationen och dess dokumentation (på engelska).
Göteborg Energi implementerar för närvarande version 0.3.2 av standarden. GET /info visar vilken version API:et implementerar.
Metod och sökväg | Returnerar |
|---|---|
GET /info | Information om API:et: standardversion, nätföretag och när tariffdatan senast uppdaterades. |
GET /tariffs/ | Alla tariffer, plus de kalendermönster som de hänvisar till. |
GET /tariffs/{id} | En tariff, utifrån dess ID (ett UUID), plus kalendermönstren. |
GET /prices?product={product} | Timpriser för en tariff med dynamisk effektavgift. |
GET /prices?componentId={id} | Samma sak, men identifierad med priskomponentens ID. |
/prices tar även emot ett tidsintervall.
Standarden definierar även POST /tariffs/search, för att hitta tariffen för en viss mätpunkt. Den erbjuder Göteborg Energi inte ännu.
En tariff är prislistan för en typ av elnätsanslutning, till exempel GNM63, "Småhus och företag, Max 63A". De viktigaste fälten:
Fält | Betydelse |
|---|---|
id | Unikt ID för den här versionen av tariffen. |
product | Produktkod, t.ex. GNM63. Samma kod kan förekomma flera gånger, med olika giltighetsperioder. |
name, description | När versionen gäller: från och med fromIncluding till, men inte med, toExcluding. |
direction | consumption för el som tas ut från nätet, production för el som matas in på nätet. |
billingPeriod | Hur ofta kunden faktureras. P1M betyder varje månad. |
timeZone | Tidszon för alla tider i tariffen: Europe/Stockholm. |
fixedPrice, energyPrice, powerPrice | De tre typerna av avgifter, som beskrivs nedan. En tariff kan ha en, två eller alla tre. |
När tarifferna ändras, till exempel vid ett nytt år, returnerar API:et både den nuvarande och den kommande versionen. Använd validPeriod för att välja den version som gäller ett visst datum.
En tariffs totala elnätsavgift är summan av dess tre avgiftsgrupper:
Grupp | Vad kunden betalar för | Vanlig enhet |
|---|---|---|
fixedPrice | Att ha en elnätsanslutning (abonnemangsavgift). | SEK per år (pricedPeriod: "P1Y"), faktureras per billingPeriod. |
energyPrice | Mängden överförd el, inklusive energiskatt. | SEK per kWh |
powerPrice | Hur mycket effekt kunden använder samtidigt. | SEK per kW |
Produktionstariffer har inget energyPrice, och alltså ingen energiskatt: skatten betalas bara på el som tas ut från nätet. Där de har ett timpris är det en ersättning till kunden, och därför är det negativt.
Varje grupp innehåller en eller flera komponenter. En komponent har ett price, en unit och en egen validPeriod, och type anger hur den används:
type | Betydelse |
|---|---|
public | Ett fast belopp per period. |
fixed | Ett fast pris per enhet, t.ex. per kWh. |
peak | Ett pris per kW som tillämpas på kundens högsta effektuttag ("toppar"), se nedan. |
dynamic | Ett pris som ändras varje timme. Priserna hämtas från /prices, se nedan. |
Alla priser anges både utan och med moms (priceExVat, priceIncVat), i currency (SEK).
Varje avgiftsgrupp har en costFunction som beskriver hur komponenterna ska kombineras:
costFunction | Betyder |
|---|---|
sum(price(c)) | Summera priserna för alla komponenter. |
sum(energy(c)*price(c)) | För varje komponent: använd energi (kWh) × pris. Summera sedan. |
sum(peak(c)*price(c)) | För varje komponent: kundens effekttopp (kW) × pris. Summera sedan. |
sum(power(h)*price(h)) | För varje timme: medeleffekt under timmen (kW) × timmens pris. Summera sedan. |
För peak-komponenter beskriver peakIdentificationSettings hur toppen mäts. Till exempel: