Samtykkebasert Lånesøknad: Onboardingsguide

Transkript

1 Samtykkebasert Lånesøknad: Onboardingsguide Dato : 08. oktober 2018 Versjon : 2.1 Revisjonshistorikk Dato Versjon Beskrivelse Forfatter Første versjon av dokumentet Jean-Luc Orgeret Endringer i B-2, B-3 og B-4, kapittel 6 side 8 Jean-Luc Orgeret - Ny referanse [SBL_REG] - Endringer i C-1, kapittel 7 side 9 - Nytt trinn D-1, kapittel 8 side Link for referanse [SBL_REG] side 2 Jean-Luc Orgeret Sletting av samtykke hoa Altinn er ikke lenger en funksjonalitet som blir Jean-Luc Orgeret levert da SBL benytter engangs samtykke Dokumentasjon fra Altinn på GitHub Jean-Luc Orgeret - Dokumentasjon for datakonsumenter (Betjeningskonsept) fra Altinn - Ytelsesrapport Altinn Samtykkeløsning Ny link for [SBL_REG] Jean-Luc Orgeret - Nytt kapittel 4) Avgrensninger og betingelser - Endring i B-2, B-3 og D-1. C-4 er nytt - Erstattet «bank» med «finansinstitusjon» Andre versjon av dokumentet Unn-Merete Myrseth -Endring D-1, kapittel 8 side 10 -Endring C-4, kapittel 7 side 9 - Endring [SBL_LTOKODER] - Fjernet [SBL_Testdata] Ny referanse [SBL_ONBD] - Ny referanse [SBL_PROS] - Ny referanse [SBL_INT_TEST] Unn-Merete Myrseth

2 Endring B kapittel 5 side 6, erstattet avtale med vilkår Endring 7) Erstattet avtale med signering av vilkår side Ny referanse [SBL_A-ORD_VLD] Thore Joa Side 2

3 Innholdsfortegnelse Revisjonshistorikk... 1 Innholdsfortegnelse... 3 Referanseliste ) Bakgrunn og hensikt ) Hvordan lese dette dokumentet ) Om Samtykkebasert Lånesøknad (SBL) ) Samtykkeprosess ) Prosess for digital innhenting av data ) Avgrensninger og betingelser ) Onboardingsprosessen ) A - Forberedelse ) B Registrering og signering av vilkår ) C Integrasjon ) D Produksjon ) E Finansinstitusjonens tilpasninger Referanseliste Referanse [SBL_ONBD] [SBL_PROS] [SBL_ BRREG] [SBL_BRREG_SAM] [SBL_SKATT] [SBL_LTOKODER] [SBL_A-ORD_VLD] [SBL_INT_TEST] [SBL_SKJERM] [SBL_REG] [SBL_YTEL] Beskrivelse På Presentasjon av SBL «SBL-Onboarding v.1.1.pdf» På Presentasjon av SBL «SBL-Introduksjon til prosessene v.1.2.pdf» Brønnøysundregistrenes dokumentasjon av Altinn tjenester og forvaltning for datakonsumenter. Altinn dokumentasjon av samtykkeløsningen. Skatteetatens dokumentasjon for utlevering av skattegrunnlag og inntektsopplysninger med samtykke. Overgangsveiledning: Tidligere LTO-koder a-ordningens beskrivelser Veiledningen som beskriver hva slags type informasjon rapporteres i a-ordningen. På Zip-fil «SBL-Integrasjonstest.zip» med oversikt over alle 4 testbrukere tilgjengelige for SBL: - Oversikt over testbrukere og deres påloggingsmekanismer (BankID og MinID) i SBL-Testbrukere-Paaloggingmekanismer v.2.0.pdf - Testcaser: 19 testcaser i SBL Integrasjonstest - Test Case v.2.1.xlsx - Rapport: Mal for rapport for integrasjonstest SBL-Integrasjonstest rapport v.2.1.docx På Presentasjon som inneholder skjermbilder som kan brukes av U/X designere ifm brukertester og utvikling av kundereiser: «SBL-Skjermer for brukertest v.1.0.pptx» Registreringsskjema for å koble seg på SBL: På Ytelsesrapport for Altinn samtykkeløsning Side 3

4 1) Bakgrunn og hensikt Bits, Skatteetaten og Brønnøysundregistrene har tilrettelagt for at norske finansinstitusjoner skal kunne hente ut skattegrunnlag og inntektsopplysninger digitalt basert på et eksplisitt samtykke fra lånesøker. Hensikten med dette dokumentet er å gi finansinstitusjoner som ønsker å tilby lånesøkere en full digital prosess en oversikt over hva som kreves for å kunne implementere en slik prosess ( Samtykkebasert Lånesøknad ): 1. Prosjektfasene en finansinstitusjon må gå igjennom for å kunne ta i bruk Samtykkebasert Lånesøknad 2. Oppgaver som må utføres i hver av prosjektfasene 3. Dokumentasjon som vil kunne bidra til å forenkle planleggingen. Dette dokumentet henviser med lenker til dokumentasjon som befinner seg hos Bits, Skatteetaten eller Brønnøysundregistrene. 2) Hvordan lese dette dokumentet Dokumentet skal benyttes som et referansedokument (og navigeringsverktøy) som gir tilgang til informasjon som er nødvendig for en vellykket etablering av en låneprosess som baserer seg på innhenting av skattegrunnlag og inntektsopplysninger digitalt. 3) Om Samtykkebasert Lånesøknad (SBL) SBL består av to separate prosesser: 1. Samtykkeprosess 2. Prosess for digital innhenting av data fra Skatteetaten En finansinstitusjon må koble seg både mot Altinn (Brønnøysundregistrene) for tilgang til samtykkeløsningen og mot Skatteetaten for å kunne hente data digitalt (skattegrunnlaget og inntektsopplysninger). Side 4

5 3-1) Samtykkeprosess Lånesøker Bank BRREG Skatteetaten 1.1 Søker lån i banken Aktiviteter for bank 1.2 Banken sjekker hvilket år skattegrunnlag er tilgjengelig for 1.3 Sender brukeren til samtykke Tilpasset URL 1.4 Lånesøker ser på sine data Til innsynstjeneste Lånesøker samtykker Henter data Fortsetter dialogen Samtykkestatus Samtykketekst: Definert år skattegrunnlag Definert periode med mm/åå for inntektsdata på bakgrunn av samtykkedato Til 2 Digital innhenting av data Finansinstitusjonen har, som illustrert i figuren over, ansvar for å utføre prosesstrinnene 1.1, 1.2, 1.3 og ) Prosess for digital innhenting av data Lånesøker Bank BRREG Skatteetaten Fra 1 Samtykkeprosess Aktiviteter for bank 2.1 Banken henter token 2.2 Banken henter skattegrunnlag for et bestemt år Banken henter inntektsdata for en bestemt periode 2.3 Søkeren får svar Finansinstitusjon har, som illustrert i figuren over, ansvar for å utføre prosesstrinnene 2.1, 2.2, 2.3 og 2.4. Det vil bli referert til både Samtykkeprosessen og Prosessen for digital innhenting av data hos Skatteetaten i de påfølgende kapitlene - slik at man forstår konteksten. Trinn-nummeret vil typisk stå i parentes (trinn x.x). Side 5

6 4) Avgrensninger og betingelser Samtykkebasert Lånesøknad - Onboardingsguide Bruken av SBL er regulert. Sjekk om din virksomhet kan benytte denne tjenesten på [SBL_REG]. 5) Onboardingsprosessen For å sikre en god integrasjon med Brønnøysundregistrene og Skatteetaten, samt en god implementering av de to nevnte SBL prosessene, bør finansinstitusjonene følge prosjektets anbefalte onboardingprosess slik den er beskrevet under. Onboarding for en finansinstitusjon består av 5 faser: A FORBEREDELSE B REGISTRERING OG SIGNERING AV VILKÅR C INTEGRASJON D PRODUKSJON Lese dokumentasjon og vurdere hvordan dette berører finansinstitusjonen og hvordan arbeidet skal organiseres - og når. Igangsette nødvendige tekniske interne bestillinger. Utrulling i SBL utføres trinnvis og kontrollert. Finansinstitusjonen registrerer seg hos Bits for signering av Skatteetatens vilkår. Bits er kontakten i denne fasen Finansinstitusjonen integrerer seg med Altinns samtykkeløsning og Skatteetaten, og utfører nødvendige integrasjonstester før overgangen til produksjon. Finansinstitusjonen går over til produksjon og må velge hvordan den nye løsningen skal lanseres i markedet. Ved hjelp av tilgjengelig dokumentasjon kan finansinstitusjonen igangsette tilpasninger i kundereisen og utføre brukertester. E FINANSINSTITUSJONENS TILPASNINGER Data som mottas fra Skatteetaten skal lese inn i finansinstitusjonens lånesystemer. Dette kan gjøres med bakgrunn i dokumentasjon i test og deretter verifiseres/forbedres i produksjon basert på økt dataerfaring. Selve kredittscoringen vil i liten grad bli berørt av SBL, men det åpnes en del muligheter for automatisering av denne fasen. Finansinstitusjonen bør tenke på dette i sitt design og samtidig arbeide kontinuerlig med å forbedre automatiseringen. I de neste kapitlene er det også presentert anbefalinger om hvem som burde fullføre hvilke oppgaver: IT: IT-spesifikke oppgaver Forretning: Oppgaver for forretningssiden som vil implementere SBL Kreditt: Oppgaver for kredittmiljøene Alle: Alle de ovenfor nevnte miljøene. Side 6

7 Samtykkebasert Lånesøknad - Onboarding Guide 6) A - Forberedelse I dette kapittelet finner man oversikt over oppgaver som må- eller bør være gjort før finansinstitusjonen går til registrering og avtaleinngåelse (B). Oppgaver A-1 Gå gjennom onboardingspresentasjonen for å forstå hva SBL kan bety for finansinstitusjonen og hva som må til for å lykkes (Alle) A-2 Gå gjennom presentasjonen av SBL-prosessene for å forstå trinnene finansinstitusjonene må implementere i SBL (Alle) A-3 Bestille test- og produksjonsvirksomhetssertifikat internt i finansinstitusjonen (forretning/it) A-4 Tilrettelegge for neste fase ved å bestille nødvendige utviklings- og testmiljøer (IT) A-5 Tilrettelegge for neste fase ved å bestille nødvendige brannmur-åpninger for både test og produksjon (IT) A-6 Lese og forstå dokumentasjonen om Altinn samtykkeløsningen: - Datakonsumenter og undermenyer - Samtykke, For sluttbruker, Begrepsliste (forretning/it) og For datakonsument (IT) - Oppbygging av URL til samtykke - trinn 1.3 (IT) - Behandling av samtykkestatus - trinn 1.6 (IT) - Hente token med referanse - trinn 2.1 (IT) A-7 Lese og forstå dokumentasjonen fra Skatteetaten - Starte med å lese «Komme i gang» (forretning/it), især undermenyen Samtykkeløsning for å få en overordnet oversikt over tjenesten - Lese «Bakgrunn» for å få bedre generell kunnskap (Alle) - API-referanse (IT og eventuelt Kreditt) o Inntektsmottaker API - trinn 2.2 (IT, noen.xsd filer er interessante for Kreditt) o Skattegrunnlag API - trinn 2.2 (IT, noen.xsd filer er interessante for Kreditt) o Tilgjengeligdata API - trinn 1.2 (IT) - Gjennomgå Informasjonsmodeller (datakataloger) og testdata for integrasjon (Alle) o HTTP statuskoder (IT) o Skattegrunnlag Datakatalog (Kreditt/IT) o Inntekt Datakatalog lønnsopplysninger (Kreditt/IT) o Testdata for integrasjonstest (Forretning/IT) - FAQ: Nyttig info når man kobler seg på (Alle) Presentasjonen [SBL_ONBD] forklarer hva SBL er, hva SBL betyr for finansinstitusjonene og hvordan arbeidet med SBL burde organiseres Presentasjonen [SBL_PROS] beskriver alle overordnede trinn en finansinstitusjon må igjennom for å implementere løsningen. Finansinstitusjonen må ha gyldig test- og produksjons-virksomhetssertifikater fra enten: - Buypass-virksomhetssertifikater eller - Commfides-virksomhetssertifikat Virksomhetssertifikatene brukes mot Skatteetaten. Dette er en finansinstitusjon-intern bestilling. Dette er en finansinstitusjon-intern bestilling. Se på [SBL_BRREG] og [SBL_BRREG_SAM] - [SBL_BRREG] - [SBL_BRREG_SAM] - For datakonsument - Be om samtykke i [SBL_BRREG_SAM] - For datakonsument - Be om samtykke i [SBL_BRREG_SAM] - For datakonsument - Hente koden i [SBL_BRREG_SAM] Se [SBL_SKATT] Dokumentasjonen om Restanse API, Oppgaveinnlevering API, Beregningsgrunnlag API og Inntektsmottakerfeed API i [SBL_SKATT] benyttes ikke i SBL. Side 7

8 Oppgaver A-8 Se oversikt over tilgjengelige testbrukere (IT/Kreditt). Se brukeroversikten i [SBL_SKATT] under «Testdata for akseptansetest» A-9 Overgangsveiledning: Beskrivelse av tidligere LTO-koder i a-ordningen (Kreditt). A-10 Veiledning til a-ordningen: Nyttig dokumentasjon for å forstå inntektsdata (Kreditt) Se på dokumentasjon [SBL_LTOKODER]: Nyttig informasjon for å kunne forstå hvordan lønnsog trekk-koder (LTO-koder) er strukturert i a-meldingen. Det er denne strukturen informasjonsmodellen for inntekt er basert på. Se på webtjenesten [SBL_A-ORD_VLD] for å lære mer om a-ordningen. Her vil kredittmiljøene i finansinstitusjonene finne nyttig informasjon for å forstå lønnsopplysningsdata (se datakatalogen i [SBL_SKATT]) og data arbeidsgivere sender til a-ordningen. Se for øvrig på informasjon under menyen «Ressurser» på [SBL_SKATT] A-11 Ytelsestestrapport for Altinn samtykkeløsningen: Den kan brukes internt av finansinstitusjoner om en slik rapport er påkrevet. Se [SBL_YTEL] A-12 Lese Altinn dokumentasjon Se [SBL_ BRREG], Driftsvarsel Side 8

9 7) B Registrering og signering av vilkår Samtykkebasert Lånesøknad - Onboardingsguide I dette kapittelet finner man oversikt over oppgaver som må være gjort før finansinstitusjonen går over til integrasjon. Oppgaver som må være gjort i forkant av registrering og avtaleinngåelse A-1, A-2, A-6, A-7, A-12 A-3, A-4, A-5, A-8, A-9, A-10, A-11 Oppgaver som bør være gjort i forkant av registrering og avtaleinngåelse B-1 Takket være dokumentene under punktene A-1, A-2, A-6 og A-7 kan finansinstitusjonen: - Designe finansinstitusjonens løsning med integrasjon via SBL - Planlegge aktiviteter frem til produksjonssetting - Bestemme når finansinstitusjonen kan starte integrasjon mot Altinn og Skatteetaten - Bestemme når finansinstitusjonen kan gå i produksjon B-2 Finansinstitusjonen registrerer seg via bits.no og får tildelt en plass i en rekkefølge. Nødvendig input: - Organisasjonsnummer - Hovedkontaktperson - Ulike kontaktpersoner i finansinstitusjonen - Ønsket startdato for integrasjon (startdato) - Forpliktelse at finansinstitusjonen vil implementere Kontrollinformasjon og Konkursbehandling - Spesifikke data Skatteetaten/BRREG trenger ifm onboardingen Oppgaver Dette er en finansinstitusjon-intern oppgave Gå til [SBL_REG] og følg rutinen. - Bits vil verifisere innholdet skjemaet - Bits vil verifisere om finansinstitusjonen har de nødvendige konsesjoner som er påkrevet av Skatteetaten for å kunne hente data. - Bits vil registrere finansinstitusjonens ønske og vil behandle søknaden Se kapittel 4) Avgrensninger og betingelser for å sjekke om din virksomhet kan benytte SBL. B-3 Finansinstitusjonen venter å bli kontaktet av Bits for å starte avtaleinngåelsen. Nødvendig for å kobles til Skatteetaten og kunne hente data. Denne prosessen vil trolig bli digitalt. B-4 Motta API-key for test og prod fra Brønnøysundregistrene (IT) For datakonsument - Komme i gang i [SBL_BRREG_SAM] Nødvendig for å kunne benytte samtykkeløsningen. B-5 Fortsette design og planlegging internt i finansinstitusjonen (Alle) - Side 9

10 7) C Integrasjon Samtykkebasert Lånesøknad - Onboardingsguide I dette kapittelet finner man oversikt over oppgaver som må være gjort før finansinstitusjonen går over til produksjon. Oppgaver som må være gjort i forkant av integrasjon Oppgaver som bør være gjort i forkant av integrasjon A-1, A-2, A-3, A-4, A-5, A-6, A-7, A-8 A-9, A-10 B-1, B-2, B-3, B-4 B-5 Oppgaver C-1 Gjennomføre integrasjonstesten og dokumentere den i rapport-malen (IT). Se [SBL_INT_TEST] og gjennomføre alle testcaser samt lage rapporten. Finansinstitusjonene skal kunne fremvise rapporten om Skatteetaten, BRREG eller Bits ber om det. C-2 Abonnere på Feeds fra Altinn ihht til dokumentasjon (Alle) Se [SBL_ BRREG], Driftsvarsel C-3 Abonnere på Feeds fra Skatteetaten ihht til dokumentasjon (Alle) Se [SBL_ SKATT], Komme i gang Abonnere på varsel C-4 Informere Bits når integrasjon i test er gjennomført (IT/Forretning) Sende en mail til Bits ved dsop@bits.no med bekreftelse av følgende; - Integrasjonstest er fullført - Rapport for integrasjonstest er laget. - Domene(r) som ble oppgitt i registreringsskjema, se [SBL-REG], er fortsatt gjeldene for produksjonsmiljø. Side 10

11 8) D Produksjon I dette kapittelet finner du oversikt over oppgaver som bør gjøres ifm med produksjon. Oppgaver som må være gjort i forkant av produksjon Oppgaver som bør være gjort i forkant av produksjon A-1, A-2, A-3, A-4, A-5, A-6, A-7, A-8 A-9, A-10 B-1, B-2, B-3, B-4, B-5 C-1, C-2, C-3, C-4 Oppgaver D-1 Kontakte Bits for å få tilgang til produksjon (Forretning) Se C-4. D-2 Sikre at samtykketeksten (DelegationContext) er iht kravet fra Skatteetaten (IT/Forretning) Banker som bruker samtykkeløsningen skal bruke følgende verdi for DelegationContext: Ved å samtykke, gir du Skatteetaten rett til å utlevere opplysninger om deg direkte til <banknavn>. Banken får opplysningene for å behandle søknaden din om finansiering. Se Skatteetatens websider: Krav til DelegationContext D-3 Det anbefales at finansinstitusjonen kjøre først noen søknader med ansatte og utvalgte kunder/lånesøkere for å bli kjent med data og teste sine rutiner. Varigheten på denne fasen er avhengig av både volum (som er nødvendig for å teste/verifisere den nye prosessen) og behandlingskompleksiteten finansinstitusjonen har valgt. Side 11

12 9) E Finansinstitusjonens tilpasninger I dette kapittelet finner du oversikt over oppgaver som finansinstitusjonen må gjøre for å tilpasse sin lånesøknadsprosess ifm integrasjon med Skatteetaten og Altinn i SBL. E-1 Det anbefales at finansinstitusjonen gjennomfører en brukertest for å kunne se hvordan brukere reagerer til den nye måten å søke lån på. Oppgaver som med fordel kan være gjort i forkant av integrasjon Les [SBL_PROS] for å forstå trinnene i SBL og bruk skjermene som ligger i [SBL_SKJERM] for trinn 1.3 og 1.5. E-2 Strategi for digitalisering av lånesøknadsprosessen i finansinstitusjonen. SBL tilrettelegger for ytterligere digitalisering av finansinstitusjonens låneprosesser. E-3 Verifisering av lånebehandling i hele organisasjon som følge av SBL. - E-4 Opplæring av kundeservice, kredittrådgivere, og IT personalet. - E-5 Det anbefales at finansinstitusjonen tilrettelegge for en bevist aktivitet for å lære om data som hentes fra Skatteetaten slik at man ytterligere kan automatisere kredittvurderingen og låneprosessen. Oppgaver som må gjøres i etterkant av integrasjon - Side 12