API-er for oppdaterte milepæler
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)
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 |
|---|---|---|
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:
| 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:
| 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: