API for saksoppdatering, nytt
- Veslemøy Søbak
- Helga Jerven
API for saksoppdatering brukes for å gi søker og søknadsløsningen informasjon om at søknadstypen eller tiltakstypen(e) er endret.
Endring av søknastype skal kun skje dersom søknad om tillatelse i ett trinn endres til søknad om rammetillatelse, og i harmoni med søker. Disse dataene sendes strukturert i tillegg til det utgående dokumentet. For endring av tiltakstype er det mulig å legge til en melding om hva som er endret. Det er viktig at sjekklistene oppdateres ihht. ny(e) tiltakstyper.
Dette API-et har ingen kobling til milepæl eller utfall.
Innhold
Nøkkeldata
Hovedformålet med API for saksoppdatering er å gi søker informasjon dersom:
søknadstypen endres
tiltakstypen er feil
flere tiltakstyper kreves
hvilke tiltakstyper som tilhører hvilket saksnummer
sakens kontaktpunkt oppdateres eller endres
sakens eiendomsopplysninger oppdateres eller endres
Datamodell
Beskrivelse av felter
Under ligger en beskrivelse av feltene for API for saksoppdatering. Vi har også lagt med en kolonne med eksempeldata, for slik å gi et inntrykk av hvordan vi ønsker at API-et skal brukes. Under viser vi både hvordan vi har tenkt det skal brukes ved endring av søknadstype og ved endring av tiltakstype. Felt i blått er felles datafelt, mens grønne felt er spesielle for API for saksoppdatering.
Feltene for metadata, saksnummer, avsenders kontaktpunkt, salsbehandlingsfrist, kommunens utgående dokument og melding er felles på tvers av alle API-ene. Vi har likevel lagt de til her med relevante eksempeldata.
Metadata
Felt | Beskrivelse | Eksempel |
|---|---|---|
Metadata | Metadata for forsendelsen | - |
FraEbyggesakssystem | Navn på eByggesakssystemet som kvitteringen er sendt fra. |
|
Innsendingsreferanse | Referansen for innsendingen. Dette vil typisk være altinnreferansen. |
|
FtBID | Prosjekt-ID fra FtPB. Les mer her: FtBID i Sluttrapport for bygningsavfall |
|
AvsenderID | ID til virksomheten som har mottatt innsendingen. Skal samsvare med kommunennummer for kommune, og organisasjonsnummer for sektormyndigheter. |
|
AvsenderNavn | Navnet på kommunen/sektormyndigheten som har mottatt innsendingen. |
|
EkspedertDato | Dato for utsendingen. |
|
OffentligJournalUrl | Lenke til kommunenes offentlige journal for byggesaken. |
|
Saksnummer
Felt | Beskrivelse | Eksempel |
|---|---|---|
Saksnummer | Saksnummer i kommunen: | - |
Saksaar | Saksåret i saksnummeret som er tildelt. |
|
Sakssekvensnummer | Sekvensnummeret i saksnummeret som er tildelt. |
|
Journalpostnummer | Journalpostnummeret i saksforløpet på saken . |
|
Avsenders kontaktpunkt
Felt | Beskrivelse | Eksempel |
|---|---|---|
AvsenderKontaktpunkt | Navn og kontaktinformasjon til saksbehandler eller avdeling som er ansvarlig for å behandle søknaden. | - |
Navn | - |
|
E-post | - |
|
Telefon | - |
|
Mobil | - |
|
Utgående dokument
Felt | Beskrivelse | Eksempel |
|---|---|---|
UtgaaendeDokument | Liste med informasjon om dokument eller dokumentene som sendes fra kommunen. | - |
Distribusjon (1..*) | Liste med informasjon om hvordan dokumentet er distribuert: |
|
| Angir hvordan dokumentet er sendt/distribuert. Følger kodeliste på GeoNorge. |
|
| Lenke for nedlasting av dokumentet dersom FtPBs dokumentformidler brukes. Les mer om FtPBs dokumentformidler. |
|
DokumentNavn | Navn på utgående dokument. |
|
MimeType | Filtype for utgående dokument. |
|
DokumentStorrelse | Dokumentets størrelse. |
|
Hoveddokument | Boolsk verdi for å angi om dokumentet er et hoveddokument eller vedlegg. |
|
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. |
|
Gjeldende søknadstype
Felt | Beskrivelse | Eksempel |
|---|---|---|
Soknadstype | Denne oppdateringen kan kun brukes fra søknad i ett trinn til rammesøknad, og skal kun skje i samsvar med søker. Utgående dokument må sendes med. |
|
Gjeldende tiltakstype
Felt | Beskrivelse | Eksempel |
|---|---|---|
Tiltakstype (0…*) | Tiltakstype eller en liste av tiltakstyper som er endret i løpet av saksbehandlingsprosessen. Følger kodeliste på GeoNorge. |
|
Eiendom
Felt | Beskrivelse | Eksempel |
|---|---|---|
Eiendom (0…*) | Informasjon om eiendommen innsendingen gjelder. Brukes dersom opplysningene endres eller oppdateres i løpet av saksbehandlingen. | - |
Adresselinje 1 | - |
|
Gardsnummer | - |
|
Bruksnummer | - |
|
Seksjonsnummer | - |
|
Festenummer | - |
|
Bygningsnummer | - |
|
Bruksenhetsnummer | - |
|