> ## 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 Integraatio

Skenarios-palvelu mahdollistaa rakennusten energiankulutustietojen automaattisen haun Enerkey-palvelusta. Mittarilukemat haetaan joka kuukauden ensimmäinen päivä, jolloin koko edellisen kuukauden tiedot haetaan kerralla.

## Enerkey on kulutustiedon lähde

Enerkey on kiinteistösektorilla yleisesti käytetty palvelu, johon kerätään älyenergiamittareiden kulutuslukemia rakennuskohtaisesti ns. *Laitos*-tason tietona.

## Rajapinta-avain

Kulutustietojen noutaminen Skenariosiin edellyttää, että kunta tai kiinteistönomistaja toimittaa Enerkey-rajapinta-avaimen Skenariolabsille.

## Kohdistaminen Skenariosiin

Enerkeyn Laitos yhdistetään Skenariosiin kahdella tavalla:

1. **Kohde (ryhmä)** – *EnegiaID*-attribuutti
2. **Rakennus** – *Pysyvä rakennustunnus* (PRT)

**Jos sama Enerkey-mittari voidaan yhdistää sekä kohteen EnegiaID:llä että rakennuksen pysyvällä rakennustunnuksella, kulutustiedot tallennetaan ensisijaisesti kohteelle.** Samaa lukemaa ei tallenneta sekä kohteelle että rakennukselle.

## Rakennusten kohdistaminen pysyvällä rakennustunnuksella

Kun kohteella ei ole vastaavaa EnegiaID:tä (tai laitos ei kuulu tällaiseen kohteeseen), yhdistäminen tapahtuu *Pysyvä rakennustunnus* -kentän avulla. Enerkeyn Laitokselle ja Skenariosin rakennukselle tulee määrittää sama asiakaskohtainen tunniste tähän kenttään. Kun tunnisteet vastaavat toisiaan, kulutustiedot päivittyvät automaattisesti rakennukselle.

## Kohteiden kohdistaminen EnegiaID:llä

Kohde yhdistetään Enerkeyn Laitokseen *EnegiaID*-tunnisteen avulla. Käyttöönoton yhteydessä Skenariolabs määrittää organisaation kohteille EnegiaID:n nimien perusteella ja lisää sen kohteiden tietoihin. Koska automaattinen kohdistus voi sisältää virheitä, käyttäjien tulee tarkistaa, että EnegiaID:t ovat oikein.

Jos kohteella on EnegiaID, sitä käytetään rakennustason PRT-kohdistuksen sijaan kyseisen kohteen lukemille.

## Ylläpito ja muutokset

Kohteella voi olla vain yksi EnegiaID kerrallaan. Jos EnegiaID muuttuu Enerkeyssä, tieto tulee päivittää myös Skenariosin kohdetietoihin.