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: API-er for saksbehandlingsdata (v2)

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.