> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.skenarios.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Enerkey-integration

### Skenarios-tjänsten kan automatiskt hämta byggnaders energiförbrukningsdata från Enerkey. Mätaravläsningar hämtas den första dagen varje månad, så att hela föregående månads data importeras på en gång.

## Enerkey är källan till förbrukningsdata

Enerkey är en allmänt använd tjänst inom fastighetssektorn. Där samlas smartmätares förbrukningsvärden på anläggningsnivå (*Laitos*), vanligtvis per byggnad.

## API-nyckel

För att hämta förbrukningsdata till Skenarios måste kommunen eller fastighetsägaren lämna en Enerkey API-nyckel till Skenariolabs.

## Koppling till Skenarios

En Enerkey-anläggning kopplas till Skenarios på två sätt:

1. **Objekt (grupp)** – attributet *EnegiaID*  
2. **Byggnad** – *Permanent byggnadsbeteckning* (PRT / nationellt byggnads-ID)

**Om samma Enerkey-anläggning kan kopplas både via ett objekts EnegiaID och via en byggnads permanenta byggnadsbeteckning lagras förbrukningsdata i första hand på objektet.** Samma avläsning lagras aldrig både på objektet och på byggnaden.

## Koppling av byggnader via permanent byggnadsbeteckning

När det inte finns något matchande EnegiaID på ett objekt (eller anläggningen inte hör till ett sådant objekt) sker kopplingen via fältet *Permanent byggnadsbeteckning*. Samma kundspecifika identifierare ska anges för Enerkey-anläggningen och för byggnaden i Skenarios. När identifierarna stämmer överens uppdateras förbrukningsdata automatiskt på byggnaden.

## Koppling av objekt via EnegiaID

Ett objekt kopplas till en Enerkey-anläggning med identifieraren *EnegiaID*. Vid ibruktagande tilldelar Skenariolabs EnegiaID till organisationens objekt utifrån namn och lägger till dem i objektdata. Eftersom automatisk koppling kan innehålla fel bör användarna kontrollera att EnegiaID:na är korrekta.

Om ett objekt har ett EnegiaID används det i stället för byggnadsnivåns PRT-koppling för den anläggningens avläsningar.

## Underhåll och ändringar

Ett objekt kan ha endast ett EnegiaID åt gången. Om EnegiaID ändras i Enerkey måste uppgiften också uppdateras i objektdata i Skenarios.