API for oppdatert milepæl

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

Datamodell for API for oppdatert milepæl

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

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

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

AvsenderKontaktpunkt

Felt

Beskrivelse

Eksempel

Felt

Beskrivelse

Eksempel

AvsenderKontaktpunkt

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

Felt

Beskrivelse

Eksempel

Milepæl

Milepælen kallet gjelder for.

-

Kodeverdi

-

SUA

Kodebeskrivelse

-

Sendt til uttalelse annen myndighet

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 (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

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.