API for mangler, v2

API for mangler er et API-kall som brukes til å informere søker om søknadens mangler, og saksbehandlers behov for at søknaden blir supplert. Disse dataene sendes strukturert i tillegg til det utgående dokumentet. API-et inneholder informasjon søker trenger for å kunne supplere søknaden slik at søknaden kan registreres som komplett. Med supplering av søknaden menes både mangler og annen dokumentasjon.

API for mangler utløses når sjekklisteutfallene krever behov for mer informasjon, og saksbehandler kvitterer ut milepælen “Mangelbrev” (MB).

Innhold

Milepæl

API for mangler skal dekke følgende milepæl:

  • Mangelbrev (MB)​

Utfall

Følgende utfall er lovlige verdier å sende ved API for mangler:

Nøkkeldata

Hovedformålet med API for mangler er å gi søker informasjon om følgende:

  • Liste over mangler og oppfølgingspunkt saksbehandler har bemerket

  • Svarfrist på manglene

  • Kobling mellom mangel, utfall og prosess

  • Lenke til det utgående dokumentet

Datamodell

Datamodell for API for mangler

Beskrivelse av felter

Under ligger en beskrivelse av feltene for API for mangler. Vi har også lagt med en kolonne med eksempeldata, for slik å gi et inntrykk av hvordan vi ønsker at API-et skal brukes. Felt i blått er felles datafelt, mens gule felt er spesielle for API for mangler.

Feltene for metadata, saksnummer, milepæl, saksbehandlingsfrist og utgående dokument er felles på tvers av alle API-ene. Les mer om det i Felles datafelt under API-er for oppdatert milepæl. Vi har likevel lagt de til her med relevante eksempeldata.

Metadata

Felt

Beskrivelse

Eksempel

Felt

Beskrivelse

Eksempel

Metadata

Metadata for forsendelsen:

 

FraEbyggesakssystem

Navn på eByggesakssystemet som kvitteringen er sendt fra.

TietoEvry

Innsendingsreferanse

Referansen for innsendingen. Dette vil typisk være altinnreferansen.

AR123456789

FtBID

Prosjekt-ID fra FtPB. Les mer her: FtBID i Sluttrapport for bygningsavfall

BYGG-1234

AvsenderD

ID til virksomheten som har mottatt innsendingen. Skal samsvare med kommunennummer for kommune, og organisasjonsnummer for sektormyndigheter.

5001

AvsenderNavn

Navnet på kommunen/sektormyndigheten som har mottatt innsendingen.

Trondheim

EkspedertDato

Datoen for utsendingen.

2022-09-01T12:31:58.39

OffentligJournalUrl

Lenke til kommunenes offentlige journal for byggesaken.

https://www.kommunenavn.no/innsyn/casedet.asp?direct=Y&mode=all&caseno=202216614&Dateparam=11/14/2022

Saksnummer

Felt

Beskrivelse

Eksempel

Felt

Beskrivelse

Eksempel

Saksnummer

Saksnummer i kommunen:

-

Saksaar

Saksåret i saksnummeret som er tildelt.

2022

Sakssekvensnummer

Sekvensnummeret i saksnummeret som er tildelt.

00001

Journalpostnummer

Journalpostnummeret i saksforløpet på saken .

345

Milepæl

Felt

Beskrivelse

Eksempel

Felt

Beskrivelse

Eksempel

Milepæl

Milepælen kallet gjelder for. I API for mangler vil dette alltid være “Mangelbrev” (MB).

MB

Saksbehandlingsfrist

Felt

Beskrivelse

Eksempel

Felt

Beskrivelse

Eksempel

Saksbehandlingsfrist

Fristen kommunen har til å ferdigstille saksbehandlingen. Denne datoen kan endres og oppdateres underveis i prosessen.

2022-12-01T12:31:58.39

Utgående dokument

Felt

Beskrivelse

Eksempel

Felt

Beskrivelse

Eksempel

UtgaaendeDokument

Liste med informasjon om dokument eller dokumentene som sendes fra kommunen.

-

Distribusjon (1..*)

Liste med informasjon om hvordan dokumentet er distribuert:

 

  • DistribusjonsMetode

Angir hvordan dokumentet er sendt/distribuert. Følger kodeliste på GeoNorge.

ftb

  • DokumentUrl

Lenke for nedlasting av dokumentet dersom FtPBs dokumentformidler brukes. Les mer om FtPBs dokumentformidler.

https://admbygg.dibk.no/api/download/bf65a6da-d59f-4ecd-9953-831c7303e587/tillatelse.pdf

DokumentNavn

Navn på utgående dokument.

Behov for supplering av søknad

MimeType

Filtype for utgående dokument.

pdf

DokumentStorrelse

Dokumentets størrelse.

345MB

Hoveddokument

Boolsk verdi for å angi om dokumentet er et hoveddokument eller vedlegg.

true

Svarfrist

Felt

Beskrivelse

Eksempel

Felt

Beskrivelse

Eksempel

Svarfrist

Fristen søker har på å besvare utfallene. Dersom det er behov for å purre eller endre svarfrist etter utsending av mangelbrevet, må dette gjøres via meldingsfeltet i API for saksoppdatering.

 

Sjekklisteutfall

Felt

Beskrivelse

Eksempel

Felt

Beskrivelse

Eksempel

SjekklisteUtfall (0…*)

Utfall, eller liste av utfall, som er oppdatert etter førstegangsinnsending.

 

UtfallID

eByggesaksystemets ID for utfallet.

000-324435sada-344534sad-123234a

UtfallType

Hvilket utfall et gitt sjekkpunkt har fått. Følger kodeliste på GeoNorge:

  • Be om dokumentasjon

  • Mangel

  • Mangel/pauser løpende tidsfrist

  • Mangel/tidsfrist starter ikke

  • Oppfordre til innsending

MSL

UtlostFraSjekkpunkt

Sjekkpunktet som har utløst utfallet:

-

  • SjekkpunktID

Sjekklistepunktet mangelen er utløst fra.

2.7

  • SjekkpunktTittel

Sjekkpunktets tittel.

Er merknadene kommentert av søker?

  • SjekkpunktUrl

Lenke til mer informasjon om sjekkpunktet.

https://ftb-checklist.dibk.no/checklist/RS/12333/details

  • SjekkpunktEier

Eier av sjekkpunktet mangelen er utløst fra. Det kan være DiBK, SSB eller den enkelte kommunes lokale mangler.

DiBK

BeskrivelseAvUtfall

Beskrivelse av mangelen. Denne informasjonen kan være endret av saksbehandler:

-

  • Tittel

Mangelens tittel etter at saksbehandler evt. har justert den. Skal ta utgangspunkt i de standardiserte tekstene dersom de er tilgjengelige.

Kommentarer til merknader mangler

  • Beskrivelse

Mangelens beskrivelse/undertekst etter at saksbehandler evt. har justert den. Skal ta utgangspunkt i de standardiserte tekstene dersom de er tilgjengelige.

Det har kommet inn merknader fra naboer eller gjenboere til tiltaket. Ansvarlig søker må sende inn sine kommentarer til nabomerknadene som er innkommet.

  • Veiledningstekst

Mer informasjon fra saksbehandler

I søknaden er det opplyst om at det er mottatt 3 merknader og at vurdering av disse ettersendes. Vi ber om å motta dette med en beskrivelse av hva som er gjort for å imøtekomme merknadene, eventuelt begrunnelse for hvorfor disse ikke er imøtekommet.

  • Lovhjemmel (0…*)

Lovhjemmel, eller en liste av hjemler, som er knyttet til mangelen

https://lovdata.no/lov/2008-06-27-71/§21-3

SAK10 § 5-4 n

OppfyllesTilFase

Saksbehandlingsfasen/-prosessen mangelen må være oppfylt for. Følger kodeliste for søknadstype.

RS