Informasjon om overgangen til versjon 4 av nabovarsel

Produksjonssetting av nabovarsel V4

 

12.09.2019, kl 15:00 - Vi har nå satt opp TT02/testmiljøet

  • Nabovarsel V3 koblet til NabovarselSvar V2

  • Nabovarsel V4 koblet til NabovarselSvar V3

13.09.2019, kl 13:35 - Nå er oppdateringene lagt ut i produksjonsmiljøet med

  • Nabovarsel V3 koblet til NabovarselSvar V2

  • Nabovarsel V4 koblet til NabovarselSvar V3

(tilsvarende oppsett i TT02)

 

Tidsplan for produksjonssetting

Versjon 4 av Nabovarsel (distribusjon) er nå produksjonssatt. Tilhørende svarskjema er Svar på nabovarsel V3.

Tidligere versjon (Nabovarsel V3 og Svar på nabovarsel V2) vil ligge parallelt i produksjonsmiljøet. Oppsettet vil være likt, men tekstlige endringer vil påvirke også disse skjemaene ved produksjonssetting.

Vi hadde tidligere koblet Svar på nabovarsel versjon V3 til Nabovarsel V3 (distribusjon) i test. Dette er endret 12.09.2019 for å ha like versjoner i TT02 og PROD.

Den nye og gamle versjonen vil eksistere i parallell (i både test og prod) til alle sluttbrukersystemer har byttet til ny versjon.

Fristen for å gå over til versjon 4 er 3 måneder fra produksjonsdatoen, altså 13. desember. Vi anbefaler likevel å gå over til ny versjon før den tid.

Vi ber alle sluttbrukersystemer med nabovarsel i produksjon om å gi beskjed til fellestjenesterbygg@dibk.no (servicedesk) når dere har byttet til ny versjon, eller dersom dere trenger mer tid på overgangen.

Hva må sluttbrukersystemene gjøre for å komme over på ny versjon?

Sluttbrukersystemet må ikke gjøre store endringer på sin side for å komme over på Nabovarsel V4. Datamodellen for V3 og V4 er identiske bortsett fra utgave og datamodell parametere som vist nedenfor.

 

Nabovarsel V3

Nabovarsel V4

Innsendings-
tjeneste

Service Code: 4655
ServiceEditionCode: 3
Lenke til tjeneste

Service Code: 4655
ServiceEditionCode: 4
Lenke til tjeneste

Datamodell

DataFormatId: 5791
DataFormatVersion: 42760

Lenke til datamodell

DataFormatId: 6303
DataFormatVersion: 44820

Lenke til datamodell

Den nye REST API innsendelsen ser da slik ut:

Ellers er innsendelsen identisk med datamodellen til Nabovarsel V3. Utover ID-en i grensesnittet er det også gjort viktige forbedringer i tjenesten.

Nabovarsel V4 lager skjema Svar på nabovarsel V3 i Altinn med datamodellen (DataFormatId: 6173, DataFormatVersion: 44215). Det nye konseptet for denne datamodellen er at vi kan samle opp flere nabovarsel til samme mottaker i ett skjema i Altinn. To endringer er da gjort: Feltet for “gjelderNaboeiendommen” er nå en liste og referansen “sluttbrukersystemVaarReferanse“ har blitt et listeelement.

Som det fremgår av datamodellpresentasjonene, er det feltet “sluttbrukersystemVaarReferanse“ som har byttet plass i strukturen. Ved å flytte feltet inn i objektet “gjelderNaboeiendom.eiendom“ følger referansen nå naboeiendommen det varsles til. Det korresponderer med kilden til informasjonen som er: “Nabovarsel.nabo-eier.nabogjenboer.sluttbrukerVaarRejeranse“. Dermed kan man sette en unik referanse som knyttes til den faktiske mottaker av varslet og få denne referansen tilbake i svaret. Det gjør det mulig å utlede hvem i listen over naboer som er varslet og har svart elektronisk. Teknisk er det løst ved at “gjelderNaboEiendom“ har blitt en liste av “eiendom”-objekter.

Vi anbefaler å benytte en unik referanse på nabo-eiendomnivå da det gir god kontroll over distribusjon av nabovarsel og svar, gjør det mulig å utlede hvem det ikke er distribuert til. I tillegg er det til stor hjelp ved debugging om innsendelse skulle feile i FtB.

Viktige endringer i Nabovarsel V4

 

Nabovarsler til samme eier slås sammen

Dersom en nabo eier flere naboeiendommer, får naboen nå kun ett nabovarsel. Melding, svarskjema, kvittering og følgebrev gir en liste over hvilke naboeiendommer varselet gjelder.

 

I tilfeller der nabovarselet blir sendt i Posten blir også her varslene samlet i en konvolutt med en liste av eiendommer i følgebrevet:

Endringene gir en bedre opplevelse for mottaker i Altinn innboksen sin. Det reduserer også mengden data som distribueres og arkiveres fordi vedlegg kun distribueres en gang. Denne nytteverdien gjelder også om varselet må gå til print og postomdeling.

Status-API

Det er lagt opp til at det ikke er noen endringer i Status-APIet selv om distribusjoner har blitt kombinert sammen til et varsel i Altinn eller i Posten. Dette er gjort slik at det fremdeles er en en-til-en sammenheng mellom antall naboer satt opp i distribusjonstjenesten (og tilhørende sluttbrukersystemVaarReferanse) og antall distribusjoner blir vist i Status APIet.

I JSON loggen nedenfor er det 4 distribusjoner som alle er kombinert sammen til ett varsel i Altinn. Man kan se at det er samme distribusjon i Altinn siden ReferanseIdSendt har samme verdi for alle fire distribusjonene.

 

{ "Arkivreferanse": "AR5788264", "AltinnInnsending": "2019-09-11T16:41:08.967", "Saksaar": 0, "Sakssekvensnummer": 0, "StatusInnsending": "Ok", "Hendelser": [ { "Beskrivelse": "Altinn kvittering for preutfylling er OK", "Tidspunkt": "2019-09-11T16:45:37.747" }, { "Beskrivelse": "Altinn Svar på nabovarsel laget til (910297937), Altinn kvitteringsid 27152431", "Tidspunkt": "2019-09-11T16:45:30.053" }, { "Beskrivelse": "Altinn kvittering for preutfylling til 910297937 er OK", "Tidspunkt": "2019-09-11T16:45:29.883" }, { "Beskrivelse": "Distribusjon med søknadsystemsreferanse v4-foretak-multi.1 kombinert med v4-foretak-multi.5", "Tidspunkt": "2019-09-11T16:45:27.927" }, { "Beskrivelse": "Distribusjon med søknadsystemsreferanse v4-foretak-multi.1 kombinert med v4-foretak-multi.4", "Tidspunkt": "2019-09-11T16:45:27.69" }, { "Beskrivelse": "Distribusjon med søknadsystemsreferanse v4-foretak-multi.1 kombinert med v4-foretak-multi.3", "Tidspunkt": "2019-09-11T16:45:27.423" }, { "Beskrivelse": "Distribusjon med søknadsystemsreferanse v4-foretak-multi.1 kombinert med v4-foretak-multi.2", "Tidspunkt": "2019-09-11T16:45:27.067" }, { "Beskrivelse": "Starter distribusjon med søknadsystemsreferanse v4-foretak-multi.1", "Tidspunkt": "2019-09-11T16:45:26.8" }, { "Beskrivelse": "Det er 1 distribusjoner i innsendingen", "Tidspunkt": "2019-09-11T16:45:26.673" }, { "Beskrivelse": "Behandler distribusjonsskjema Distribusjon av nabovarsel", "Tidspunkt": "2019-09-11T16:45:26.103" }, { "Beskrivelse": "Valideringsresultat: WARNING: Validering av matrikkelnummer feilet. Eiendomsidentifikasjon ble ikke kontrollert mot Matrikkel., iht. 4655.3.25; ", "Tidspunkt": "2019-09-11T16:45:25.133" }, { "Beskrivelse": "Skjema er hentet fra Altinns tjenestearkiv for DiBK.", "Tidspunkt": "2019-09-11T16:45:09.887" }, { "Beskrivelse": "Vedlegg: , Situasjonsplan Purple Haze lyrics.pdf[32847], TegningNyFasade Purple Haze lyrics.pdf[32847]", "Tidspunkt": "2019-09-11T16:45:09.793" }, { "Beskrivelse": "Skjema (dataformatid, dataformatversjon): , (6303, 44820)", "Tidspunkt": "2019-09-11T16:45:09.68" }, { "Beskrivelse": "Skjema er hentet fra Altinns tjenestearkiv for DiBK. Med 2 vedlegg og 1 skjema.", "Tidspunkt": "2019-09-11T16:45:09.62" }, { "Beskrivelse": "Skjema er lagt i kø for behandling til Distribusjonstjeneste.", "Tidspunkt": "2019-09-11T16:45:08.947" } ], "Distribusjoner": [ { "Distribusjonstype": "Svar på nabovarsel", "ReferanseSluttbrukersystem": "v4-foretak-multi.5", "Status": "submittedPrefilled", "ReferanseIdSendt": "27152431", "Sendt": "2019-09-11T16:45:28.55", "Filnedlastinger": [] }, { "Distribusjonstype": "Svar på nabovarsel", "ReferanseSluttbrukersystem": "v4-foretak-multi.2", "Status": "submittedPrefilled", "ReferanseIdSendt": "27152431", "Sendt": "2019-09-11T16:45:28.55", "Filnedlastinger": [] }, { "Distribusjonstype": "Svar på nabovarsel", "ReferanseSluttbrukersystem": "v4-foretak-multi.4", "Status": "submittedPrefilled", "ReferanseIdSendt": "27152431", "Sendt": "2019-09-11T16:45:28.55", "Filnedlastinger": [] }, { "Distribusjonstype": "Svar på nabovarsel", "ReferanseSluttbrukersystem": "v4-foretak-multi.1", "Status": "submittedPrefilled", "ReferanseIdSendt": "27152431", "Sendt": "2019-09-11T16:45:28.55", "Filnedlastinger": [] }, { "Distribusjonstype": "Svar på nabovarsel", "ReferanseSluttbrukersystem": "v4-foretak-multi.3", "Status": "submittedPrefilled", "ReferanseIdSendt": "27152431", "Sendt": "2019-09-11T16:45:28.55", "Filnedlastinger": [] } ], "Kvitteringsrapport": "https://test-admbygg.dibk.no/api/download/772e02b8-9aa2-4e48-8946-52b548f9d86e/nabovarsel_kvittering.pdf", "Nabovarsel": "https://test-admbygg.dibk.no/api/download/772e02b8-9aa2-4e48-8946-52b548f9d86e/nabovarsel.pdf" }

 

Nytt i denne versjoner er også at både Kvitteringsrapport og PDFen for Nabovarsel er tilgjengelig for nedlasting i etterkant av distribusjonen.

Det blir nå også viktigere å sjekke status på de individuelle distribusjonene:

{ "Distribusjonstype": "Svar på nabovarsel", "ReferanseSluttbrukersystem": "ikke-eksisterende-bruker-Altinn", "Status": "error", "Filnedlastinger": [] },

Vi kan nå rapportere at selve varslet er OK selv om en/noen/alle distribusjonene feilet.

 

Klarspråk

Vi har gjennomgått alle tekster med fokus på klarspråk. De største endringene er gjort i nabovarsel-PDF:

 

I tillegg har vi hatt en gjennomgang for å skjule felter som ikke har verdier fra nabovarsel PDF, svarskjema og kvittering for nabovarsel.

Denne siden vil om kort tid oppdateres med nye skjermbilder av flyten: Distribusjonstjeneste for nabovarsel

Klargjøring om mottakere av spørsmål og merknader

Vi har hatt en gjennomgang for å klargjøre forskjellen mellom hvor spørsmål og merknader skal sendes.

Merknader:

Her skal enten ansvarlig søker eller tiltakshaver (gjelder kun tiltak uten ansvarsrett) vises i PDF-en. I begge tilfeller kaller vi det for “Søker”. Merknadene følger søknaden videre til kommunal behandling.

Spørsmål:

Spørsmål skal ikke følge med søknaden i videre behandling. Vi bruker kun tiltakshaver.kontaktperson til adressering av spørsmål, selv om nabovarselet foretas av en ansvarlig søker. Kontaktperson bør derfor i sluttbrukerløsningen se ut til å være frakoblet fra tiltakshaver.

Se mer informasjon om bruk av kontaktperson her: Nabovarsel - kontaktperson

Samlet informasjon som skal sendes til kommunen

Flere byggesøknader som sendes gjennom Fellestjenester BYGG er mangelfulle fordi søkeren kun legger ved kvittering for nabovarsel, men utelater Opplysninger gitt i nabovarsel.

Opplysninger gitt i nabovarsel er en kopi av nabovarslet.

Vi har samlet Kvittering for nabovarsel og Nabovarsel i søkers innboks i Altinn. Kvitteringen inneholder også liste over vedlegg som er sendt med nabovarselet. DiBK sender ikke varsel om at dette ligger i innboksen til søkeren, så det må sluttbrukersystem som ikke tilbyr denne informasjonen selv opplyse om.

Vi minner om at sluttbrukersystemet bør gi sluttbruker denne informasjonen, slik at søkeren slipper å logge seg inn i Altinn.

Sluttbrukersystemet får tak i kvittering for nabovarsel og nabovarsel PDF gjennom status-APIet. Se mer informasjon under “Status-API” (tidligere i dette blogginnlegget).

Utenlandske adresser

Fellestjenester BYGG konverterer nå tre-sifret landkode og to-bokstavskode til riktig navn på land, slik at nabovarsler som går til print til utenlandske adresser ikke blir stoppet av posten.

Les mer om løsningen for utenlandske adresser her: Nabovarsling og utenlandske adresser

Økt robusthet og logging

Det har i noen tilfeller hendt at en automatisert batch-orientert prosess har stoppet når det har vært et stort antall naboer å varsle; stort, i størrelsesordenen flere hundrede. Og da har jobben automatisk startet på nytt på toppen av listen. Det har ført til at noen har fått samme varsel flere ganger.

For å unngå slike hendelser har vi forbedret batch-prosessen slik at den er rustet til å håndtere avbrudd som følge av exceptions som kommer fra eksterne tjenester.

I tillegg har vi jobbet med å få på plass mer detaljert og informativ logging i alle ledd i den komplekse kjeden av eksterne tjenester FtB er bygget opp av. Det gjør dels at vi får lettere ved å debugge avvik raskere, dels at vi får mulighet til å trekke ut detaljert bruksstatistikk.

Endelig har vi fikset problemet med at nabovarslet fikk en global status “Feil” ("StatusInnsending": "Feil") og avsluttet behandlingen mens det fremdeles var flere naboer som skulle varsles.

 

Begrensinger

I tilfeller der det er mange varsler til samme bruker/organisasjon i Altinn vil vi bruke adresseinformasjon fra den første distribusjonen vi finner:

Ved flere distribusjonselementer til samme nabogjenboer, vil vi ta dataene i rød ramme fra det første objektet vi finner mens dataene i blå ramme blir ivaretatt hele vegen.