Starta ny hämtning
För att starta ny hämtning krävs det att man anger en API-nyckel för Boverkets engergideklarationsregister i fältet för API-nyckel och väljer den Excel-fil som skall behandlas. Se avsnitterna "API-nyckel" och "Format för fil" för mer information.
I fliken Ny hämtning kan hämtning startas genom att klicka på "Starta" efter att API-nyckel har angets samt fil laddats upp/valts.
När ett arbete startas skapas ett arbetsordernummer som återfinns under fliken "Återuppta hämtning" som valbart värde att om behov finns återuppta eller hämta resultat på nytt.
Fliken "Status" kommer att visas när hämtningen startats för att lättare se status för hämtningen och för att hämta resultat. Se avsnittet "Status och Resultat" för hur resultatet hämtas och hur status för arbetet kan visas.
Återuppta hämtning
På grund av begränsningar i Boverkets API kan en körning behöva fortsättas senare om den lista man avser att köra är för stor. En hämtning kan återupptas även för att på nytt få möjlighet att hämta resultatet som tidigare temporärt sparats undan.
I listan över arbetsordernummer välj den arbetsorder som avses att återupptas och klicka på Återuppta. Om en tidigare hämtning skett i ett annat webbläsarfönster eller på en annan enhet kan eget värde för arbetsordernummer anges för att återuppta den specificerade hämtningen. I fliken "Status" kan resultat för den återupptagna hämtningen följas.
API-nyckel behövs ej anges igen om befintligt arbetsordernummer väljs i listan. Väljer man att ange ett eget värde behövs API-nyckel anges på nytt.
Undvik att återuppta en hämtning som redan återstartats och som ej är klar eller inte nått sin maxgräns (max API-anrop/dygn). Se Status-fliken för mer information.
Det går att rensa sparade arbetsordernummer om så önskas genom att klicka på länken "Rensa tidigare hämtningar" under fliken "Återuppta hämtning".
Status och Resultat
På förstasidan återfinns status för pågående eller genomförd hämtning och resultat av hämtning under fliken "Status".
Här kan status följas och resulatet laddas ner när arbetet är klart. För att manuellt ladda ner resultat klicka på knappen "Hämta".
På grund av begränsningar i Boverkets API kan en körning behöva fortsättas senare om den lista man avser att köra är för stor. Detta kommer då att visas här under denna flik "Delvis klar, maxanrop/dygn uppnått". Återuppta hämtning efter att tidsperiod som anges i Boverkets begränsning löpt ut. Vanligtvis ca. 24-timmar. Läs avsnittet "Återuppta hämtning" för instruktioner för att återuppta hämtning.
Resultat
När hämtningen är klar laddas automatiskt en Excel-fil ner med resultatet, kan också manuellt hämtas genom att klicka på hämta. Excel-filen består av två blad. Första bladet är resulatet och andra bladet är en lista över de fastighetsbeteckningar som ej resulterat i någon träff. Orsaken till detta är att organisationsnummer (OrgNr) har inte kunnat matchas mot varandra i blad 2 och 3 i filen som angavs vid start. Det kan även bero på felstavning eller dylikt.
Avbryta hämtning
Ibland kan det vara nödvändigt att avbryta en pågående hämtning eller återställa sidan till sitt ursprung för att göra ny körning. Klicka på knappen "Avbryt" för att avbryta pågående hämtning. Tidigare hämtningar bibehålls även om hämtning avbryts och kan återupptas eller startas om på nytt.
Format för fil
För uppladdad Excel-fil görs uppslag på energideklarationer från blad 3 på kolumen "Fastighetsbeteckning" i följande format [KOMMUN] [FASTIGHETSBETECKNING], ex: BORLÄNGE HÖNSARVET 27:120 och sammanförs via organisationsnummer (OrgNr) i blad 2 till ett nytt Excel-ark i formatet xlsx som sedan kan laddas ner när arbetet är klart. Det är viktigt att formatet är rätt för att applikationen ska kunna bearbeta och hämta information om energideklarationer.
Krav på format för Excel-fil som skall bearbetas för att hämta energideklarationer:
| Krav | Kommentar |
| Format | xlsx (Microsoft Excel) |
| Filen skall innehålla minst 3 blad | Exempelvis försättningsblad, lista med bostadsrättsföreningar och lista med fastighetsbeteckningar för bostadsrättsföreningar. |
| Informationen i blad 2 | Skall vara den information som skall sammanfogas med hämtade energideklarationer. Exempelvis lista med bostadsrättsföreningar och relaterad information man avser att ha med i slutresultatet. Kolumnen "OrgNr" måste finnas med för att energideklarationer skall hamna på rätt plats (görs via uppslag på fastighetsbeteckningar, se nedan "Informationen i blad 3"). |
| Informationen i blad 3 | Skall bestå av en lista med fastighetsbeteckningar med följande kolumner (kolumnrubriker): "OrgNr" och "Fastighetsbeteckning". |
Ladda ner en exempelfil
Ansök om API-nyckel
En API-nyckel måste anges för att kunna hämta energideklarationer från Boverket. Boverket tillhandhåller ett öppet API för energideklarationer. Ansökan görs hos Boverket här: Publikt api för energideklarationer
Exempel för hur en API-nyckel kan se ut: f2334fdggerd2323132e23fsde
API-nyckel sparas på servern som tar emot begäran om att hämta energideklarationer temporärt för att möjliggöra kommunikation med Boverkets engergideklarationsregister. Vid arbetets slut tas nyckel och arbetsorder bort från servern men sparas i din webbläsare. (Återfinns under fliken Återuppta hämtning).
Felsökning
Om applikationen inte fungerar som förväntat vänligen anteckna eventuella arbetsordernummer som avses att sparas. Töm webbläsarens cache och ladda om sidan. Försök på nytt att skapa en ny hämtning eller återuppta befintlig hämtning genom att manuellt ange arbetsordernummer (se avsnitt om att återuppta hämtning).
Om problem kvarstår, vänligen kontakta oss på info@energideklarationsregistret.se och ange arbetsordernummer om det finns och även en beskrivning över vad som har blivit fel. För frågor kring innehåll i uppladdad fil, resultat av export och energideklarationer från Boverket, vänligen vänd er till Boverket eller till den part som tillhandhåller innehållet i filen. Exempelvis BRF Registret i Gävle.