KuDoc datamodell

Sist endret

June 23, 2026

I KuDoc er det foreløpig to sentrale konsepter:  (data)innsamling  og  innsamlingsinstrument.
For en bestemt innsamling, kan det bli tatt i bruk én eller flere instrumenter. Instrumentene brukt for en innsamling kan enten være av en og same type – for eksempel to el. flere Altinn3-skjemaer (f.eks. et skjema for bedrifter og et annet for foretak);  eller det kan være forskjellige typer instrumenter brukt i én og samme innsamling – for eksempel Altinn3-skjema for de fleste foretak, pluss API’er for innhenting av data fra noen utvalgte, store foretak, som kan tilby en slik løsning.

Informasjonselementer som inngår i KuDoc er delt i tre nivåer:
1. informasjonselementer som relaterer seg til innsamling som helhet,
2a. opplysninger for instrument, der informasjonselementene er felles for alle typer instrumenter (altså: felter er like / gjelder for alle instrumenter, uavhengig av instrumenttype – men ikke verdier i de feltene: de siste vil være egne for hvert enkelt instrument),  og
2b. informasjonselementer for instrument, som bare er aktuelle for en bestemt instrumenttype – f.eks. opplysninger om intervju-modus: CATI | CAPI | CAWI m.m. kun gjelder for instrumenter av type spørreskjema for personer;  mens RA/RS-skjemanummer (jf. Kodeliste for RA/RS-nummer (skjema)) er kun relevant for innsamlinger vha. skjemaer i Altinn;  osv.
De to første grupper informasjonselementer (1 og 2a) er angitt i to underkapitler nedenfor: Innsamling og hhv. Instrument - alle typer.

Bruk av symboler:
Påkrevd for utkast   = informasjonselementet er obligatorisk i både status Draft og Publisert
Påkrevd ved publisering   = obligatorisk kun for status Publisert
(for forklaring av status Draft vs. Publisert, se kapittel Legge inn opplysninger)

Innsamling

Innsamlingsnummer

Påkrevd for utkast 
Blir tildelt automatisk ved opprettelse av ny innsamling i KuDoc. Nummeret er unikt på tvers av alle innsamlinger.

Mottakende Dapla-team

Påkrevd for utkast 
Verdi i denne velges fra listen over tilgjengelige Dapla-team fra Dapla Ctrl. Valget blir styrende for hvilket team sin kildebøtte som data fra innsamlingen skal legges i.

Grunngivende statistikkprodukt

Påkrevd ved publisering 
Statistisk produkt (statistikk, indeks e.l.) som utgjør opprinnelig formål med å etablere innsamlingen. Gjerne det produktet som fremgår i et DM-dokument som knytter sammen en statistikk med innsamlingen (f.eks. vedtak om etablering av statistikk, e.a. i DM).
Angis ved kortnavn, som velges fra liste fra Statistikkregisteret.
Obligatorisk først ved publisering i KuDoc, og kun for innsamlinger med offisiell statistikk som formål (dvs. unntak for innsamlinger som merkes av som markedsoppdrag - jf. neste felt).

Med utgangspunkt i det angitte kortnavnet til statistikken, blir det hentet inn noen flere opplysninger fra Statistikkregisteret og vist i KuDoc, som: fullt navn til statistikkproduktet, og statistikkansvarlig(e) med kontaktinfo.

Oppdragstype

To-valgs felt: Offisiell statistikk vs. Markedsoppdrag/forskning/uttesting.
Den første verdien fordrer krav om at det må angis grunngivende statistikkprodukt (jf. forrige felt).

Lenke til utvalgsplan

Url-adresse til der utvalgsplan for innsamlingen kan finnes (enten i en strukturert form eller kun som et tekstdokument)

Leverandører av data

Påkrevd ved publisering 
Liste med verdier fra Kodeliste for SSB-datakilder. Angir konkrete kilder/leverandører - f.eks. NAV, Utdanningsdirektoratet,  eller samlebegrep for SSBs egne utvalgsundersøkelser (–> kodeverdi 67).
Verdier valgt i listen her på innsamlings-nivå, utgjør tillatte verdier for Instrument-datakilde på de enkelte instrumentene som er knyttet til innsamlingen (se neste avsnitt: Instrument)

Enhetstyper for rapporteringsenheter

Påkrevd ved publisering 
Liste med verdier fra KLASS kodeliste for enhetstyper, dog begrenset til Foretak, Bedrift eller Person. Angir hvilke typer enheter som er rapporteringsenheter i innsamlingen.

Særlige kategorier av data

Avkryssingsboks for å angi om innsamlingen inkluderer særlige kategorier av personopplysninger, iht. GDPR art.9.
Default er Nei, må endres til Ja hvis det er tilfellet.

Innkvitteringsfrekvens

Påkrevd ved publisering 
Frekvensen som data samles inn med og kontrolleres for at alle enheter har rapportert.
Velges fra liste med følgende verdier: Engangs | Hvert 10. år | Hvert 5. år | Hvert 4. år | Hvert 3. år | Hvert 2. år | Årlig | Halvårlig | Kvartalsvis | Termin (= hverannen mnd.) | Månedlig | Ukentlig.

Oppstarts-/initieringsdato for innsamling

Påkrevd ved publisering 
For planlagte innsamlinger: foreslått startdato for innsamlingen, dvs. når datainnsamlingen skal påstartes/initieres for første gang.
For eksisterende innsamlinger: den tidligste kjente datoen for når innsamlingen ble kjørt for første gang. Nb. hvis de nyere tidspunkter for kjøring av innsamlingen ikke lenger stemmer med tidsmønster: (den faktiske) Oppstartsdato + N x frekvens  (f.eks. en årlig innsamling som opprinnelig var kjørt på våren, men senere flyttet til høsten, e.l.), da bør datoen som angis justeres frem (“jukses litt”) slik at de nåværende innsamlings-forekomstene stemmer med mønsteret – slik at mønsteret kan brukes for å anslå og planlegge / omtrentlig beramme nye, kommende kjøringer av innsamlingen.

Avtalt/kommunisert innrapporteringsfrist

Frist for innlevering, angitt i antall dager etter oppstartsdato
(nb. forstått som en generell regel/anvisning - ikke hensyntatt anledningsvise justeringer for fridager, ferier e.l.)

Siste, endelig innrapporteringsfrist

Siste, endelige frist for innlevering i antall dager etter oppstartsdato, før man må gå over til produksjonsfaser (inkludert purringer og utvidede frister)

 

Instrument (alle typer)

Instrumenttype

Påkrevd for utkast 
I nåværende versjon, er det implementert tre valgmuligheter:
Spørreundersøkelse for personer (vha. Blaise, web og/el. app) | Skjema i Altinn | API

Leverandør av data for instrumentet

Påkrevd ved publisering 
En enkeltverdi fra Kodeliste for SSB-datakilder. Valgbare verdier her, er bestemt av verdier lagt inn i tilsvarende felt på Innsamling-nivået (jf. Leverandører av data i forrige avsnitt).

Mottaksfrekvens

Påkrevd ved publisering 
Hvor ofte hentes/mottas data vha. dette instrumentet.
Verdier som kan velges er de samme som i feltet Innkvitteringsfrekvens for innsamling, og i tillegg: … | Daglig | Kontinuerlig (dvs. strømming) | Etter behov (“ad hoc”)

Ekstern kontaktperson (navn)

Kontaktperson for innsamlingen med dette instrumentet hos leverandøren av data

Ekstern kontaktperson, e-post

E-post adresse til kontaktpersonen hos leverandøren av data

Intern kontaktperson (navn)

Velges fra listen over team-medlemmer i Dapla-teamet som ble angitt på Innsamling-nivå (jf. Mottakende Dapla-team). For den valgte personen, blir også e-post adresse vist, avlest fra Dapla Ctrl.

Produktkode evt. arbeidsordre

Produktkode/arbeidsordre knyttet til innsamlingen (enten for innsamlingen som helhet, eller spesifikt for den innsamling-delen som utføres vha. det aktuelle instrumentet).
Kan angis enten med 5 siffer dvs. kun prosjekt-/produktkode, eller med 7 siffer dvs. inkludert også sifre for fullstendig arbeidsordre.