Feb 20, 2024 Endringene er tilgjengelig i test. Vi anbefaler eByggesak å utnytte metadataene i SvarUt i stedet for opplysninger sendt via Vedleggsopplysninger, da Vedleggsopplysninger vil fases ut på sikt.

Mye data er lagt inn i filnavnet som sendes fra FtPB via SvarUt. Vi ønsker å tilby bedre data til eByggesakssystemet og kommunen ved å utnytte metadatafelter i SvarUt.

Denne siden gir en oversikt over hvilke data FtPB sender med byggesøknaden til SvarUt.

1 Oversikt over metadata
2 Eksempelfil

Se også: Filnavnformat i FIKS SvarUt mottak

Oversikt over metadata

Metadata om forsendelsen

I tabellen under gir vi en oversikt over de viktigste feltene om forsendelsen.

Navn	Beskrivelse	Eksempel

Navn	Beskrivelse	Eksempel
avgivendeSystem	Hvilket søknadssystem som har levert søknaden/innsendingen.	`Fellestjenester bygg testmotor`
dokumenter	Se beskrivelse for søknad og vedlegg.	-
eksternReferanse	Altinn-referanse eller annen referanse til bruk i FtPB.	`AR15395796`
forsendelsesType	Type forsendelse til kommunen. For innsendinger fra FtB til kommunen skal forsendelsesType være `Byggesøknad`	`Byggesøknad`
kunDigitalLevering	FtPB setter kunDigitalLevering til true. Det betyr at søknaden ikke blir ettersendt i posten dersom den ikke hentes av kommunen.	`true`
metadataForImport	-	-
dokumentetsDato	Dato og tidspunkt for mottatt søknad/innsending.	`2024-02-13T14:55:23.2817527Z`
metadataFraAvleverendeSystem	-	-
ekstraMetadata	-
1_GBNR	Gårds-/bruks-/feste-/seksjonsnummer for eiendommen	`124/55//`
mottaker	-
digitalAdresse	Gir informasjon om digital adresse for kommunen (organisasjonsnummer)
svarSendesTil	-
digitalAdresse	Gir informasjon om digital adresse for søker, for eksempel organisasjonsnummer
postAdresse	Gir informasjon om søkers postadresse
tittel	Tittel for søknaden/innsendingen	`Vollveien 5B Søknad om rammetillatelse 124/55`

Metadata om søknaden

I tillegg til dataene over, følger metadata om dokumentene i forsendelsen. Dokumentene er angitt med et løpenummer, hvor det første dokumentet er PDF-versjon og det siste dokumentet er XML-versjon av søknaden. Tabellen under gir en oversikt over viktige data for å identifisere skjemaene fra Fellestjenester BYGG.

Navn i json-struktur	Beskrivelse	Eksempel

Navn i json-struktur	Beskrivelse	Eksempel
*dokumenter [0..]**	En liste med dokumenter i saken angitt med løpenummer, hvor 0 er søknadsPDF-en og det siste dokumentet er søknadsXML-en.	-
mimeType	Dokumentets filtype	`application/xml`
dokumentType	Dokumenttype fra Arkivlett v1. Følger kodeliste på GeoNorge.	`SØK-RS`
filnavn	Dokumentets filnavn	`12_Skjema_KAN-INNEHOLDE-PERSONOPPLYSNINGER.xml`
ekstraMetadata	Ekstra metadata lagt på av FtPB:	-
DatatypeId	Søknadstype fra kodeliste på GeoNorge	`RS`
DokumenttypeArkivlettV1	Dokumenttype fra Arkivlett v1. Følger kodeliste på GeoNorge.	`SØK-RS`
DokumenttypeArkivlettV2	Dokumenttype fra Arkivlett v2. Følger kodeliste på GeoNorge.	`SØKNAD`
DatatypeVersjon SkjemaVersjon	Angis for XML-skjema for å angi hvilken versjon av søknaden/innsendingen det gjelder. Versjon blir angitt for både hovedskjema og underskjema.	`6146.44096`
ReferanseXML	Unik referanse til xml-filen for søknaden. Feltet brukes til å mappe søknaden med tilhørende vedlegg, for eksempel valideringsrapport.	`123e4567-e89b-12d3-a456-426655440000`

Metadata om vedlegg

Listen med dokumenter inneholder også informasjon om vedlegg og underskjema. Dette er metadataene som er tilgjengelig i FtPB.

Navn i json-struktur	Beskrivelse	Eksempel

Navn i json-struktur	Beskrivelse	Eksempel
*dokumenter [0..]**		-
mimeType	Dokumentets filtype	`image/jpeg`
dokumentType	Dokumenttype fra Arkivlett v1. Følger kodeliste på GeoNorge.	`TEGN`
filnavn	Dokumentets filnavn	`3_TEGN_TegningNyttSnitt_Snitt.jpg`
ekstraMetadata	Ekstra metadata lagt på av FtPB:	-
VedleggId	ID fra søker/søknadssystem angitt i Vedleggsopplysninger med feltet `vedleggsid`	`TEGN-13`
VedleggFilnavn	Filnavn angitt fra søker.	`Snitt.jpg`
VedleggIfcValidationId	Eventuell valideringsID av ByggesaksBIM, dersom det er angitt i Vedleggsopplysninger med feltet `ifcValidationId`	`66343519-67bb-40d8-909f-5f325019bb15`
VedleggVersjonsnr	Versjonsnummer for vedlegget, dersom det er angitt i Vedleggsopplysninger med feltet `tegningsnr`	`2`
VedleggVersjonsdato	Versjonsdato for vedlegget, dersom det er angitt i Vedleggsopplysninger med feltet `tegningsdato`	`20240310`
VedleggKategori	Vedleggets bokstavkategori, dersom det er angitt i Vedleggsopplysninger med feltet `vedleggskategori`
VedleggKommentar	Beskrivende tittel for vedlegget.	`Snittegning av fasaden mot øst`
VedleggFulgtNabovarsel	Om vedlegget har blitt sendt med nabovarselet eller ikke, dersom det er angitt i Vedleggsopplysninger med feltet `vedleggFulgtNabovarsel`	`true`
DatatypeId	Kodeverdi for underskjema eller vedlegg, fra kodeliste på GeoNorge: kodeliste for underskjema kodeliste for vedlegg kodeliste for systemgenererte filer	`TegningNyttSnitt`
DokumenttypeArkivlettV1	Dokumenttype fra Arkivlett v1. Følger kodeliste på GeoNorge.	`TEGN`
DokumenttypeArkivlettV2	Dokumenttype fra Arkivlett v2. Følger kodeliste på GeoNorge.	`TEGN`
ReferanseXML	Unik referanse til søknaden eller gjennomføringsplanen. Feltet brukes til å mappe vedlegget til riktig skjema. For eksempel vil en søknad og gjennomføringsplan ha to ulike valideringsrapporter, og eByggesakssystemet kan bruke feltet til å mappe valideringsrapporten til riktig xml-skjema.	`123e4567-e89b-12d3-a456-426655440000`
inneholderPersonsensitivInformasjon	Settes `true` for systemgenererte filer som angir personnummer, ellers ikke brukt. Denne brukes i tillegg til filendelsen for XML-filer som kan inneholde personnummer (“KAN_INNEHOLDE_PERSONOPPLYSNINGER”)	-

Eksempelfil

Filen under gir et eksempel på en rammesøknad med vedlegg, underskjema og systemgenererte filer.

{
    "avgivendeSystem": "Fellestjenester bygg testmotor",
    "dokumenter": [
        {
            "mimeType": "application/pdf",
            "dokumentType": "SØK-RS",
            "filnavn": "1_Skjema.pdf",
            "giroarkSider": null,
            "ekstraMetadata": [
                {
                    "key": "DatatypeId",
                    "value": "RS"
                },
                {
                    "key": "DokumenttypeArkivlettV1",
                    "value": "SØK-RS"
                },
                {
                    "key": "DokumenttypeArkivlettV2",
                    "value": "SØKNAD"
                }
            ]
        },
        {
            "mimeType": "application/pdf",
            "dokumentType": "KART",
            "filnavn": "2_KART_Situasjonsplan_Situasjonsplan.pdf",
            "giroarkSider": null,
            "ekstraMetadata": [
                {
                    "key": "VedleggId",
                    "value": "Kart-1"
                },
                {
                    "key": "VedleggFilnavn",
                    "value": "Situasjonsplan.pdf"
                },
                {
                    "key": "VedleggVersjonsnr",
                    "value": "1"
                },
                {
                    "key": "VedleggVersjonsdato",
                    "value": "20240301"
                },
                {
                    "key": "VedleggKategori",
                    "value": "D"
                },
                {
                    "key": "VedleggKommentar",
                    "value": "Fritekst"
                },
                {
                    "key": "VedleggFulgtNabovarsel",
                    "value": "True"
                },
                {
                    "key": "DatatypeId",
                    "value": "Situasjonsplan"
                },
                {
                    "key": "DokumenttypeArkivlettV1",
                    "value": "KART"
                },
                {
                    "key": "DokumenttypeArkivlettV2",
                    "value": "KART"
                }
            ]
        },
        {
            "mimeType": "image/jpeg",
            "dokumentType": "TEGN",
            "filnavn": "3_TEGN_TegningNyttSnitt_Snitt v2.jpg",
            "giroarkSider": null,
            "ekstraMetadata": [
                {
                    "key": "VedleggId",
                    "value": "Tegn-2"
                },
                {
                    "key": "VedleggFilnavn",
                    "value": "Snitt+v2.jpg"
                },
                {
                    "key": "VedleggIfcValidationId",
                    "value": "Ifc-123"
                },
                {
                    "key": "VedleggVersjonsnr",
                    "value": "2"
                },
                {
                    "key": "VedleggVersjonsdato",
                    "value": "20240310"
                },
                {
                    "key": "VedleggKategori",
                    "value": "E"
                },
                {
                    "key": "VedleggKommentar",
                    "value": "Fritekst"
                },
                {
                    "key": "VedleggFulgtNabovarsel",
                    "value": "False"
                },
                {
                    "key": "DatatypeId",
                    "value": "TegningNyttSnitt"
                },
                {
                    "key": "DokumenttypeArkivlettV1",
                    "value": "TEGN"
                },
                {
                    "key": "DokumenttypeArkivlettV2",
                    "value": "TEGNING"
                }
            ]
        },
        {
            "mimeType": "application/pdf",
            "dokumentType": "ANKO",
            "filnavn": "4_ANKO_ErklaeringAnsvarsrett_Ansvarsrett-PRO.pdf",
            "giroarkSider": null,
            "ekstraMetadata": [
                {
                    "key": "VedleggId",
                    "value": "Ansv-1"
                },
                {
                    "key": "VedleggFilnavn",
                    "value": "Ansvarsrett-PRO.pdf"
                },
                {
                    "key": "VedleggKategori",
                    "value": "G"
                },
                {
                    "key": "VedleggKommentar",
                    "value": "Fritekst"
                },
                {
                    "key": "DatatypeId",
                    "value": "ErklaeringAnsvarsrett"
                },
                {
                    "key": "DokumenttypeArkivlettV1",
                    "value": "ANKO"
                },
                {
                    "key": "DokumenttypeArkivlettV2",
                    "value": "ANSVKONT"
                }
            ]
        },
        {
            "mimeType": "application/xml",
            "dokumentType": "KONTROLL",
            "filnavn": "5_KONTROLL_Valideringsrapport_valideringsrapportFraFellestjenesterBygg.xml",
            "giroarkSider": null,
            "ekstraMetadata": [
                {
                    "key": "DatatypeId",
                    "value": "Valideringsrapport"
                },
                {
                    "key": "DokumenttypeArkivlettV1",
                    "value": "KONTROLL"
                },
                {
                    "key": "DokumenttypeArkivlettV2",
                    "value": "SYSTEM"
                }
            ]
        },
        {
            "mimeType": "application/xml",
            "dokumentType": "KONTROLL",
            "filnavn": "6_KONTROLL_FoedselsnummerTiltakshaver_Tiltakshavers fødselsnummer-UNTATT-OFFENTLIGHET.xml",
            "giroarkSider": null,
            "ekstraMetadata": [
                {
                    "key": "DatatypeId",
                    "value": "FoedselsnummerTiltakshaver"
                },
                {
                    "key": "DokumenttypeArkivlettV1",
                    "value": "KONTROLL"
                },
                {
                    "key": "DokumenttypeArkivlettV2",
                    "value": "SYSTEM"
                }
            ],
            "inneholderPersonsensitivInformasjon": true
        },
        {
            "mimeType": "application/pdf",
            "dokumentType": "KORR",
            "filnavn": "7_KORR_TiltakshaversSignatur_TiltakshaversSignatur.pdf",
            "giroarkSider": null,
            "ekstraMetadata": [
                {
                    "key": "DatatypeId",
                    "value": "Annet"
                },
                {
                    "key": "DokumenttypeArkivlettV1",
                    "value": "KORR"
                },
                {
                    "key": "DokumenttypeArkivlettV2",
                    "value": "KORR"
                }
            ]
        },
        {
            "mimeType": "application/xml",
            "dokumentType": "KONTROLL",
            "filnavn": "8_KONTROLL_FoedselsnummerNabovarsel_Opplysninger gitt i nabovarsel-maskinlesbar_nøkkel-UNNTATT-OFFENTLIGHET.xml",
            "giroarkSider": null,
            "ekstraMetadata": [
                {
                    "key": "DatatypeId",
                    "value": "FoedselsnummerNabovarsel"
                },
                {
                    "key": "DokumenttypeArkivlettV1",
                    "value": "KONTROLL"
                },
                {
                    "key": "DokumenttypeArkivlettV2",
                    "value": "SYSTEM"
                }
            ],
            "inneholderPersonsensitivInformasjon": true
        },
        {
            "mimeType": "application/xml",
            "dokumentType": "Gjennomføringsplan",
            "filnavn": "9_ANKO_Gjennomføringsplan_KAN-INNEHOLDE-PERSONOPPLYSNINGER.xml",
            "giroarkSider": null,
            "ekstraMetadata": [
                {
                    "key": "DatatypeId",
                    "value": "Gjennomfoeringsplan"
                },
                {
                    "key": "DokumenttypeArkivlettV1",
                    "value": "Gjennomføringsplan"
                },
                {
                    "key": "DokumenttypeArkivlettV2",
                    "value": "ANSVKONT"
                },
                {
                    "key": "DatatypeVersjon",
                    "value": "6146.44096"
                },
                {
                    "key": "SkjemaVersjon",
                    "value": "6146.44096"
                }
            ]
        },
        {
            "mimeType": "application/xml",
            "dokumentType": "KORR",
            "filnavn": "10_KORR_Opplysninger gitt i nabovarsel_KAN-INNEHOLDE-PERSONOPPLYSNINGER.xml",
            "giroarkSider": null,
            "ekstraMetadata": [
                {
                    "key": "DatatypeId",
                    "value": "GjenpartNabovarsel"
                },
                {
                    "key": "DokumenttypeArkivlettV1",
                    "value": "KORR"
                },
                {
                    "key": "DokumenttypeArkivlettV2",
                    "value": "KORR"
                },
                {
                    "key": "DatatypeVersjon",
                    "value": "5826.42895"
                },
                {
                    "key": "SkjemaVersjon",
                    "value": "5826.42895"
                }
            ]
        },
        {
            "mimeType": "application/xml",
            "dokumentType": "KORR",
            "filnavn": "11_KORR_Vedleggsopplysninger_KAN-INNEHOLDE-PERSONOPPLYSNINGER.xml",
            "giroarkSider": null,
            "ekstraMetadata": [
                {
                    "key": "DatatypeId",
                    "value": "Vedleggsopplysninger"
                },
                {
                    "key": "DokumenttypeArkivlettV1",
                    "value": "KORR"
                },
                {
                    "key": "DokumenttypeArkivlettV2",
                    "value": "KORR"
                },
                {
                    "key": "DatatypeVersjon",
                    "value": "5797.42813"
                },
                {
                    "key": "SkjemaVersjon",
                    "value": "5797.42813"
                }
            ]
        },
        {
            "mimeType": "application/pdf",
            "dokumentType": "Gjennomføringsplan",
            "filnavn": "12_ANKO_Gjennomføringsplan.pdf",
            "giroarkSider": null,
            "ekstraMetadata": [
                {
                    "key": "DatatypeId",
                    "value": "Gjennomfoeringsplan"
                },
                {
                    "key": "DokumenttypeArkivlettV1",
                    "value": "Gjennomføringsplan"
                },
                {
                    "key": "DokumenttypeArkivlettV2",
                    "value": "ANSVKONT"
                }
            ]
        },
        {
            "mimeType": "application/pdf",
            "dokumentType": "KORR",
            "filnavn": "13_KORR_Opplysninger gitt i nabovarsel.pdf",
            "giroarkSider": null,
            "ekstraMetadata": [
                {
                    "key": "DatatypeId",
                    "value": "GjenpartNabovarsel"
                },
                {
                    "key": "DokumenttypeArkivlettV1",
                    "value": "KORR"
                },
                {
                    "key": "DokumenttypeArkivlettV2",
                    "value": "KORR"
                }
            ]
        },
        {
            "mimeType": "application/pdf",
            "dokumentType": "KORR",
            "filnavn": "14_KORR_Vedleggsopplysninger.pdf",
            "giroarkSider": null,
            "ekstraMetadata": [
                {
                    "key": "DatatypeId",
                    "value": "Vedleggsopplysninger"
                },
                {
                    "key": "DokumenttypeArkivlettV1",
                    "value": "KORR"
                },
                {
                    "key": "DokumenttypeArkivlettV2",
                    "value": "KORR"
                }
            ]
        },
        {
            "mimeType": "application/xml",
            "dokumentType": "SØK-RS",
            "filnavn": "15_Skjema_KAN-INNEHOLDE-PERSONOPPLYSNINGER.xml",
            "giroarkSider": null,
            "ekstraMetadata": [
                {
                    "key": "DatatypeId",
                    "value": "RS"
                },
                {
                    "key": "DokumenttypeArkivlettV1",
                    "value": "SØK-RS"
                },
                {
                    "key": "DokumenttypeArkivlettV2",
                    "value": "SØKNAD"
                },
                {
                    "key": "DatatypeVersjon",
                    "value": "6741.45752"
                },
                {
                    "key": "SkjemaVersjon",
                    "value": "6741.45752"
                }
            ]
        }
    ],
    "eksternReferanse": "AR15433742",
    "forsendelsesType": "Byggesøknad",
    "konteringsKode": null,
    "kunDigitalLevering": true,
    "lenker": null,
    "metadataForImport": {
        "dokumentetsDato": "2024-02-20T15:55:33.0727683Z",
        "journalPostType": "I",
        "journalStatus": null,
        "saksAar": 0,
        "saksSekvensNummer": 0,
        "tittel": "Vollveien 5B Søknad om rammetillatelse 124/55"
    },
    "metadataFraAvleverendeSystem": {
        "dokumentetsDato": null,
        "ekstraMetadata": [
            {
                "key": "1_GBNR",
                "value": "124/55//"
            },
            {
                "key": "klassering.1.GBNR",
                "value": "124/55//"
            },
            {
                "key": "2_SID",
                "value": "AR15433742"
            },
            {
                "key": "klassering.2.SID",
                "value": "AR15433742"
            }
        ],
        "journalDato": null,
        "journalPostType": null,
        "journalStatus": null,
        "saksBehandler": null,
        "tittel": "Vollveien 5B Søknad om rammetillatelse 124/55"
    },
    "mottaker": {
        "digitalAdresse": {
            "organisasjonsNummer": "964951284"
        },
        "postAdresse": {
            "adresse1": null,
            "adresse2": null,
            "adresse3": null,
            "land": null,
            "navn": "Horten",
            "postNummer": "9999",
            "postSted": "Digital levering"
        }
    },
    "signaturType": null,
    "signeringUtloper": null,
    "svarPaForsendelse": null,
    "svarSendesTil": {
        "digitalAdresse": {
            "organisasjonsNummer": "910065203"
        },
        "postAdresse": {
            "adresse1": "Lillegata 5",
            "adresse2": null,
            "adresse3": null,
            "land": null,
            "navn": "ARKITEKT FLINK",
            "postNummer": "7003",
            "postSted": "Trondheim"
        }
    },
    "tittel": "Vollveien 5B Søknad om rammetillatelse 124/55"
}

Hovedfelter på forsendelsesnivå:

Oversikt over struktur

Hovedskjema angis både som PDF-fil og XML-fil:

Rammesøknad-PDF

På samme måte som for hovedskjema, sendes underskjema både i PDF- og XML-variant.

For vedlegg kan det angis en rekke ekstra metadata:

Fellestjenester Bygg

Metadata i SvarUt

Oversikt over metadata

Metadata om forsendelsen

Metadata om søknaden

Metadata om vedlegg

Eksempelfil