För att implementera KOBO-integrationen finns det några steg som måste följas, både av LAFT, Husbanken och kommunen själv. Den här guiden visar vad som behöver göras för att ansluta LAFT till Husbankens KOBO BoligAPI, och vem som ansvarar för varje steg.

Steg 1 – LAFT förbereder internt

Vi säkerställer att LAFTs infrastruktur är redo att kommunicera med KOBO. Detta innebär att vi vitlistar vår IP-adress hos Husbanken, får en unik API-nyckel för din instans och aktiverar integrationen i ditt LAFT-område. Du behöver inte göra någonting i detta steg.

Steg 2 – Kommunen gör sin del

Logga in på Altinn och delegera åtkomst till LAFT
En person med rätt roll i kommunen måste logga in i Altinn och delegera leverantörsåtkomst till LAFT. Detta ger LAFT tillgång till Maskinporten, det säkra autentiseringssystemet som styr datautbytet mellan KOBO och LAFT. Läs mer om detta på Husbankens sida för att komma igång med Kobo .

Skicka ett mejl till Husbanken med ditt organisationsnummer.
Kommunen skickar ett separat e-postmeddelande till brukerservice@husbanken.no och begär åtkomst till Kobo BoligAPI. Ange organisationsnumret som ska användas i Maskinporten i produktionen.
⚠️ Viktigt : Husbanken behöver två separata e-postmeddelanden: en från LAFT och en från kommunen. Båda skickas till brukerservice@husbanken.no med organisationsnumret som används i Maskinporten i produktionen. Husbanken kan inte öppna produktionen förrän båda har mottagits.

Steg 3 – Husbanken behandlar och öppnar

Efter att båda e-postmeddelandena har mottagits och bekräftats kommer Husbanken att öppna scopet i Maskinporten. Handläggningstiden är inte specificerad av Husbanken, så vänligen följ upp med Husbanken om du inte hör något inom rimlig tid.

Steg 4 – Integrationsmöte med alla tre parter

När åtkomst har beviljats hålls ett gemensamt möte där själva integrationen tekniskt konfigureras och testas. Vid mötet kommer parterna att:

• Kartlägg kommunens arbetsflöde och fördelningsprocess: vem gör vad, i vilken ordning och vilka system används idag.
• Definiera dataflödet: vilka data uppdateras endast i KOBO, endast i LAFT, eller åt båda hållen? Detta är avgörande för att undvika dubbelarbete och konflikter.
• Ställ in själva integrationen i produktionen och testa att synkroniseringen av hyresobjekt, reservationer och leasingavtal fungerar som förväntat.
• Identifiera vilka steg i kommunens process som utlöser dataöverföring. Detta ger underlag för utbildning och felsökning i efterhand.

När stegen som beskrivs i föregående kapitel är slutförda är integrationen klar att användas. Nu kan du gå till Administration > Integrationer > Kobo för att bekräfta att hyresobjekten har nödvändig information innan synkronisering. Du kan inte trycka på knappen Synkronisera förrän alla obligatoriska fält är ifyllda.

Alla kolumner i tabellen måste fyllas i innan du kan synkronisera hyrobjekten med Kobo. Orange färg längst till vänster i tabellen indikerar ofullständig information om hyrobjektet. Färgen försvinner när alla fält är ifyllda, och då kan du synkronisera hyrobjektet genom att klicka på synkroniseringsknappen till höger i tabellen. Alternativt kan du markera flera/alla till vänster i tabellen och klicka på knappen "Synkronisera valda" till höger ovanför tabellen.

Efter att du har skapat nya hyresobjekt kan du gå till Administration > Integrationer > Kobo igen för att synkronisera dessa från LAFT till Kobo. Du kommer enkelt att kunna se vilka hyresobjekt som är/inte är synkroniserade i tabellen, eftersom synkroniserade hyresobjekt har fått ett Kobo-ID, och datum och tid för synkroniseringen listas i kolumnen "Senast synkroniserade".

Husbanken har utvecklat ett API som LAFT har kopplat till. Innehållet i detta API, de möjligheter det ger och den funktionalitet det har, kontrolleras därför av Husbanken. Den första versionen av integrationen tillhandahåller följande funktionalitet:

• Statusbanner som visar om LAFT är ansluten till KOBO.
• Tabellöversikt över alla hyresobjekt med KOBO-status, KOBO-ID, senast synkroniserade tid och eventuella fel.
• Inline-redigering av adress, husnummer/byggnadsnummer, byggnadsnummer, enhetsnummer och bostadstyp direkt från tabellen.
• Saknar datafilter: visar endast rader som inte kan sänkas, så att kunden ser var det behöver fyllas i.
• Kolumnväljare för att visa/dölja fält.
• Synkronisera ett hem (skapa eller uppdatera i KOBO) via knappen på raden.
• Masssynkronisering av flera hem samtidigt: körs i bakgrunden och kunden får liveresultat (antal lyckade/misslyckade + de 5 vanligaste felen).
• Koppla bort egenskapen från KOBO: mjukborttagning i KOBO, och sedan rensar LAFT upp anslutningen lokalt. Behandlas som lyckad även om KOBO redan har tagit bort egenskapen (idempotent).
• Felinformation per rad: klickbar felknapp som visar kategori, ledtråd och en "åtgärda det"-knapp som pekar användaren till rätt plats (byggnad, hyresrätt, område, support, försök igen eller markerar fältet i raden).
• Beställningsformulär när området inte har KOBO aktiverat ännu.

Vad som händer automatiskt i bakgrunden:

• Statusändringar för bostäder uppdateras automatiskt i LAFT.
• Ändringar i hyresavtalet läses in; vid UPPSÄGNING upphör hyresavtalet i LAFT.
• Reservationsändringar uppdaterar lokal KoboReservation.
• Synkronisering av hyresavtal: när ett hyresavtal sparas i LAFT försöker man skicka det till KOBO via Sidekiq-arbetaren.
• Radering av leasingavtal: när ett leasingavtal tas bort försöker man göra en mjuk radering i KOBO.

Sammanfattningsvis - I den första versionen kommer du att kunna:

• Visa och korrigera bostadsdata innan synkronisering med KOBO
• Sänk in ett eller flera hem i KOBO med ett klick
• Få bostadsstatus uppdaterad åt båda hållen (KOBO → LAFT automatiskt; LAFT → KOBO vid synkronisering)
• Anslut ett hem från KOBO direkt i LAFT
• Se exakt vad som saknas eller är fel, och var du kan åtgärda det

Husbanken underhåller och utökar integrationens funktioner. Senare i år är planen att utöka med:

• Skapar ett leasingavtal mot KOBO från LAFT. Arbetar- och modellhookar finns, men det finns inget användargränssnitt för att ställa in kobo_casereference på leasingavtalet.
• Bokningar.
• Automatisk överföring av egenskapsändringar. Egenskaper skickas endast till KOBO när en administratör trycker på "Synkronisera" på integrationssidan. Detta sker inte automatiskt när en egenskap uppdateras någon annanstans i LAFT.
• Uppsägning av hyresavtal mot KOBO.
• Borttagning av bostadstilldelning.
• Skapande av hushåll/ärende via personnummer (personnummer)

• Synkronisera hyresobjekt När du lägger till eller uppdaterar ett hyresobjekt i LAFT skickas informationen automatiskt till Kobo. Kobo uppdaterar sina system och bekräftar ändringen tillbaka till LAFT.
• Statusuppdateringar Ändringar i statusen för hyresobjekt synkroniseras åt båda hållen. Exempel: Om ett hyresobjekt är markerat som "tillgängligt" i Kobo visas denna status även i LAFT.
• Ta bort hyresobjekt När ett hyresobjekt tas bort i LAFT tas det även bort från Kobo.

Kobo kommer så småningom också att ha en dedikerad ämnessida i Insights-modulen där du kan se eventuella synkroniseringsfel, misslyckade synkroniseringar och osynkroniserade hyror. De vanligaste orsakerna till att en hyrd fil inte kan synkroniseras är:

• Ofullständig adress. Hyresfastigheter i LAFT får sin adress från byggnaden de tillhör. Kontrollera att byggnaden är listad med en fullständig adress (gatuadress, postnummer och postnummer).
• Byggnaden som hyresfastigheten tillhör saknar byggnadsnummer, gårds- och elnummer och/eller kommunnummer.