Metadata i SvarUt

Mar 18, 2024 Endringene er satt i produksjon.

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.

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:

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

image-20240220-162042.png
Oversikt over struktur