Eksempel AR med kommunalsaksbehandlingsdata
Mar 13, 2023 Informasjonen under er basert på bruk av versjon 1 av API-ene for saksbehandlingsdata. Versjon 2 utvikles i løpet av 2023.
Innsendingen AR6892641 på TEST er en rammesøknad der vi har brukt APIene til sak/arkiv systemene til å melde saksbehandlingsdata tilbake til FtB. Det er mulig å kalle på denne arkivreferansen for å få tilgang til eksempel data.
APIenen som brukes av kommunene er dokumentert her: https://dibk.atlassian.net/wiki/spaces/FB/pages/2682126337
Innsending
Rett etter innsending gir status APIet denne statusen:
GET /api/status/AR6892641
{
"Arkivreferanse": "AR6892641",
"ForsendelsesIdSvarUt": "f426ad6f-7543-4857-8923-0f0b72694070",
"AltinnInnsending": "2020-10-28T11:07:21.883",
"SvarUtForsendelse": "2020-10-28T11:08:16.057",
"Saksaar": 0,
"Sakssekvensnummer": 0,
"StatusInnsending": "Ok",
"Hendelser": [
{
"Beskrivelse": "SvarUt har akseptert forsendelsen. ForsendelsesId: f426ad6f-7543-4857-8923-0f0b72694070",
"Tidspunkt": "2020-10-28T11:08:16.007"
},
{
"Beskrivelse": "Sender skjema til: Testkonto TT02 (Hafslo Revisjon) (organisasjonsnummer: 910297937 ). ",
"Tidspunkt": "2020-10-28T11:08:14.327"
},
{
"Beskrivelse": "Valideringsresultat: WARNING: For valgte tiltakstype(r) nyttbyggboligformal i søknad anbefales underskjema matrikkelopplysninger utfylt., iht. 4397.2.50; WARNING: Vedlegg TegningEksisterendeSnitt og TegningNyttSnitt anbefales for valgte tiltakstyper i søknad(jfr nasjonal sjekkliste pkt 1.49)., iht. 4397.2.19; WARNING: Vedlegg TegningEksisterendePlan og TegningNyPlan anbefales for valgte tiltakstyper i søknad(jfr nasjonal sjekkliste pkt 1.42)., iht. 4397.2.18; WARNING: Vedlegg Avkjørselsplan er anbefalt da det er valgt at tiltaket gir ny eller endret adkomst, iht. 4397.2.30; WARNING: Når bygningstype er valgt må kodebeskrivelse(Hytter, sommerhus ol fritidsbygning) være i henhold til kodeliste for bygningstype., iht. 4397.1.2; ",
"Tidspunkt": "2020-10-28T11:08:12.34"
},
{
"Beskrivelse": "Vedlegg: , Situasjonsplan take5.pdf[593358], TegningNyFasade take5.pdf[593358]",
"Tidspunkt": "2020-10-28T11:08:11.96"
},
{
"Beskrivelse": "Skjema (dataformatid, dataformatversjon): , (5693, 42425), (5786, 42725)",
"Tidspunkt": "2020-10-28T11:08:11.903"
},
{
"Beskrivelse": "Skjema er hentet fra Altinns tjenestearkiv for DiBK. Med 2 vedlegg og 2 skjema.",
"Tidspunkt": "2020-10-28T11:08:11.873"
},
{
"Beskrivelse": "Skjema er lagt i kø for behandling til SvarUt.",
"Tidspunkt": "2020-10-28T11:08:09.793"
}
],
"Distribusjoner": []
}
Kommunen rapporterer saksnummer
Når eByggesak systemet tildeler et saksnummer, bruker de dette APIet
POST /api/kvittering/ny
{
"AltinnArkivreferanse": "AR6892641",
"Melding": "Melding1",
"Saksaar": 2020,
"Sakssekvensnummer": 1234,
"OffentligJournalUrl": "www.9999.kommune.no/2020/1234/sak.html",
"Journalaar": 2020,
"Journalsekvensnummer": 33333,
"TiltaksType": {
"Kode": "Nytt bygg - Boligformål"
},
"Organisasjonsnummer": "910304704",
"Kommunenummer": "9999"
}
Status APIet vil da legge på saksnummer data på “toppen” og man får noen flere hendelser:
{
"Arkivreferanse": "AR6892641",
"ForsendelsesIdSvarUt": "f426ad6f-7543-4857-8923-0f0b72694070",
"AltinnInnsending": "2020-10-28T11:07:21.883",
"SvarUtForsendelse": "2020-10-28T11:08:16.057",
"Saksaar": 2020,
"Sakssekvensnummer": 1234,
"StatusInnsending": "Ok",
"Hendelser": [
{
"Beskrivelse": "Melding1",
"Tidspunkt": "2020-10-28T12:04:23.73",
"VisMerUrl": "www.9999.kommune.no/2020/1234/sak.html"
},
{
"Beskrivelse": "SvarUt har akseptert forsendelsen. ForsendelsesId: f426ad6f-7543-4857-8923-0f0b72694070",
"Tidspunkt": "2020-10-28T11:08:16.007"
},
{
"Beskrivelse": "Sender skjema til: Testkonto TT02 (Hafslo Revisjon) (organisasjonsnummer: 910297937 ). ",
"Tidspunkt": "2020-10-28T11:08:14.327"
},
{
"Beskrivelse": "Valideringsresultat: WARNING: For valgte tiltakstype(r) nyttbyggboligformal i søknad anbefales underskjema matrikkelopplysninger utfylt., iht. 4397.2.50; WARNING: Vedlegg TegningEksisterendeSnitt og TegningNyttSnitt anbefales for valgte tiltakstyper i søknad(jfr nasjonal sjekkliste pkt 1.49)., iht. 4397.2.19; WARNING: Vedlegg TegningEksisterendePlan og TegningNyPlan anbefales for valgte tiltakstyper i søknad(jfr nasjonal sjekkliste pkt 1.42)., iht. 4397.2.18; WARNING: Vedlegg Avkjørselsplan er anbefalt da det er valgt at tiltaket gir ny eller endret adkomst, iht. 4397.2.30; WARNING: Når bygningstype er valgt må kodebeskrivelse(Hytter, sommerhus ol fritidsbygning) være i henhold til kodeliste for bygningstype., iht. 4397.1.2; ",
"Tidspunkt": "2020-10-28T11:08:12.34"
},
{
"Beskrivelse": "Vedlegg: , Situasjonsplan take5.pdf[593358], TegningNyFasade take5.pdf[593358]",
"Tidspunkt": "2020-10-28T11:08:11.96"
},
{
"Beskrivelse": "Skjema (dataformatid, dataformatversjon): , (5693, 42425), (5786, 42725)",
"Tidspunkt": "2020-10-28T11:08:11.903"
},
{
"Beskrivelse": "Skjema er hentet fra Altinns tjenestearkiv for DiBK. Med 2 vedlegg og 2 skjema.",
"Tidspunkt": "2020-10-28T11:08:11.873"
},
{
"Beskrivelse": "Skjema er lagt i kø for behandling til SvarUt.",
"Tidspunkt": "2020-10-28T11:08:09.793"
}
],
"Distribusjoner": []
}
Kommunen rapporterer mangelbrev
Mangelbrev registreres og leses slik
Mangler kan hentes via dette APIet:
Kommunen rapporterer vedtak og vilkår
Vedtak og vilkår registreres og leses slik
Vedtak og vilkår kan hentes via status-APIet:
Det er ikke per i dag noen andre mekanismer enn å polle på arkivreferansen for å finne status endringer.