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 |
Mottatt tilleggsdokumentasjon | Bekreftelse på at Supplering av søknad er mottatt som 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 kalle. | API for oppdatert milepæl |
Vedtak fattet (VF) | Utsending av vedtak med vedtaksbrev, status, strukturerte sjekklisteutfall og eventuelle godkjente dispensasjoner. Følgende sjekklisteutfall dekkes:
| API for vedtak |
Søknad uaktuell | Retur av søknaden grunnet omfattende mangler. Se eksempel på returgrunner her: https://register.geonorge.no/kodelister/ebyggesak/retur-av-soknad/retur-av-soknad-bokmal | API for oppdatert milepæl |
Avsluttet (PA) | Vi vurderer å støtte denne dersom det er nyttig for økosystemet. Her ønsker vi innspill. | 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 her: LENKE
Datamodeller for de ulike API-ene
Les mer om innholdet i de ulike API-ene:
Legg til kommentar