Hopp til slutten av metadata
Gå til begynnelsen av metadataene

Du ser på en gammel versjon av denne siden. Se den nye versjonen.

Sammenlign med nåværende Vis sidehistorikk

Versjon 1 Neste »

API for kvittering er et enkelt API-kall som brukes til å gi kvittering om at en sending er mottatt og tildelt saksnummer i kommunen. API-et inneholder informasjon søker trenger for å vite at innsendingen er registrert.

API for kvittering responderer på hver innsending (feks. rammesøknad, søknad om igangsettingstillatelse og supplering av søknad), og ikke kun hovedsøknaden. Kvitteringen sendes når innsendingen blir journalført i saksbehandlingssystemet. Det kan ta noe tid fra innsendingen er sendt, til den er innregistrert og kvittering blir sendt.

API for kvittering skal kun være en bekreftelse på mottatt innsending, og skal ikke oppdateres underveis i saksbehandlingsprosessen. Oppdateringer i saken dekkes via andre API-er når milepælen endres eller ved andre viktige oppdateringer.

Innhold

Milepæl

API for kvittering skal dekke følgende milepæler:

  • Søknad mottatt (MS)

  • Mottatt tilleggsdokumentasjon (mangler kode)

I tillegg ser vi for oss at API for kvittering kan bli brukt i fremtiden ved følgende milepæl:

  • Forespørsel om forhåndskonferanse mottatt (FM)

Nøkkeldata

Hovedformålet med API for kvittering er å gi søker informasjon om følgende:

  • mottaksdato

  • hvilke filer som er mottatt

  • saksnummer

  • saksbehandler dersom det er tildelt

Datamodell

Beskrivelse av felter

Under ligger en beskrivelse av feltene for API for kvittering. Vi har også lagt med en kolonne med eksempeldata, for slik å gi et inntrykk av hvordan vi ønsker at API-et skal brukes. Felt i blått er felles datafelt, mens lysgrønne felt er spesielle for API for kvittering.

Feltene for metadata, saksnummer, saksansvarlig, milepæl og saksbehandlingsfrist samsvarer er felles på tvers av alle API-ene. Les mer om det i Felles datafelt - API-er for oppdatert milepæl (lenke). 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.

Acos

InnsendingReferanse

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

EkspedertDato

Dato for utsendingen.

2022-08-01T12:31:58.39

Saksnummer

Felt

Beskrivelse

Eksempel

Saksnummer

Saksnummer i kommunen/sektormyndigheten:

-

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

Saksansvarlig

Felt

Beskrivelse

Eksempel

Saksansvarlig

Navn og kontaktinformasjon til saksbehandler eller avdeling som er ansvarlig for å behandle søknaden.

-

Navn

-

Saksbehandler ikke tildelt

E-post

-

-

Telefon

-

-

Mobil

-

-

Saksbehandlingsfrist

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

Milepæl

Felt

Beskrivelse

Eksempel

Milepæl

Milepælen kallet gjelder for. I API for kvittering vil dette alltid være “Søknad mottatt” (MS).

-

Kodeverdi

-

MS

Kodebeskrivelse

-

Søknad mottatt

Mottatt dato

Felt

Beskrivelse

Eksempel

MottattDato

Datoen sendingen er mottatt. Dette er samme dato som innsendingen er mottatt av kommunen/sektormyndigheten i SvarUt.

2022-08-01T12:31:58.39

Registrert dato

Felt

Beskrivelse

Eksempel

RegistrertDato

Dato innsendingen er journalført i saksbehandlingssystemet.

2022-08-07T08:01:34.10

MottattFil

Felt

Beskrivelse

Eksempel

MottattFil (0…*)

Liste over søknad, underskjema og vedlegg som er mottatt i kommunen:

-

DokumentType

Dokumenttype på mottatt dokument/skjema. Følger dokumentkategori i NOARK. Viser til to eksempler, søknaden og fasadetegning.

SØKNAD

TEGN

FilNavn

Navn på mottatt dokument/skjema.

1_Skjema.pdf

4_TEGN_TegningEksisterendeFasade_D-UK 7041_4274.png

MimeType

Filformat.

PDF

PNG

Filstorrelse

Filens størrelse.

192,68 KB

266MB

EkstraMetadata

Felt for ekstra metadata, feks filens opprinnelige navn.

Soknad-om-rammetillatelse-v2.pdf

D-UK 7041_4274.pdf

OffentligJournalUrl

Lenke til kommunenes offentlige journal for byggesaken.

http://www.kommunens.innsynslosning.no/2022000001-345/

  • Ingen etiketter