API-ene er basert på milepæler fra Nasjonal produktspesifikasjon for plan- og byggesak. MIlepælene er grunnlaget for fremdriften i saksbehandlingen, og ved bruk av API-ene vil søker få en oppdatering av status på sin innsending.

Nasjonal produktspesifikasjon for plan- og byggesak skiller mellom obligatoriske og frivillige milepæler, men Fellestjenester BYGG har foreløpig ikke tjenester som dekker hele saksforløpet og kan ikke dekke alle alternativene.

API-er for oppdaterte milepæler er derfor delt inn i fire:

API for kvittering v2
API for mangler v2
API for vedtak v2
API for endret milepæl (nytt)

Kobling mellom API-er og milepæler

Mer informasjon om de enkelte API-ene finnes som undersider.

Kobling mellom milepæler og API-er

Ulike API-kall skal brukes avhengig av hva slags milepæl som utløser behovet for å sende en oppdatering til søker. Tabellen under viser milepæler med beskrivelse, relevante sjekklisteutfall og hvilket API som skal brukes. Milepælene under dekkes av Fellestjenester BYGG:

Milepæl	Beskrivelse	API

Milepæl	Beskrivelse	API
Søknad mottatt (MS)	Bekreftelse på at søknad eller annen sending fra Fellestjenester BYGG er mottatt, med saksnummer og liste med mottatte filer.	API for kvittering
Mangelbrev (MB)	Utsending av mangler med mangelbrev og strukturerte sjekklisteutfall. Følgende utfall dekkes: Be om dokumentasjon Mangel Mangel/pauser løpende tidsfrist Mangel/tidsfrist starter ikke Oppfordre til innsending	API for mangler
Tilleggsdokumentasjon mottatt (MT)	Bekreftelse på at Supplering av søknad er mottatt, enten som ettersending av informasjon eller svar på et mangelbrev.	API for kvittering
Søknad komplett (KS)	Oppdatering i saken om at søknaden er komplett. Saksbehandlingsfristen skal beregnes og oppdateres.	API for oppdatert milepæl
Sendt til uttalelse annen myndighet (SUA)	Oppdatering i saken om at søknaden er sendt til uttalelse til annen myndighet, med et tekstfelt med beskrivelse av oversendelsen og hvilken myndighet det er snakk om.	API for oppdatert milepæl
Mottatt uttalelse fra annen myndighet (MUA)	Oppdatering i saken om at uttalelse fra annen myndighet er mottatt. Ofte sendes uttalelsen direkte til søker fra myndigheten, men lenke til kopi av uttalelsen kan eventuelt også sendes med kallet.	API for oppdatert milepæl
Vedtak fattet (VT)	Utsending av vedtak med vedtaksbrev, status og strukturerte sjekklisteutfall. Følgende sjekklisteutfall dekkes: Sett vilkår i vedtak Sett oppfølgingspunkt i vedtak Avslå søknad Avvise søknad	API for vedtak
Søknad uaktuell (US)	Brukes når søknad blir trukket av søker eller når søknaden ikke er relevant å behandle. Se eksempler på returgrunner her: https://register.geonorge.no/kodelister/ebyggesak/retur-av-soknad/retur-av-soknad-bokmal	API for oppdatert milepæl
Avsluttet (PA)	Brukes når hele søknadsbehandlingen er avsluttet, inkludert interne oppgaver etter vedtak er fattet.	API for oppdatert milepæl

Hvilke milepæler som kan sendes med API-ene styres av en kodeliste som skal legges til GeoNorge. Det gjør at vi kan utvide API-ene til å støtte flere milepæler etter hvert. Les mer om kodelista.

Datamodeller for de ulike API-ene

Les mer om innholdet i de ulike API-ene: