API for oppdatert milepæl er et API-kall som brukes til å informere søker når saksbehandlingen har ført til en endring av milepælene. Disse dataene sendes strukturert i tillegg til et eventuelt utgående dokumentet. API-et inneholder informasjon om saksbehandlingsprosessen.

API for oppdatert milepæl utløses når saksbehandler endrer en milepæl, for eksempel når søknaden er komplett eller når søknaden må sendes til vurdering av en annen myndighet.

Innhold

Milepæl

API for oppdatert milepæl må dekke milepælene:

Søknad komplett (KS)
Sendt til uttalelse annen myndighet (SUA)
Mottatt uttalelse fra annen myndighet (MUA)

API for oppdatert milepæl kan dekke milepælene:

Søknad uaktuell (mangler kode)
Avsluttet (PA)

Nøkkeldata

Hovedformålet med API for oppdatert milepæl er å gi søker informasjon om følgende:

At saksbehandlingen har ført til en oppdatering av milepælene

Datamodell

Beskrivelse av felter

Under ligger en beskrivelse av feltene for API oppdatert milepæl. Vi har også lagt med en kolonne med eksempeldata, for slik å gi et inntrykk av hvordan vi ønsker at API-et skal brukes.

I dette eksemplet viser vi hvordan API-et kan brukes ved milepælene søknad komplett og oversendelse til annen myndighet. Alle feltene er fra felles datafelt.

Metadata

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`
AvsenderID	ID til kommunen 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`

Saksnummer

Felt	Beskrivelse	Eksempel
Saksnummer	Saksnummer i kommunen:	-
Saksaar	Saksåret i saksnummeret som er tildelt.	`2022`
Sakssekvensnummer	Sekvensnummeret i saksnummeret som er tildelt.	`00001`
Dokumentnummer	Dokumentnummeret i saksforløpet på saken .	`345`

Saksansvarlig

Felt	Beskrivelse	Eksempel
Saksansvarlig	Navn og kontaktinformasjon til saksbehandler eller avdeling som er ansvarlig for å behandle søknaden.	-
Navn	-	`Mari By`
E-post	-	`mari.by@kommunenavn.no`
Telefon	-	`77665544`
Mobil	-	`99887766`

Milepæl

Felt	Beskrivelse	Eksempel
Milepæl	Milepælen kallet gjelder for.	-
Kodeverdi	-	`SUA`
Kodebeskrivelse	-	`Sendt til uttalelse annen myndighet`

Saksbehandlingsfrist

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`

Kommunens utgående dokument

Felt	Beskrivelse	Eksempel
*KommunenesUtgaaendeDokument (0..)**	-	-
DokumentType	Dokumenttype på mottatt dokument/skjema. Følger typisk kodeliste på GeoNorge.	`KORR`
DokumentTittel	Navn på mottatt dokument/skjema.	`Søknad komplett`
FilStorrelse	Filens størrelse.	`25MB`
DokumentUrl	Lenke for nedlasting av dokumentet.	`https://admbygg.dibk.no/api/download/bf65a6da-d59f-4ecd-9953-831c7303e587/annenmyndighet.pdf`
OffentligJournalUrl	Lenke til kommunenes offentlige journal for byggesaken.	`http://www.kommunens.innsynslosning.no/2022000001-346/`

Melding

Felt

Beskrivelse

Eksempel

Melding

Kort melding fra saksbehandler i de tilfeller milepælsoppdateringen ikke krever et utgående dokument. Kan være generert automatisk fra saksbehandlingssystemet, feks fra loggen.

Søknaden er komplett

Saken er oversendt kulturminnemyndighet for uttalelse.