Dette er en foreløpig løsningsbeskrivelse som vil bli tatt opp på statusmøter med søknadsleverandørene. Beskrivelsen oppdateres fortløpende.
Innhold:
Introduksjon
Høsten 2021 utvikles og produksjonssettes et nytt system for erklæringer til ansvarlige foretak. Tjenestene for erklæring om ansvarsrett, samsvarserklæring og kontrollerklæring (“AnSaKo”) flyttes over til en ny plattform. Dagens tjenester for erklæringer til ansvarlige foretak i Altinn vil etter planen bli slått av innen 1. januar 2021.
Systembeskrivelse
Overblikk
AnSaKo-tjenesten lar ansvarlige foretak signere følgende erklæringer gjennom et reaktivt webgrensesnitt:
Erklæring om ansvarsrett
Samsvarserklæring
Kontrollerklæring (med vedlegget “Plan for uavhengig kontroll”)
Tjenesten tilbyr tjeneste-API og status-API for å initiere erklæringer og følge signeringsprosessen:
Tjeneste-APIet lar søknadssystemene opprette erklæringer. Tjenesten vil ikke bruke distribusjonskonseptet, så søknadssystemene oppretter erklæringene, én etter én, i løsningen.
Etter at erklæringen er opprettet uten feil, får søknadssystemet tildelt en unik ID. Søknadsystemet bruker denne ID-en i en URL som det ansvarlige foretaket bruker til å signere erklæringen gjennom AnSaKo-webtjenesten. Søknadssystement får ansvaret for å varsle og sende påminnelser til ansvarlig foretak om at det ligger en erklæring for signering.
Ansvarlig foretak signerer erklæringen gjennom AnSaKo. PDF av signert skjema kan lastes ned av ansvarlig foretak via tjenesten, eller den kan bli sendt via e-post.
Søknadssystemet kan hente status gjennom status-APIet som før, og laste ned signerte erklæringer, XML-er og eventuelle vedlegg (“Plan for uavhengig kontroll”).
Data og metadata
Følgende data lagres per erklæring (ikke komplett):
#ID //GUID for erklæring #Type //Ansvar/samsvar/kontroll/direkte-typer #Dato //Opprettet #Status //Kodeliste #AF org nummer //Org nummer AF #Kontaktperson //AF kontaktperson #AF oppdatert //Flagg som indikerer at AF har oppdatert data i erklæring om ansvarsrett #AS org nummer //Org nummmer #Prosjektnavn //Prosjektnavn #søknadsystemID //innsendingssystem #gjennomføringsplanId //ID for å kombinere signering av flere ansvarsretter i en gjennomføringsplan #ftbId //ID for hele byggesaken #kombinereID //ID for å kombinerer flerer ansvarsretter til en signering #refAnsvarsrett //ansvarsrett GUID som knytter samsvar eller kontrollerklæring til oprinnelig ansvarsrett
Direkte innsendte skjema
Vi legger opp til at direkte innsendte erklæringer bruker samme tjeneste uten behov for at noe logger inn via grensesnittet for å signere. Vi vil se nærmere på direkte innsendte erklæringer i neste versjon av AnSaKo-tjenesten.
Oppdatering av data i erklæring om ansvarsrett
Det første skjemaet som vil være tillgjengelig, er erklæring om ansvarsrett. Vi legger opp til at ansvarlig foretak kan oppdatere følgende:
beskrivelsen av ansvarsområdet
tiltaksklassen for ansvarsområdet
om sentral godkjenning dekker ansvarsområdet
oppdatering av kontaktperson
Brukergrensesnitt i webtjenesten
Vi har to konsepter som vi ønsker innspill på. Det ene konseptet går ut på at informasjon i erklæringen samles og fylles ut på én side:
Alternativ 2 er et mer veiviserbasert brukergrensesnitt, hvor informasjonen og utfyllingen deles opp i flere steg:
Meldingsboks
Det blir ikke noen meldingsboks på lik linje med Altinn.
Åpne avklaringer
Krav til signeringen
Autentisering av brukere
Ferdigstille datamodeller
Hvordan kombinere signering av flere ansvarsområder på samme erklæring
Ansvar og tilbakemeldinger
Søknadssystemets ansvar og begrensninger i tjenesten
Vi legger opp til at søknadssystemene får ansvaret for å:
- varsle ansvarlig foretak om at en erklæring ligger klar for signering
- purre på signeringer
- oppdatere ansvarlig søker om signerte erklæringer og gjøre PDF-ene tilgjengelig
Spørsmål til sluttbrukersystemene
Vi ønsker tilbakemelding fra sluttbrukersystemene på blant annet følgende spørsmål:
Bør grensesnittet for signering av erklæringer ligne et skjema eller være oppdelt som en veiviser, ref. skjermbilder over?
Vil innlogging via ID-porten dekke brukernes behov, eller må vi også støtte annen form for pålogging?
Brukes direkte opprettet ansvarsrettskjema til signering av egne ansvarsområder ved innsending av søknader i dag?
Er det behov for å ha en PDF preview av hvordan ansvarsretten blir seende ut (både for ansvarlig søker og ansvarlig foretak)?
Er det viktig å sette status for sentral godkjenning ved utsending av ansvarsretten, eller kan dette håndteres i Ansako-tjenesten?
Mulige/fremtidige utvidelser
Første versjon av ansako vil være en minimumstjeneste med muligheter for utvidelse etter hvert. Her er noen eksempler på utvidelser:
Tilby API for store ansvarlige foretak slik at de kan hente ned status på erklæringer under egne organisasjonsnummer
Tilby API til eByggesaksystemer slik at de kan laste ned alle data tilhørende en gjennomføringsplan
Endringslogg
Versjon | Dato | Kommentar |
---|---|---|
Gjeldende versjon (v. 2) | 20.08.2021 12:50 | Helga Jerven |
v. 6 | 06.09.2021 07:57 | Helga Jerven |
v. 5 | 02.09.2021 07:37 | Veslemøy Søbak |
v. 4 | 24.08.2021 13:21 |
Helga Jerven Lagt inn informasjon under "Overblikk" om at vi ikke legger opp til å bruke rollesystemet i Altinn eller legge andre begrensninger for hvem som kan signere erklæringer. |
v. 3 | 20.08.2021 12:52 | Helga Jerven |
v. 2 | 20.08.2021 12:50 | Helga Jerven |
v. 1 | 20.08.2021 12:42 | Veslemøy Søbak |
Legg til kommentar