For å ta i bruk KOBO-integrasjonen er det noen steg som må følges, både av LAFT, Husbanken og kommunen selv. Denne veiledningen viser hva som må gjøres for å koble LAFT mot Husbankens KOBO BoligAPI, og hvem som er ansvarlig for hvert steg. 

Steg 1 – LAFT klargjør internt

Vi sørger for at LAFT sin infrastruktur er klar til å kommunisere med KOBO. Det innebærer å få IP-adressen vår hvitelistet hos Husbanken, hente en unik API-nøkkel for din instans og aktivere integrasjonen i ditt LAFT-område. Du trenger ikke gjøre noe i dette steget.

Steg 2 – Kommunen gjør sin del

Logg inn i Altinn og deleger tilgang til LAFT
En person med riktig rolle i kommunen må logge inn i Altinn og delegere leverandørtilgang til LAFT. Dette gir LAFT tilgang til Maskinporten, det sikre autentiseringssystemet som kontrollerer datautveksling mellom KOBO og LAFT. Les mer om dette på Husbankens side for å komme i gang med Kobo.

Send e-post til Husbanken med organisasjonsnummer
Kommunen sender en egen e-post til brukerservice@husbanken.no og ber om tilgang til Kobo BoligAPI. Oppgi organisasjonsnummeret som skal brukes i Maskinporten i produksjon.
⚠️ Viktig: Husbanken krever to separate e-poster: én fra LAFT og én fra kommunen. Begge sendes til brukerservice@husbanken.no med organisasjonsnummeret som brukes i Maskinporten i produksjon. Husbanken kan ikke åpne opp i produksjon før begge er mottatt.

Steg 3 – Husbanken behandler og åpner

Etter at begge e-postene er mottatt og bekreftet, åpner Husbanken scope i Maskinporten. Behandlingstid er ikke spesifisert fra Husbanken, så følg gjerne opp med Husbanken om det ikke høres noe innen rimelig tid.

Steg 4 – Integrasjonsmøte med alle tre parter

Når tilgang er åpnet, gjennomføres et felles møte der selve integrasjonen settes opp teknisk og testes. I møtet skal partene:

• Kartlegge kommunens arbeidsflyt og tildelingsprosess: hvem gjør hva, i hvilken rekkefølge og hvilke systemer brukes i dag.
• Definere dataflyten: hvilke data oppdateres kun i KOBO, kun i LAFT, eller begge veier? Dette er kritisk for å unngå dobbeltarbeid og konflikter.
• Sette opp selve integrasjonen i produksjon og teste at synkronisering av leieobjekter, reservasjoner og leieforhold fungerer som forventet.
• Identifisere hvilke trinn i kommunens prosess som utløser dataoverføring. Dette gir grunnlag for opplæring og feilsøking i etterkant.

Når stegene beskrevet i forrige kapittel er gjort, er integrasjonen klar til bruk. Nå kan du gå til Administrasjon > Integrasjoner > Kobo for å validere at leieobjektene har nødvendig informasjon før synkronisering. Du får ikke trykke på Synkroniser-knappen før alle påkrevde felter er fylt ut.

Alle kolonner i tabellen må fylles ut før du kan synkronisere leieobjektene mot Kobo. Oransje farge helt til venstre i tabellen indikerer mangelfull informasjon på leieobjektet. Fargen forsvinner når alle felter er fylt ut, og da vil du kunne synkronisere leieobjektet ved å klikke på synkronsieringsknappen til høyre i tabellen. Eventuelt kan du huke av på flere/alle til venstre i tabellen, og klikke på "Synkroniser valgte"-knappen til høyre over tabellen. 

Etter opprettelse av nye leieobjekter kan du gå til Administrasjon > Integrasjoner > Kobo igjen for å synkronisere disse fra LAFT til Kobo. Du vil enkelt kunne se hvilke leieobjekter som er/ikke er synkronisert i tabellen, da synkroniserte leieobjekter har fått en Kobo-ID, samt at det står dato og klokkeslett for synkronisering i kolonne "Sist synkronisert". 

Husbanken har utarbeidet et API som LAFT har koblet seg på. Innholdet i dette API´et, mulighetene det gir og funksjonaliteten det har, er det altså Husbanken som har kontroll over. Den første versjonen av integrasjonen gir følgende funksjonalitet:

• Statusbanner som viser om LAFT er koblet til KOBO.
• Tabelloversikt over alle leieobjekter med KOBO-status, KOBO-id, sist synket-tidspunkt og eventuell feil.
• Inline-redigering av adresse, gnr/bnr, bygningsnummer, bruksenhetsnummer og boligtype rett fra tabellen.
• Filter for manglende data: viser kun rader som ikke kan synkes, så kunden ser hvor det må fylles ut.
• Kolonnevelger for å vise/skjule felt.
• Synk én bolig (opprett eller oppdater i KOBO) via knapp på raden.
• Bulk-synk av flere boliger samtidig: kjøres i bakgrunn, og kunden får live resultat (suksess/feil-telling + topp-5 vanligste feil).
• Frakoble bolig fra KOBO: soft-delete i KOBO, og deretter rydder LAFT vekk koblingen lokalt. Behandles som vellykket selv om KOBO allerede har slettet boligen (idempotent).
• Feildetaljer per rad: klikkbar feilknapp som viser kategori, hint og en "fiks det"-knapp som peker brukeren til riktig sted (bygning, leieforhold, område, support, retry, eller markerer feltet i raden).
• Bestillingsskjema når området ikke har KOBO aktivert ennå.

Hva som skjer automatisk i bakgrunnen:

• Statusendringer på bolig oppdateres automatisk i LAFT.
• Endringer på leieforhold leses inn; ved AVSLUTTET termineres leieforholdet i LAFT.
• Reservasjonsendringer oppdaterer lokal KoboReservation.
• Leieforhold-synkronisering: når et leieforhold lagres i LAFT, forsøkes det pushet til KOBO via Sidekiq-worker.
• Leieforhold-sletting: ved sletting av leieforhold forsøkes soft-delete i KOBO.

Oppsummert - I første versjon vil du kunne:

• Se og rette boligdata før synk til KOBO
• Synke én eller mange boliger til KOBO med ett klikk
• Få boligstatus oppdatert begge veier (KOBO → LAFT automatisk; LAFT → KOBO ved synk)
• Koble en bolig fra KOBO direkte i LAFT
• Se nøyaktig hva som mangler eller feiler, og hvor du skal rette det

Det er Husbanken som vedlikeholder og utvider funksjonalitetene i integrasjonen. Senere i år er planen å utvide med:

• Opprettelse av leieforhold mot KOBO fra LAFT. Worker og modell-hooks finnes, men det er ingen brukergrensesnitt til å sette kobo_saksreferanse på leieforholdet. 
• Reservasjoner. 
• Automatisk push av boligendringer. Boliger pushes kun til KOBO når en administrator trykker "Synk" på integrasjonssiden. Det skjer ikke automatisk når en bolig oppdateres andre steder i LAFT. 
• Oppsigelse av leieforhold mot KOBO.
• Sletting av tildeling på bolig.
• Husstand-/saksopprettelse via SSN (fødselsnummer)

• Synkronisering av leieobjekter Når du legger til eller oppdaterer et leieobjekt i LAFT, sendes informasjonen automatisk til Kobo. Kobo vil oppdatere sine systemer og bekrefte endringen tilbake til LAFT.
• Statusoppdateringer Endringer i status på leieobjekter vil bli synkronisert begge veier. Eksempel: Hvis et leieobjekt blir markert som «ledig» i Kobo, vil denne statusen også vises i LAFT.
• Sletting av leieobjekter Når et leieobjekt slettes i LAFT, fjernes det også fra Kobo.

Kobo vil også etterhvert få en egen temaside i Innsiktsmodulen hvor du kan se eventuelle synkroniseringsfeil, mislykkede synkroniseringer, samt usynkroniserte leieobjekter. De vanligste årsakene til at et leieobjekt ikke kan synkroniseres er:

• Ufullstendig adresse. Leieobjekter i LAFT henter adresse fra bygget det hører til. Sjekk at bygningen ligger inne med fullsteding adresse (gateadresse, postnummer og poststed)
• Bygningen som leieobjektet hører til mangler bygningsnummer, gårds- og bruksnummer og/eller kommunenummer.