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:

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": 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

POST /api/mangelbrev

{
  "AltinnArkivreferanse": "AR6892641",
  "Saksaar": 2020,
  "Sakssekvensnummer": 1234,
  "OffentligJournalUrl": "www.9999.kommune.no/2020/1234/sak.html",
  "Journalaar": 2020,
  "Journalsekvensnummer": 4444,
  "DokumentetsDato": "2020-10-28T10:12:48.360Z",
  "Tittel": "Stor gate vei 1, foreløpig tilbakemelding på søknad om rammesøknad, fasadeendring og endring i brannkonsept",
  "Organisasjonsnummer": "910304704",
  "Kommunenummer": "9999",
  "Matrikkelnummer": {
    "Kommunenummer": "9999",
    "Gaardsnummer": 63,
    "Bruksnummer": 528,
    "Festenummer": 0,
    "Seksjonsnummer": 0
  },
  "Mangler": [
    {
      "Type": {
        "Kodebeskrivelse": "i) Minsteavstand til annen bebyggelse, kraftlinjer, vegmidte, vann- og avløpsledninger: Det må oppgis minsteavstander til <oppgi>."
      },
      "ReferanseSjekkpunkt": "",
      "ReferanseVilkaarId": "",
      "ReferanseTiltakId": "",
      "MangelId": "edd246a4-7789-480e-ac38-cf09cdb1843a",
      "Tittel": "Minsteavstand til kommunal vannledning ",
      "Beskrivelse": "Kommunen skal i sin behandling vurdere om krav til minsteavstand til annen bebyggelse, vei, vann- og avløpsledninger samt kraftlinjer er ivaretatt. Det må derfor oppgis minsteavstander hvis noe av det overstående er relevant.  Ledninger i grunnen Hensynet til ledninger i grunnen er et av flere hensyn som kommunen skal vurdere ved tiltakets plassering etter  pbl. § 29-4. Det kan ikke gis tillatelse til tiltak som medfører et ulovlig forhold på annen eiendom, jf. pbl. § 29-11. Dette gjelder der krav til vannforsyning, avløp, atkomst og parkering fastsatt i byggetillatelse på annen eiendom ikke lenger oppfylles. En mulig konflikt mellom et tiltak og eksisterende ledninger vil i de aller fleste tilfeller løses i byggesaken med et vilkår om at eksisterende ledning sikres eller flyttes. Hvis kommunen har grunn til å mistenke at et tiltak kommer i konflikt med ledninger som ikke kan flyttes eller sikres, for eksempel gjennom merknader fra en nabo, må kommunen be om ytterligere dokumentasjon. Dersom søknaden og/eller nabomerknader viser at det planlagte byggetiltaket kan komme i strid med vann- og avløpsledninger, kan kommunen ved behandlingen av søknaden be om flere opplysninger hvis disse ikke er tilfredsstillende. Dette kan være relevant både i forhold til den vurderingen kommunen skal foreta etter pbl. § 29-4 og i forhold til spørsmålet om søknaden skal avvises etter pbl. pbl. § 21-6. Dersom kommunen anser at slike opplysninger er nødvendige, men mangler, vil tidsfristen ikke starte før kommunen har mottatt fullstendig søknad. Slike mangler kan også gi grunnlag for at søknaden avvises.",
      "RegistrertDato": "2020-10-28T10:12:48.360Z"
    },
        {
      "Type": {
        "Kodebeskrivelse": "m) Tegninger og målsatt situasjonsplan: Utomhusplan som angir koter, terrengbearbeiding m.m."
      },
      "ReferanseSjekkpunkt": "",
      "ReferanseVilkaarId": "",
      "ReferanseTiltakId": "",
      "MangelId": "ec29f5c1-3f8e-43fe-a3a7-a0183e663896",
      "Tittel": "Utomhusplan som angir koter, terrengbearbeiding m.m.",
      "Beskrivelse": "Utforming av tiltaket skal vises på tegninger og plassering av tiltaket skal vises på situasjonsplan. Hva som skal vises på tegninger, detaljeringsgrad og målestokk, avhenger av tiltaket. Normalt vil det være tilstrekkelig med fasade-, snitt- og plantegninger utført i normal detaljeringsgrad og målestokk 1:100. Hovedmål på tiltaket må påføres planer og snitt.  Situasjonsplanen utarbeides på grunnlag av situasjonskartet som utstedes av kommunen. Normalt skal tiltaket eller tiltakene tegnes inn med plassering, orientering (møneretning), målsetting og avstander til nabogrenser, andre bygg, vei og kraftlinjer. I tillegg skal endring av adkomstforhold, parkering og terrengarbeider (nye terrenglinjer) fremgå. Hvilke opplysninger, detaljering, målsetting m.m. som skal tegnes inn avhenger av tiltakstypen. Minste avstand til eiendomsgrense og senterlinje vei må påføres. For spesielle tiltak anbefales det å søke informasjon hos kommunen.  Standard Norge har utviklet egne spesifikasjoner som et hjelpemiddel for de som skal lage tegninger og situasjonsplaner i byggesaker. Disse spesifikasjonene vil kunne være anvendelige for de fleste saker.",
      "RegistrertDato": "2020-10-28T10:12:48.360Z"
    }
  ]
}

Mangler kan hentes via dette APIet:

GET /api/mangelbrev/arkivreferanse/AR6892641

[
    {
        "AltinnArkivreferanse": "AR6892641",
        "Saksaar": 2020,
        "Sakssekvensnummer": 1234,
        "OffentligJournalUrl": "www.9999.kommune.no/2020/1234/sak.html",
        "Journalaar": 2020,
        "Journalsekvensnummer": 4444,
        "DokumentetsDato": "2020-10-28T10:12:48.36",
        "Tittel": "Stor gate vei 1, foreløpig tilbakemelding på søknad om rammesøknad, fasadeendring og endring i brannkonsept",
        "Organisasjonsnummer": "910304704",
        "Kommunenummer": "9999",
        "Matrikkelnummer": {
            "Kommunenummer": "9999",
            "Gaardsnummer": 63,
            "Bruksnummer": 528,
            "Festenummer": 0,
            "Seksjonsnummer": 0
        },
        "Mangler": [
            {
                "Type": {
                    "Kodebeskrivelse": "i) Minsteavstand til annen bebyggelse, kraftlinjer, vegmidte, vann- og avløpsledninger: Det må oppgis minsteavstander til <oppgi>."
                },
                "ReferanseSjekkpunkt": "",
                "ReferanseVilkaarId": "",
                "ReferanseTiltakId": "",
                "MangelId": "edd246a4-7789-480e-ac38-cf09cdb1843a",
                "Tittel": "Minsteavstand til kommunal vannledning ",
                "Beskrivelse": "Kommunen skal i sin behandling vurdere om krav til minsteavstand til annen bebyggelse, vei, vann- og avløpsledninger samt kraftlinjer er ivaretatt. Det må derfor oppgis minsteavstander hvis noe av det overstående er relevant.  Ledninger i grunnen Hensynet til ledninger i grunnen er et av flere hensyn som kommunen skal vurdere ved tiltakets plassering etter  pbl. § 29-4. Det kan ikke gis tillatelse til tiltak som medfører et ulovlig forhold på annen eiendom, jf. pbl. § 29-11. Dette gjelder der krav til vannforsyning, avløp, atkomst og parkering fastsatt i byggetillatelse på annen eiendom ikke lenger oppfylles. En mulig konflikt mellom et tiltak og eksisterende ledninger vil i de aller fleste tilfeller løses i byggesaken med et vilkår om at eksisterende ledning sikres eller flyttes. Hvis kommunen har grunn til å mistenke at et tiltak kommer i konflikt med ledninger som ikke kan flyttes eller sikres, for eksempel gjennom merknader fra en nabo, må kommunen be om ytterligere dokumentasjon. Dersom søknaden og/eller nabomerknader viser at det planlagte byggetiltaket kan komme i strid med vann- og avløpsledninger, kan kommunen ved behandlingen av søknaden be om flere opplysninger hvis disse ikke er tilfredsstillende. Dette kan være relevant både i forhold til den vurderingen kommunen skal foreta etter pbl. § 29-4 og i forhold til spørsmålet om søknaden skal avvises etter pbl. pbl. § 21-6. Dersom kommunen anser at slike opplysninger er nødvendige, men mangler, vil tidsfristen ikke starte før kommunen har mottatt fullstendig søknad. Slike mangler kan også gi grunnlag for at søknaden avvises.",
                "RegistrertDato": "2020-10-28T10:12:48.36"
            },
            {
                "Type": {
                    "Kodebeskrivelse": "m) Tegninger og målsatt situasjonsplan: Utomhusplan som angir koter, terrengbearbeiding m.m."
                },
                "ReferanseSjekkpunkt": "",
                "ReferanseVilkaarId": "",
                "ReferanseTiltakId": "",
                "MangelId": "ec29f5c1-3f8e-43fe-a3a7-a0183e663896",
                "Tittel": "Utomhusplan som angir koter, terrengbearbeiding m.m.",
                "Beskrivelse": "Utforming av tiltaket skal vises på tegninger og plassering av tiltaket skal vises på situasjonsplan. Hva som skal vises på tegninger, detaljeringsgrad og målestokk, avhenger av tiltaket. Normalt vil det være tilstrekkelig med fasade-, snitt- og plantegninger utført i normal detaljeringsgrad og målestokk 1:100. Hovedmål på tiltaket må påføres planer og snitt.  Situasjonsplanen utarbeides på grunnlag av situasjonskartet som utstedes av kommunen. Normalt skal tiltaket eller tiltakene tegnes inn med plassering, orientering (møneretning), målsetting og avstander til nabogrenser, andre bygg, vei og kraftlinjer. I tillegg skal endring av adkomstforhold, parkering og terrengarbeider (nye terrenglinjer) fremgå. Hvilke opplysninger, detaljering, målsetting m.m. som skal tegnes inn avhenger av tiltakstypen. Minste avstand til eiendomsgrense og senterlinje vei må påføres. For spesielle tiltak anbefales det å søke informasjon hos kommunen.  Standard Norge har utviklet egne spesifikasjoner som et hjelpemiddel for de som skal lage tegninger og situasjonsplaner i byggesaker. Disse spesifikasjonene vil kunne være anvendelige for de fleste saker.",
                "RegistrertDato": "2020-10-28T10:12:48.36"
            }
        ]
    }
]

Kommunen rapporterer vedtak og vilkår

Vedtak og vilkår registreres og leses slik

POST /api/vedtak/ny

{
  "AltinnArkivreferanse": "AR6892641",
  "Melding": "string",
  "Saksaar": 2020,
  "Sakssekvensnummer": 1234,
  "OffentligJournalUrl": "www.9999.kommune.no/2020/1234/sak.html",  
  "UtgaaendeDokumentUrl": "https://admbygg.dibk.no/api/v1/dokument/en_dokument_id",
  "Vedtaksdato": "2020-10-28T10:12:48.354Z",
  "Status": "Godkjent",
  "Vilkaar": [
    {
      "VilkaarID": "ab0a1a46-c382-4ace-be15-501c619b4357",
      "VilkaarTilProsess": "1.82",
      "Beskrivelse": "Dispensasjonssøknad er ikke komplett."
    },
    {
      "VilkaarID": "af61f2d5-1245-4d60-a9ca-554bf3a47f97",
      "VilkaarTilProsess": "1.40",
      "Beskrivelse": "Situasjonsplan mangler dimensjoner på kjøreatkomst"
    },
    {
      "VilkaarID": "67492e3a-8950-4066-aebc-42efe90bb725",
      "VilkaarTilProsess": "3.12",
      "Beskrivelse": "Tiltaket er ikke i tråd med reguleringsplan"
    }
  ],
  "Organisasjonsnummer": "910304704"
}

Vedtak og vilkår kan hentes via status-APIet:

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": 2020,
    "Sakssekvensnummer": 1234,
    "StatusInnsending": "Ok",
    "Vedtak":"Godkjent",
    "Vedtaksdato":"2020-10-28T10:12:48.354Z",
    "VedtaksDokumentUrl":"https://admbygg.dibk.no/api/v1/dokument/en_dokument_id",
    "Hendelser": [
        {
            "Beskrivelse": "string",
            "Tidspunkt": "2020-10-28T12:46:12.307",
            "VisMerUrl": "www.9999.kommune.no/2020/1234/sak.html"
        },
        {
            "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"
        }
    ],
    "Vilkaar": [
        {
            "VilkaarID": "ab0a1a46-c382-4ace-be15-501c619b4357",
            "VilkaarTilProsess": "1.82",
            "Beskrivelse": "Dispensasjonssøknad er ikke komplett."
        },
        {
            "VilkaarID": "af61f2d5-1245-4d60-a9ca-554bf3a47f97",
            "VilkaarTilProsess": "1.40",
            "Beskrivelse": "Situasjonsplan mangler dimensjoner på kjøreatkomst"
        },
        {
            "VilkaarID": "67492e3a-8950-4066-aebc-42efe90bb725",
            "VilkaarTilProsess": "3.12",
            "Beskrivelse": "Tiltaket er ikke i tråd med reguleringsplan"
        }
    ],
    "Distribusjoner": []
}

Det er ikke per i dag noen andre mekanismer enn å polle på arkivreferansen for å finne status endringer.