Gränssnittstjänsten för uppdatering av aktielägenhetsuppgifter för disponentsystem

Tabellen innehåller de produkter som är tillgängliga i dagsläget. 

Information kan sökas med FO-nummer och aktiegruppsbeteckning.

Innehåll i administrativa uppgifter

Administrativa uppgifter är:

• underhålls- och ändringsarbeten, det vill säga husbolagets projekt och delägarnas renoveringar.
• redogörelse för underhållsbehov.
• skötsel-, tomt-, underhålls- och kapitalvederlag.
• låneandelar per aktielägenhet.
• uppgifter om fördelning av lån, när användningsändamålet är nybyggnation eller grundförbättring (inkl. renovering).

Till administrativa uppgifter hör inte

• husbolagets regelbundna underhållsåtgärder och mindre reparationsarbeten.
• skötsellån för husbolagets löpande verksamhet.
• användningsavgifter, såsom parkeringsplatsavgift och bastuavgift.
   

Ytterligare funktioner

Dessutom kan följande funktioner i disponentsystemet tillhandahållas via gränssnittstjänsten till husbolagets representanter: bekräftelse av att de anmälda uppgifterna är uppdaterade, överföring av uppgifter från upphörda aktiegrupper till nya aktiegrupper och granskning av lån som kreditgivarna har anmält.

Identifiering och inhämtning av uppgifter

När man behandlar och granskar husbolagets uppgifter via gränssnittstjänsten, kräver Lantmäteriverket alltid en identifierad användare som har rätt att administrera uppgifterna om det berörda husbolaget. Av denna anledning kan uppgifter inte hämtas via tjänsten som bakgrundsprocesser eller masskörningar. Alla uppgifter ska med andra ord hämtas av en identifierad användare. Undantaget till detta är bolagets offentliga uppgifter, koder och sådana gränssnitt för ändringsuppgifter sominte kräver identifiering, och därför kan de hanteras i bakgrunden.

Ändringsuppgifter och puffar

Med ändringsuppgifter avses information om vilken förändring som har skett i husbolagets uppgifter och när förändringen har skett.
Med puffar avses information om en situation som har upptäckts i husbolagets uppgifter och som disponentsystemet eller en användare av systemet bör beakta eller kunna hantera. 

Följande uppgifter kan till exempel tillhandahållas i en puff:

• framtida hinder för förutsättningarna att använda systemet,
• bristfälligt uppdaterad uppgift som upptäckts i husbolagets uppgifter,
• upptäckta kvalitetsfel i husbolagets uppgifter.

Förändringar och puffar som har skett i husbolag kan hämtas med husbolagets FO-nummer.

Uppgifterna kan begäras om de bolag som är aktiva i bostadsdatasystemet. Av svaret framgår identifieringsuppgifterna om de förändringar och puffar som har skett i bolagens aktiegrupper under den angivna tidsperioden.
 

Ändringsuppgifter

• Tillägg, uppdatering eller radering av nytt projekt, delägarrenovering, redogörelse för underhållsbehov, bolagslån och vederlag
• Ny kredit och när den nya krediten har ersatt den gamla krediten samt radering av krediten
• Kreditgivaren har uppdaterat uppgifterna om bolagets kredit
• Uppgiften om bolagets kredit när det gäller fördelning av låneandelar har uppdaterats

Puffar

• uppgifterna om bolagets redogörelse för underhållsbehov, låneandelar och vederlag har inte uppdaterats under perioden
   

Förbindelsen mellan tjänsten och kunden är SSL-skyddad (Secure Socket Layer, HTTPS-protokoll) och identifieringen av kundprogram sker med Mutual TLS-metoden. Lantmäteriverket levererar de nödvändiga certifikaten till kundprogrammet. Identifieringen av slutanvändare sker via systemlicenstjänsten, och de HTTP-rubriker (header) som tjänsten kräver ska finnas med i varje förfrågan. Tjänsten samlar in statistiska uppgifter om antalet förfrågningar. Antalet förfrågningar som systemet hanterar är begränsat per kundsystem för att undvika överbelastning.

Tjänsten är JSON/REST-baserad och kundprogrammet får tillgång till en OpenAPI-beskrivning för att kunna implementera integrationen.

När det gäller gränssnittstjänstens scheman ska det beaktas att den information som skickas tillbaka från gränssnittet kan komma att innehålla nya fält i nya applikationsversioner. Information om ändringar lämnas om möjligt i god tid, men integrationsimplementeringarna bör vara sådana att de klarar av nya fält i datamodellen och kan ignorera dem.

Vi skickar dig teknisk dokumentation om tjänsten när du börjar testanvända tjänsten.
 

Förutsättningar för ibruktagning

Användningen och aktiveringen av gränssnittstjänsten kräver att

• husbolaget ingår i bostadsdatasystemet
  • aktieboken ska ha överförts till Lantmäteriverket i digitalt format via tjänsten för överföring av aktiebok.
• husbolagets representant utfärdar en systemlicens innan hen kan börja anmäla och granska uppgifter i det disponentsystem som hen använder.
  • disponentsystemet ska instruera användaren att utfärda en systemlicens innan administrativa uppgifter administreras och används.
• systemleverantören ska
  1. ansöka om en licens för testanvändning och testanvända gränssnittet. Tillräcklig testning är en förutsättning för att tjänsten ska kunna börja användas i produktionen.
  2. ansöka om användningstillstånd och, när villkoren uppfylls, ingå ett avtal om produktionsanvändning med Lantmäteriverket.
     • Tillståndet och avtalet kräver att datasäkerhets- och dataskyddskraven uppfylls.
     • I avtalet är det möjligt att välja att använda alla administrativa uppgifter, endast ekonomisk information eller information om underhålls- och ändringsarbeten.

Ta i bruk

Aktivering av gränssnittstjänsten kräver ett avtal med Lantmäteriverket och tillstånd enligt lagen om bostadsdatasystemet. Tillstånd att använda tjänsten beviljas på basis av ansökan. Användningstillstånd kan beviljas till organisationer som utvecklar och administrerar disponentsystem eller delar av disponentsystem. Slutanvändarna av disponentsystemet utgörs av disponenter.

1. Ansök först om en licens för testanvändning. Tillräcklig testning är en förutsättning för att tjänsten ska kunna börja användas i produktionen.
2. För testanvändning behöver du en implementering av systemlicensfunktionen. Läs om systemlicensen här.
3. Kontakta kundstödet för webbtjänster per e-post på verkkopalvelut(at)maanmittauslaitos.fi. Ange behovet av att ingå ett produktionsavtal om användning av tjänsten.  
4. Kundstödet skickar dig en ansökningsblankett och en datasäkerhetsbilaga, vilka du ska fylla i. Med samma ansökan kan du även ansöka om en licens för Söktjänsten för aktielägenhetsuppgifter för disponentsystem (REST).
5. Vi överväger att bevilja en licens från fall till fall baserat på de uppgifter som har lämnats i ansökan och datasäkerhetsbilagan. Vid behov begär vi ytterligare uppgifter.
6. Om villkoren för licensen uppfylls, skickar vi avtalet för läsning och undertecknande. Avtalen är formbundna och gäller tillsvidare. I samma sammanhang ber vi uppge IP-adresser för produktionsbruk.
7. Efter att avtalet har ingåtts skickar kundstödet en kopia av avtalet till kunden och de nödvändiga anvisningarna för att inleda produktionsbruk. Teleoperatören levererar certifikat som behövs för produktionsbruk direkt till kunden. 

Ta hänsyn till datasäkerhets- och dataskyddskraven

Licensen och avtalet kräver att datasäkerhets- och dataskyddskraven uppfylls. I datasäkerhetsbilagan begär vi bland annat information om hur er organisation sköter följande i fråga om denna tjänst:

• behandling av personuppgifter,
• organisationens användar- och åtkomsthantering och
• loggning av sökningen efter uppgifter i bostadsdatasystemet.

Användarhantering 

Kundorganisationen ska ordna användarhantering för användare av uppgifter. Användarnas åtkomsträttigheter till uppgifter ska vara uppdaterade. Endast de personer som behöver uppgifterna med anledning av sina arbetsuppgifter får ha användarrättighet till tjänsten. Användarrättigheterna ska spärras till exempel när anställningen upphör eller arbetsuppgifterna ändras. 

Loggning av användning av uppgifter 

Organisationen ska ordna loggning av informationssökning och lagring av loggar. Loggarna ska visa vem som har sökt efter uppgifter, vilka uppgifter och när. Förutom att loggar lagras ska uppgifter om slutanvändaren medfölja i varje gränssnittsförfrågan. 

Lantmäteriverket skapar testdata för disponentsystem i testanvändningsmiljön. Testdata består av fiktiva husbolag och av testpersoner som systemlicensen identifierat och som kan användas till att simulera slutanvändare (till exempel disponenter). Om disponentsystemet har särskilda behov gällande testdata, beaktar vi dem i möjligaste mån.

Du kan testa testanvändningstjänsten för uppdatering av aktielägenhetsuppgifter avgiftsfritt. Tjänsten används enligt följande användarvillkor: villkoren för testanvändningsmiljön (på finska). Läs beskrivningen av testanvändningstjänsten. 

Den testmiljö som skapats för testanvändning innehåller grundläggande uppgifter om fiktiva husbolag för applikationsutveckling och testning av disponentsystemet.

Ansök om en licens för testanvändning av tjänsten genom att kontakta kundstödet för webbtjänster på verkkopalvelut@maanmittauslaitos.fi. 

Ange i meddelandet:

• uppgifter om sökanden,
• vilken typ av tjänst du planerar,
• för vilket ändamål tjänstens uppgifter är avsedda att användas i framtida produktionsbruk och
• vem som använder uppgifter.

För testanvändningstjänsten levererar vi till kontaktpersonen ett certifikat och information om de husbolag där testningen sker. Rätten till testanvändning gäller i sex månader. Testning är avgiftsfri. Tillräcklig testning är en förutsättning för att tjänsten ska kunna börja användas i produktionen.

För testanvändning behöver du implementera funktionen för systemlicens i ditt system. Med systemlicensen säkerställs tekniskt att det disponentsystem som du representerar har ett användningstillstånd till bostadsdatasystemet.
 

Gränssnittets tekniska stöd betjänar mån–fre kl. 8–16. Du kan kontakta stödet via webblanketten.

Stöd för avtal och användarkoder får du på verkkopalvelut@maanmittauslaitos.fi. > om det gäller en avtalsbaserad tjänst

Eventuella störningar meddelas i applikationsinformationen (på finska). Ändringar i tjänsten meddelas på webbplatsen Servicemeddelanden. 
 

Du kan lämna respons och utvecklingsförslag via formuläret.