Grænseflade til underretning om hændelser fra Ungedatabasen til kommunen
Dato
08-11-2021
VersionStatus
3.1 Gældende fra og med den 1. januar 2022
Ansvarlig
Jørgen Vejbæk


Ændringshistorik

Version

Kapitel/afsnit

Beskrivelse

0.8


Kladde

1.0

Kapitel 5

Kapitel 6
Kapitel 6.1
Kapitel 6.1.1.1

Parameteren InstitutionsNummer er fjernet fra forespørgslen (request). Informationen hentes fra brugernavnet i stedet.
Elementet 'Modtager' er indsat i svaret (response)
UngHarUddannelsespaalaeg er ikke krævet
COSAFormaalVersion er krævet

2.0

Kapitel 6

Ny struktur i HaendelserUng vedrørende data om uddannelsesparathedsvurdering og uddannelsespålæg

2.1

Kapitel 6.1

Redigerede betegnelser for uddannelsesniveau i grænsefladebeskrivelsen.

3

Hele dokumentet

Tilpasset Integrationsplatformen IPL

3.1

Hele dokument

Information om uddannelsespålæg er udvidet med data om den unges behov ved start af uddannelses, samt kontaktoplysninger til hhv. jobcenter og uddannelsesinstitution med henblik på vejledning.
Dokumentet er ikke længere opdelt efter version af webservice.


Indhold
1 Indledning
2 Hvem kan hente data?
3 Hvilke data kan hentes?
4 Hvilke oplysninger underrettes der om?
5 WS HaendelserTilKommunen
6 Struktur HentSvarHaendelser version 3
6.1 HaendelserUng
6.2 HaendelseUddannelsesForloeb
6.2.1 Uddannelse
6.2.2 UddannelsesinstitutionKontakt
6.2.3 ElevKontakt
6.2.4 PraktikSted
6.3 HaendelseBeskaeftigelsesForloeb
6.4 HaendelseSocialYdelse
6.5 KontaktJobOgUddannelsesOnsker
6.5.1 KommuneKontakt
6.5.2 JobOnsker
6.5.3 UddannelsesOnsker
6.6 UddannelsesParathedsVurdering
6.6.1 FinalEducationReadinessAssessment
6.7 HaendelseUddannelsesPaalaeg
6.7.1 InstitutionKontakt
6.7.2 JobcenterKontakt
6.7.3 JobcenterSpoergeskema
7 Fejlkoder
7.1 Fejlkoder ved afvist underretning
8 Endpoints til testmiljø

Indledning

Ifølge lov om den kommunale ungeindsats skal kommunen (KUI) opsøge og vejlede alle unge, der ikke er i gang med eller har gennemført en ungdomsuddannelse eller en videregående uddannelse, indtil de fylder 25 år.
Endvidere skal jobcentre ifølge kontanthjælpsreformen administrere, at unge under 30 år uden uddannelse skal have uddannelseshjælp i stedet for kontanthjælp.
Til dette formål har relevante uddannelsesinstitutioner pligt til at indberette oplysninger om unges uddannelsesforløb til Ungedatabasen (UDB), som drives af Styrelsen for It og Læring (STIL).
UDB videresender oplysningerne til kommune (den kommunale Ungeindsats KUI når den unge er under 25 år og til jobcentre indtil den unge fylder 30 år). KUI kan modtage oplysninger om unge med uddannelsespålæg op til de fylder 30 år, hvis KUI står for vejledningen efter aftale med jobcenteret. Derudover anvender STIL oplysningerne til statistiske formål.
Indberetninger til UDB sker fra institutionernes studieadministrative systemer via webservices udstillet på STIL's integrationsplatform (Integrationsplatformen). Integrationsplatformen er knudepunktet for STIL's eksternt rettede webservices. Den er en ren infrastrukturkomponent som via autentificering, autorisering, logning og kryptering (https) understøtter en sikker, ensartet og effektiv udveksling af data mellem STIL's centrale systemer og eksterne systemer.
Integrationsplatformen anvendes af uddannelsesinstitutioner, myndigheder og organisationer/virksomheder på førskole- og grundskoleområderne samt på ungdomsuddannelsesområdet og voksen- og efteruddannelsesområdet.
Yderligere oplysninger om tilslutning og tekniske detaljer kan findes på STIL's supportsite for Integrationsplatformen via https://viden.stil.dk/x/BgBwBg.
Dette dokument beskriver strukturen for de oplysninger, som kommunen kan afhente.

Hvem kan hente data?

Kommuner kan hente hændelser fra Ungedatabasen vedrørende unge, der ifølge CPR-registret har bopælsadresse i kommunens område.
Endvidere kan kommunen afhente hændelser om unges aktivitet i grundskolen og 10. klasseniveau, hvis institutionen ligger i kommunens område, og det er den kommune, som der senest er indberettet uddannelsesaktivitet fra på grundskole- eller 10. klasseniveau. Dog ikke fra private skoler som efterskoler.

Hvilke data kan hentes?

Kommunen kan hente hændelser om ændringer i de unges uddannelsesforløb indberettet af uddannelsesinstitutionerne, hændelser om de unges indkomst samt jobcentres data om jobcenterinitierede aktiviteter og uddannelsespålæg, herunder vejlednings relaterede kontaktoplysninger på henholdsvis jobcenter og uddannelsesinstitution. Endvidere gives oplysninger om den unges uddannelsesønsker, jobønsker og kontaktperson oplysninger i kommunen. Endelig kan kommunen forespørge på status (hændelser) for en specifik ung.
Der kan endvidere forespørges om unges uddannelsesparathedsvurdering (UPV) samt udvidet information om unges uddannelsespålæg.
For mere uddybende information om hvad der må hentes af data, så henvises til vejledningen til Ungedatabasen under viden.stil.dk samt følgende afsnit.

Hvilke oplysninger underrettes der om?

Kommunen kan afhente (ved cpr-forespørgsel) oplysninger på den unges eventuelle kontaktperson i kommunen. Endvidere kan unges jobønske og/eller uddannelsesønske være angivet. Disse oplysninger er indsendt af KUI, og kan hentes når en unge flytter til kommunen.
Der underrettes om ændringer i den unges uddannelsesforløb, ændringer i de forløb, som jobcentrene har initieret samt ændringer i den unges indkomst.
Uddannelsesforløb:

  • Optagelse på en uddannelse (fx alment gymnasium eller 1. del af grundforløb på en erhvervsuddannelse), forudsat den unge er fyldt 15 år. Bemærk, at der er forskellige CØSA-formål for 1. del af erhvervsskolegrundforløbet, og 2. del af erhvervsskolegrundforløbet (der også fortsættes med i hovedforløbet).
  • Afbrud af en uddannelse
  • Gennemførelse af et skole- eller uddannelsesforløb

I de tilfælde, hvor der er tale om risiko for frafald, underrettes KUI direkte på baggrund af indberetninger fra uddannelsesinstitutionen. Uddannelsesinstitutionen indberetter om risiko for frafald ved en markering i indberetningen, hvilket skal ses som et øjebliksbillede af den unges forhold. Den unge opfattes fortsat som i gang med uddannelsen. Dvs., at status for den unges uddannelsesforløb er Optaget.
Forløb initieret af jobcentre:
Et forløb kan være:

  • Erhvervspraktik
  • Uddannelsesrelateret aktivitet
  • Uddannelsespålægsrelaterede aktiviteter


Ungedatabasen modtager indberetninger om erhvervspraktik og uddannelsesrelateret aktivitet indtil den unge fylder 25 år.
Uddannelsespålæg:
Der informeres om en ung har et uddannelsespålæg. Hvis den unge har et uddannelsespålæg, vises info om dato og trin for uddannelsespålæggets start, navn, nummer og telefonnummer på jobcenterdata. Yderligere vises jobcenterets overordnede vurdering af den unges forskellige behov ved start på en uddannelse, hvor til der er givet et uddannelsespålæg. Der kan yderligere indgå kontaktoplysninger til jobcenteret og uddannelsesinstitutionen, som tænkes anvendt i forbindelse med vejledning af den unge, så længe uddannelsespålægget er aktivt.
Der kan hentes information om uddannelsespålægget indtil den unge fylder 30 år. Det er af hensyn til, at der kan være indgået en aftale med jobcenteret om, at KUI står for vejledningen af den unge med uddannelsespålæg.
Indkomst:
Kommunen oplyses om ændringer i den unges beskæftigelse eller forsørgelse. Hvad angår beskæftigelse, informeres der om, hvorvidt den unge er deltids- eller fuldtidsbeskæftiget, herunder angives beskæftigelsesgraden.
Angående forsørgelsen oplyses der om, hvorvidt den unge modtager sociale ydelse eller ej.
Ungedatabasen viderebringer info om indkomst indtil den unge fylder 25 år.
Indberetninger foretages dagligt, så derfor anbefales det, at kommunen afhenter hændelser dagligt.
Det tilstræbes, at indberetningerne bliver sendt fra den enkelte institution til Ungedatabasen i den rækkefølge, som de registreres. Der kan dog ikke gives sikkerhed for, at det vil forholde sig således, hvilket kan afspejle sig i underretningen.
OptagelsesprøveDer indberettes resultater fra optagelsesprøver på erhvervsskoler (EUD) og gymnasiale uddannelser (GYM). Prøverne indberettes som forløb, hvor tilmelding til prøve sidestilles med et optag. Prøven består af en faglig prøve samt en samtale. Vurdere skolen at den unge har bestået, så resulterer det i en hændelse med status gennemført. Består den unge ikke, så resulterer det i en hændelse med status afbrud og en afbrudsårsag. Der er afsat 2 CØSA-formål i uddannelsesmodellen til prøver (hhv. EUD og GYM).

WS HaendelserTilKommunen

Denne webservice anvendes af kommunerne ved afhentning af hændelser for en eller flere unge. Når servicen kaldes, skal det angives hvilken kommune, der hentes for.
Servicen ligger på integrationsplatformen.

Figur 1 XML struktur for afhentning af hændelser
Der kan afgrænses på forskellige parametre i forhold til hvilke hændelser, der ønskes retur.
Hvis ingen kriterier er udfyldt, returneres hændelser, der endnu ikke er afsendt. Der kan hentes hændelser, indtil den unge fylder 30 år. Kontaktpersonoplysninger i kommunen (KUI) samt job- og uddannelsesønsker sendes ikke, med mindre der afgrænses på CPRNr. Der sendes UPV-data, hvis der spørges på CPRNr.
Hvis HaendelseNummer er udfyldt uden CPRNr, returneres uafhentede hændelser med hændelsesnumre, der er større end det angivne. Der kan hentes hændelser indtil den unge fylder 30 år.
Hvis CPRNr er udfyldt uden HaendelsesNummer, returneres alle uafhentede ikke-annullerede hændelser for dette CPR-nummer. Er den unge fyldt 25 år, så sendes uddannelseshændelser, dog kun de hændelser hvor hændelsesdato ligger efter den unge er fyldt 25 år.
For unge under 25 år skelnes der mellem om den unge har gennemført en ungdomsuddannelse. Hvis ja, så returneres kun status information om den unge samt optag- og gennemførelseshændelse på første ungdomsuddannelsesforløb. Det vil sige, at der oplyses ikke om øvrige uddannelsesaktiviteter m.m., som den unge har gennemgået.
For unge over 25 år skelnes der mellem om den unge har gennemført en erhvervskompetencegivende uddannelse. Hvis ja, så returneres ligeledes kun status information om den unge samt optag- og gennemførelseshændelse på første erhvervskompetencegivende uddannelsesforløb.
Hvilke uddannelser, som er erhvervskompetencegivende, fremgår af linket til UDB stamdata på Viden.stil.dk under Uddannelsesmodeller/-kodesæt.
Den valgte afskærmning ift. under/over 25 år er forankret i loven om kommunal ungeindsats. Yderligere sendes evt. oplysninger om kontaktperson i kommunen for unge op til 25 år samt den unges job- og uddannelsesønsker.
Hvis både CPRNr og HaendelseNummer er udfyldt, returneres alle ikke-annullerede hændelser for dette CPR-nummer med et hændelsesnummer, der er større end det angivne. Er den unge fyldt 25 år, så sendes uddannelseshændelser, dog kun de hændelser hvor hændelsesdato ligger efter den unge er fyldt 25 år.
Yderligere sendes evt. oplysninger om kontaktperson i kommunen samt den unges job- og uddannelsesønsker. Yderligere sendes information om evt. uddannelsespålæg og evt. UPV-data. Afskærmning i forhold til gennemført ungdomsuddannelse eller erhvervskompetencegivende uddannelse gør sig også gældende her.
Generelt returneres hændelser i orden efter hændelsesnummeret, med laveste hændelsesnummer først.
Hvis der ikke findes hændelser baseret på de angivne søgekriterier, returneres statusoplysningerne for den unge i elementet HaendelserUng.

Struktur for Hent:

Felt

Type

Krævet

Lovlige værdier

Beskrivelse

HaendelseNummer

String

Nej


Hvis der spørges på hændelsesnummeret, returneres alle uafhentede hændelser med et større hændelsesnummer end den anførte.

Laveste hændelsesnummer sendes først.

CPRNr

String (10)

Nej

Skal kunne findes i CPR-registeret med adresse i Danmark

Her fremsøges hændelser når:
Adressen for CPR-nummeret er beliggende i den kommune, den unge har bopæl jf. det seneste CPR-udtræk i Ungedatabasen.
Der fremsøges ikke annullerede hændelser.

Kommunen kan udtrække alle hændelser på unge i alderen fra 15 til og med 24 år. Kommunen kan trække status information og uddannelseshændelser (som er indtruffet efter den unge fyldte 25 år) om de unge i alderen 25-29 år. Der henvises til Ungedatabasen vejledning under Viden.stil.dk for uddybende information.

Version 2: SkoleKommune kan også spørge på CPR-nummer og afhente UPV-data. Her valideres det, at den unge er aktiv i grundskolen samt at den spørgende kommune stemmer overens med kommunen, hvor den skole den unge er aktiv på er placeret.

InstitutionsNummer

String

Ja


Institutionsnummer fra den forespørgende KUI



Struktur HentSvarHaendelser version 3




Figur 2: XML struktur for svar ved afhentning af hændelser
HentSvar indeholder oplysning om, hvorvidt der er flere hændelser, der opfylder søgekriteriet og det højeste hændelsesnummer, der er returneret i svaret.
Der returneres maksimalt 99 hændelser. Disse kan være fordelt på et varierende antal unge, så der er ikke en bestemt afgrænsning i xsd'en.
Hvis der spørges på hændelseNummer, og der identificeres mere end 99 hændelser, returneres de 99 med det laveste hændelsesnummer. Samtidigt returneres dels en markering for, at ikke alle hændelser er returneret og dels det højeste hændelsesnummer, der er returneret for det pågældende CPR-nummer. Derefter kan der spørges med det største hændelsesnummer i det svar, der modtages.

Felt

Type

Krævet

Lovlige værdier

Beskrivelse

FindesFlereHaendelser

Boolean

Ja

True = Ja der findes flere hændelser, og der bør spørges igen for at få de resterende.
False = Nej. Alle hændelser er returneret.

Markering af om der findes flere hændelser end dem, der er returneret i det aktuelle svar.
Feltet anvendes, når der er forespurgt på "siden sidst" udtræk på hændelser, hvor der er identificeret flere end 99.
Når man modtager besked om, at der findes flere hændelser, er det hensigten, at der spørges igen på de resterende hændelser.

HoejesteHaendelseNummer

String

Nej


HoejesteHaendelseNummer anvendes ved afhentning af hændelser. Feltet angiver det højeste hændelsesnummer, der er returneret. Hvis der er angivet en markering af, at der findes flere hændelser, kan kaldet gentages med denne værdi i HaendelseNummer, hvilket vil give de efterfølgende hændelser.

HaendelserUng

XML element

Nej





HaendelserUng

HaendelserUng indeholder identifikation af den unge, som hændelserne er registreret for, og de hændelser, der opfylder søgekriterierne.

Felt

Type

Krævet

Lovlige værdier

Beskrivelse

CPRNr

Integer (10)

Ja

Skal kunne findes i CPR-registeret

CPR-nummeret på den unge, som indberetningen vedrører.

AfsluttetUddannelsesNiveau

String

Nej

Undervisningspligt,
Ungdomsuddannelse og Videregående udd.

Statusfelt, der oplyser hvilket højeste uddannelsesniveau den unge har afsluttet.
Er der ikke opnået et uddannelsesniveau, så sendes 'Ingen afsluttet uddannelse'.

HaendelseUddannelsesPaalaeg

XML-element

Nej


Oplysning om, hvorvidt jobcentret har markeret, at den unge har et uddannelsespålæg og, at jobcentret ønsker hændelser om den unge.

Der oplyses en række informationer i forbindelse med uddannelsespålægget.

HaendelseUddannelsesForloeb

XML element

Nej



HaendelseBeskaeftigelsesForloeb

XML element

Nej



HaendelseSocialYdelse

XML element

Nej



KontaktJobOgUddannelsesOnsker

XML element

Nej


Den unges eventuelle kontaktperson i kommune, samt den unges job og/eller uddannelsesønske. Udfyldes kun ved CPR forespørgsel.

UddannelsesParathedsVurdering

XML element

Nej


Den unges Uddannelsesparathedsvurdering (UPV). Udfyldes kun ved CPR forespørgsel.

HaendelseUddannelsesForloeb

HaendelseUddannelsesForloeb (grundskole, forberedende, ungdom- og videregående uddannelse) indeholder de alle data om den indberettede hændelse.

Felt

Type

Krævet

Lovlige værdier

Beskrivelse

DatoOptag

DateTime

Nej

yyyy-mm-dd hh:mm_ss.sssssss

Dato for optag i samme forløb medsendes, når den forefindes.

HaendelseNummer

String

Ja


Unik identifikation af indberetningen i UDB.

ForloebId

String

Ja

Se note 1.

En entydig identifikation af forløbet, som indberetningen (hændelsen) er blevet tilknyttet i UDB.
Et forløb defineres ved samme kombination af CPR-nummer, hovedinstitution og uddannelseskode.

InstitutionNummer

Integer(6)

Ja

Skal kunne genfindes i institutionsregisteret

Afdelingen, hvor undervisningen eller aktiviteten administreres.
UDB anvender værdien fra institutionsregisteret.

HaendelseDato

DateTime

Ja

yyyy-mm-dd hh:mm_ss.sssssss

Dato, hvor hændelsen indtræffer. Fx startdato på en uddannelse ved optagelse, datoen for afbrud af uddannelse, gennemførelse eller dato for risiko for frafald.

Status

Integer(2)

Ja

Se note 2

En kode, som beskriver status for den unges uddannelsesforløb (optaget, afbrud og gennemført)

AfbrudsaarsagsKode

Integer

Nej, men ja ved status afbrud

Se note 3

Kode for årsagen til afbruddet af forløbet eller aktiviteten.Feltet skal udfyldes, hvis den indberettede status er afbrud.

KildeLeverandoer

Varchar (20)

Ja


Betegnelse eller kode, der identificerer kildeleverandøren.

ElevTrin

Integer (2)

Nej

Se note 4

Den unges individuelle niveau målt i klassetrin 00-11.

Klassetrin

Integer (2)

Nej

Se note 4

Angivelse af klassetrin i grundskoleforløbet (00-11 klasse).
Bemærk, enten Forberedende aktivitetskode eller Klassetrin skal være udfyldt.

Klassetype

Integer (2)

Nej

Se note 5

Normalklasse eller specialklasse

Klassenavn

String (30)

Nej

Fx "Mariehønen" eller "9B"

Navn på klassen tildelt af institutionen.

ForberedendeAktivitetsKode

String (4)

Nej


Kode fra kodesæt til forberedende forløb.
Bemærk, enten Forberedende aktivitetskode eller Klassetrin skal være udfyldt.
Kodesættet ses på STIL's hjemmeside med reference til Ungedatabasen (viden.stil.dk).

Annullering

Boolean

Nej

False = nej
True = ja

Markering af, at en tidligere indberetning med samme indhold skal annulleres (fejl-indberetning).

Uddannelse

XML element

Nej
(kun CØSA-formål)



Aktivitetsgruppekode

Integer(4)

Nej
(kun SIS)

UFMs liste over koder

Kode for uddannelsesaktivitet, hvor det studieadministrative system SIS anvendes. SIS dækker over en lang række korte og mellemlange uddannelser.

StadsKode

Integer(4)

Nej
(kun STADS)

Se note 6

Kode for uddannelsesaktivitet på mellemlange og lange videregående uddannelser, som anvender det studieadministrative system STADS.

Etatkode

Integer (10)

Nej
(kun ved etat uddannelser)

Se note 7

Etat kode på 3 karakterer. Feltet anvendes til uddannelser indenfor politi og forsvar.
Der anvendes PKAT koder

GennemfoertHf

Boolean

Nej

False= nej
True = ja

Sættes til 'Sand', når en ung samlet set har opnået et HF bevis baseret på enkeltfag.
Der indberettes med CØSA-formål 3015. Indberetningen sker efter at de relaterede enkeltfag er indberettet. Status skal indberettes som 'Gennemført'.

Registreringstid

DateTime

Ja

yyyy-mm-dd hh:mm_ss.sssssss

Tidspunktet for registreringen af ændringen i kildesystemet. Registreringstiden indsættes af UDB, hvis det ikke sker hos datakilden.

FrafaldstruetMarkering

Boolean

Nej

True = Frafaldstruet
False = Ikke frafaldstruet

Markering for registrering af risiko for frafald.
Nærmere beskrivelse af, hvornår en ung vurderes at være frafaldstruet ses af Ungedatabasevejledningen.

UddannelsesinstitutionKontakt

XML element

Nej



ElevKontakt

XML element

Nej



PraktikSted

XML element

Nej



JobcenterAktivitetType

String (1)

Nej

U = Uddannelsesaktivitet
V = Virksomhedsaktivitet

Angivelse af jobcenteraktiviteten.

JobcenterAktivitetKode

Integer (4)

Nej


Kode for jobcenteraktiviteten.

Skoleperiode

String(2)

Nej

Skal findes i uddannelsesmodellen

Kode for skoleperiode under uddannelser, hvor der benyttes CØSA-formål. Benyttes i forbindelse med FGU uddannelse til at se hvor den unge er i uddannelsesforløbet.

EguUddannelsesbevis

Boolean

Nej

True: Opnået Egu uddannelsesbevis
False: Ikke opnået Egu uddannelsesbevis

Sættes til true når den unge har gennemført en FGU uddannelse med retningen EGU, og opnået at få et uddannelsesbevis herpå. Markeringen giver ikke erhvervskompetence.


Note 1: ForloebId
Et forløbId sammenkæder flere indberetninger om samme uddannelse til et samlet forløb for den unge. På den måde skabes der en relation i Ungedatabasen fra optaget til afbrudt eller gennemført.
Ungedatabasen opretter forløbId'et, når den første hændelse for en kombination af CPR-nummer, hovedinstitutionsnummer og uddannelseskode modtages. ForløbId'et vil nu være det samme for alle de indberetninger, datakilden skal sende, som relaterer sig til dette forløb, indtil den unge afbryder eller gennemfører. Heraf følger, at der ikke skal være et ForløbId i den første indberetning med status 'Optaget'.
Efter datakilden har sendt enten afbrud eller gennemførelse, og dette ikke skal annulleres, skal datakilden ikke indberette forløbId'et, hvis den unge optages på samme uddannelse og hovedinstitution igen (typisk efter afbrud). UDB vil i disse situationer danne et nyt forløbId til datakilden. ForløbId'et tælles op til en højere værdi.
I forbindelse med FGU uddannelsen, så kan der komme en del optag med samme forløbsid. Det skyldes, at der kun er et CØSA-formål til FGU uddannelsen samt afsøgningsforløbet, og at der indberettes ved skift af speciale og skoleperiode. Der sendes først afbrud eller gennemført, når den unge forlader eller afslutter FGU helt.
Bemærk, at Ungedatabasen sletter et indberettet forløbsId, hvis det vurderes ikke at passe med de oplysninger, som Ungedatabasen ligger inde med. I så fald er det et nyt forløbsId, som vil blive returneret i valideringssvaret til datakilden.
Note 2: Status

Værdi

Betegnelse for status

Beskrivelse

1

Optaget

Den unge optages på et uddannelsesforløb. Hvis der er risiko for, at den unge afbryder uddannelsesforløbet, anvendes status Optaget også for denne indberetning.

2

Afbrudt

Den unge har afbrudt sit uddannelsesforløb.

3

Gennemført

Den unge har gennemført sit uddannelsesforløb.



Note 3: AfbrudsÅrsagskoder De værdier, der kan modtages i Ungedatabasen, er vist her viden.stil.dk. Det inkluderer koder, som kan være tilegnet andre uddannelsesområder.
Note 4: KlasseTrin og Elevtrin
07 = niveau 7
08 = niveau 8
09 = niveau 9
10 = niveau 10
11 = niveau 11
12 = niveau 12
Note 5: Klassetype
40 = Normalklasse, fuld årgangsdelt (samme koder ved indberetning til DS)
41 = Normalklasse, ikke fuldt årgangsdelt
45 = EUD 10 – Erhvervsrettet 10. klasses forløb
46 = 20/20 – Kombineret 10.klasse og erhvervsskole
50 = Specialklasse
55 = Klasse for ældre tosprogede elever
71 = Klasser for privatister/enkeltfagskursister
Note 6: Stadskoder for uddannelse aftalt med STADS

STADSkode

Uddannelsestype

Sendes til UDB

UU'ers vejledningsansvar ophører ved fuldførelse

1

Adgangskursus

Ja

Nej

2

Bachelor

Ja

Ja

3

Kandidat

Ja

Ja

4

p-bachelor

Ja

Ja

5

ph.d

Ja

Ja

6

Solist

Ja

Ja

7

Suppleringsfag

Ja

Nej

8

Udelt

Ja

Ja


Note 7: Etatkoder

Etatkode

Betegnelse

Er PKAT kode

Uddannelsesniveau

Kilde

249

Politikadet

Ja

F

Politi

303

Politibetjent

Ja

V

Politi

160

1 = Værnepligtig

Ja

F

Forsvar

161

2 = Konstabelelev

Ja

F

Forsvar

165

2 = Konstabelelev

Ja

F

Forsvar

267

4 = Officerselev

Ja

V

Forsvar

270

2 = Holdleder/beredskabsassistent

Ja

V

Forsvar

567

5= Militærnægter

Ja

F

Forsvar

660

1 = Værnepligtig

Ja

F

Forsvar

661

2 = Konstabelelev

Ja

F

Forsvar

662

2 = Konstabelelev

Ja

F

Forsvar

663

2 = Konstabelelev

Ja

F

Forsvar

664

3 = Sergentelev

Ja

F

Forsvar

665

2 = Konstabelelev

Ja

F

Forsvar



Uddannelse

Felt

Type

Krævet

Lovlige værdier

Beskrivelse

COSAFormaal

Integer(4)

Ja

Skal kunne genfindes i CØSA kodesættet (uddannelsesmodellen)

Kode for ungdomsuddannelse fra CØSA

COSAFormaalVersion

Integer(4)

Nej

Skal kunne genfindes i CØSA kodesættet (uddannelsesmodellen)

Kode for ungdomsuddannelse versioneret fra CØSA

COSAformaalSpeciale

String(4)

Nej

Skal kunne genfindes i CØSA kodesættet (uddannelsesmodellen)

Kode for ungdomsuddannelse (EUD) fra CØSA.
Koden angiver hvilket speciale, der følges indenfor uddannelsen.


UddannelsesinstitutionKontakt

UddannelsesinstitutionKontakt indeholder kontaktoplysninger for den relevante uddannelsesinstitution. Der vil kun forekomme oplysninger, når der er tale om risiko for frafald.

Felt

Type

Krævet

Lovlige værdier

Beskrivelse

Navn

String (500)

Nej


Kontaktpersonen på institutionen, hvis der indberettes risiko for frafald: navn på person

Telefon

Integer (10)

Nej


Kontaktpersonen på institutionen, hvis der indberettes risiko for frafald: telefon nummer på person

Email

String(50)

Nej


Kontaktpersonen på institutionen, hvis der indberettes risiko for frafald: e-mail på person

ElevKontakt

ElevKontakt indeholder kontaktoplysninger om den unge.

Felt

Type

Krævet

Lovlige værdier

Beskrivelse

Telefon

Integer (10)

Nej


Den unges telefonnummer

Email

String

Nej


Den unges mailadresse


PraktikSted

Praktiksted indeholder oplysninger om det praktiksted, som den unge er tilknyttet.

Felt

Type

Krævet

Lovlige værdier

Beskrivelse

PraktikCvrnr

Integer (10)

Nej


Praktikpladsens/ lærestedets CVR-nummer

PraktikLbrnr

Integer (20)

Nej


Praktikpladsens/ lærestedets løbenummer

PraktikNavn

String(50)

Nej


Praktikpladsens/ lærestedets navn

PraktikAdresse

String(50)

Nej


Praktikpladsens/ lærestedets adresse

PraktikPostnr

Integer(4)

Nej


Praktikpladsens/ lærestedets Postnr

PraktikBynavn

String(30)

Nej


Praktikpladsens/ lærestedets Nynavn/postdistrikt

PraktikTelefon

Integer (10)

Nej


Praktikpladsens/ lærestedets telefon

PraktikEmail

String(50)

Nej


Praktikpladsens/ lærestedets mailadresse

PraktikKontaktperson

String(50)

Nej


Praktikpladsens/ lærestedets kontaktperson identificeret ved navn


HaendelseBeskaeftigelsesForloeb

Information om beskæftigelse er et statusfelt med tre mulige værdier og kan ikke opfattes som en hændelse med en start- og slutdato.

Felt

Type

Krævet

Lovlige værdier

Beskrivelse

HaendelseNummer

String

Ja


Unik identifikation af indberetningen i UDB

HaendelseDato

DateTime

Ja

yyyy-mm-dd hh:mm_ss.sssssss

Dato, hvor hændelsen indtræffer. Fx dato for påbegyndelse på en arbejdsplads .

StatusBeskaeftigelse

Varchar (20)

Ja

Ikke beskæftiget = 0
Deltidsbeskæftiget = 1
Fuldtidsbeskæftiget = 2

Den unge kan være deltid, fuldtid, ikke beskæftiget.
Se vejledning til Ungedatabasen for nærmere beskrivelse.

KildeLeverandoer

Varchar (20)

Ja


Betegnelse eller kode, der identificerer kildeleverandøren.

Beskaeftigelsesgrad

Integer (3)

Ja


Angivelse af beskæftigelsesgraden for den unge.



HaendelseSocialYdelse

Felt

Type


Krævet

Lovlige værdier

Beskrivelse

HaendelseNummer

String


Ja


Unik identifikation af indberetningen i UDB

HaendelseDato

DateTime


Ja

yyyy-mm-dd hh:mm_ss.sssssss

Dato, hvor hændelsen indtræffer. Fx dato for påbegyndt modtagelses af sociale ydelser.

StatusSocialYdelse

Varchar (20)


Ja

Ikke forsøget= 0
Forsørget = 1

Forsørget, ikke forsørget

KildeLeverandoer

String(20)


Ja


Betegnelse eller kode, der identificerer kildeleverandøren.


KontaktJobOgUddannelsesOnsker


Felt

Type

Krævet

Lovlige værdier

Beskrivelse

KommuneInstitutionNummer

Integer (6)

Ja


Kommunens institutionsnummer

KommuneKontakt

XML element

Nej



JobOensker

XML element

Nej



UddannelsesOensker

XML element

Nej




KommuneKontakt

KommuneKontakt indeholder Kontaktoplysninger for den person ved kommunen, der har haft kontakt til den unge. De krævede felter er kun krævet, hvis elementet Kommunekontakt indgår i det aktuelle tilfælde.

Felt

Type

Krævet

Lovlige værdier

Beskrivelse

KontaktNavn

String(100)

Ja


Navnet på kontaktpersonen

KontaktMail

String(100)

Ja


Mailadresse skal være udfyldt

KontaktTelefon

Integer(10)

Nej



KontaktRegistreringstid

Datetime

Ja


Det tidspunkt oplysningerne er registreret i Kommunens systemer.



JobOnsker

JobOnsker indeholder en tekstuel beskrivelse af den unge's jobønsker. De krævede felter er kun krævet, hvis elementet Kommunekontakt indgår i det aktuelle tilfælde.

Felt

Type

Krævet

Lovlige værdier

Beskrivelse

JobOnsker

String(200)

Ja


Tekst hvor Kommunen kan beskrive den unges jobønsker.

JobRegistreringstid

Datetime

Ja


Tidspunkt hvor jobønskerne er registreret i Kommunes systemer.


UddannelsesOnsker

UddannelsesOnsker indeholder en tekstuel beskrivelse af den unge's ønsker til uddannelse. De krævede felter er kun krævet, hvis elementet Kommunekontakt indgår i det aktuelle tilfælde.

Felt

Type

Krævet

Lovlige værdier

Beskrivelse

UddannelsesOnsker

String(200)

Ja


Tekst hvor Kommunen kan beskrive den unges uddannelsesønsker.

UddannelseRegistreringstid

Datetime

Ja


Tidspunkt hvor uddannelsesønskerne er registreret i Kommunens systemer.

UddannelsesParathedsVurdering

UddannelsesParathedsVurdering indeholder data om de unges uddannelsesparathed fra enten 9. og/eller 10. klassetrin, hvis denne forefindes.

Felt

Type

Krævet

Værdier

Beskrivelse

CPR

String

Ja



Klassetrin

String

Ja



DatakildeInstitutionsNummer

Integer

Ja



FinalEducationReadinessAssessment

XML element

Nej




FinalEducationReadinessAssessment

Felt

Type

Krævet

Værdier

Beskrivelse

GYM

XML Element

Nej



HF

XML Element

Nej



EUD

XML Element

Nej



OTHER

String

Nej



LastAutomaticAssessmentDate

DateTime

Nej



LastManualAssessmentDate

DateTime

Nej




GYM

Felt

Type

Krævet

Værdier

Beskrivelse

Interested

XML Element

Nej



NotInterested

String

Nej

True/false



HF

Felt

Type

Krævet

Værdier

Beskrivelse

Interested

XML Element

Nej



NotInterested

String

Nej

True/false



EUD

Felt

Type

Krævet

Værdier

Beskrivelse

Interested

XML Element

Nej



NotInterested

String

Nej

True/false



Interested

Felt

Type

Krævet

Værdier

Beskrivelse

CurrentUPVResult

String

Nej



PersonalCompetenciesOk

String

Nej



PracticalCompetenciesOk

String

Nej



SocialCompetenciesOk

String

Nej



AcademicCompetenceOk

String

Nej



AcademicDanishCompetenceOk

String

Nej



AcademicMathCompetenceOk

String

Nej



LastAutomaticAssessment

XML Element

Nej



LastManuelAssessmentType

XML Element

Nej




LastAutomaticAssessment

Felt

Type

Krævet

Værdier

Beskrivelse

AssessmentDate

DateTime

Nej



Result

String

Nej



LastManualAssessment

Felt

Type

Krævet

Værdier

Beskrivelse

AssessmentDate

DateTime

Nej



Result

String

Nej




HaendelseUddannelsesPaalaeg

HaendelseUddannelsesPaalaeg indeholder data om den unge har et uddannelsespålæg. Hvis den unge har eller har haft et uddannelsespålæg, vises yderligere info om uddannelsespålægget ift. hvilket jobcenter der har givet uddannelsespålægget, og hvilket trin uddannelsespålægget starter med.

Felt

Type

Krævet

Lovlige værdier

Beskrivelse

UngHarUddannelsespaalaeg

Boolean

Ja

True, false


UddannelsespaalaegTrin

Integer

Nej

1-4

Information om det trin i uddannelsespålægget som den unge starter på

DatoUddannelsespaalaeg_start

DateTime

Nej



JobcenterNummer

Integer

Nej

10000-99999


JobcenterNavn

String

Nej

1-50


JobcenterTelefon

String(10)

Nej



InstitutionKontakt

XML-element

Nej


Kontaktoplysninger på institutionen omkring vejledning af unge.

JobcenterKontakt

XML-element

Nej


Kontaktoplysninger i jobcenteret omkring vejledning af unge.

JobcenterSpoergeskema

XML-element

Nej


Unges behov ved start på uddannelse vurderet at jobcenteret.


HaendelseUddannelsesPaalaeg sendes, når der er hændelser på den unge og derudover ved ændring i værdierne (f.eks. ændring i UngHarUddannelsespaalaeg eller ved opdateringer i felterne omkring jobcenter, InstitutionKontakt, JobcenterKontakt eller JobcenterSpoergeskema). HaendelseUddannelsesPaalaeg sendes altid ved forespørgsel på cpr.nr.

InstitutionKontakt

Kontaktoplysninger på uddannelsesinstitutionen i forbindelse med vejledning af den unge. Elementet vises kun når der er indhold.

Felt

Type

Krævet

Lovlige værdier

Beskrivelse

InstitutionNummer

Integer

Nej


Uddannelsens institutionsnummer.

KontaktPerson

String(250)

Nej


Navn på kontaktperson/gruppe

KontaktTelefon

String(20)

Nej


Telefonnummer på kontaktperson/gruppe

KontaktMail

String(64)

Nej


Mail adresse på kontaktperson/gruppe

SlutDato

DateTime

Nej


Dato hvor til kontaktoplysningerne ikke længe gælder fra.


JobcenterKontakt

Kontaktoplysninger til jobcenteret i forbindelse med vejledning af den unge. Elementet vises kun når der er indhold.

Felt

Type

Krævet

Lovlige værdier

Beskrivelse

KontaktPerson

String(250)

Nej


Navn på kontaktperson/gruppe

KontaktTelefon

String(20)

Nej


Telefonnummer på kontaktperson/gruppe

KontaktMail

String(64)

Nej


Mail adresse på kontaktperson/gruppe

SlutDato

DateTime

Nej


Dato hvor til kontaktoplysningerne ikke længe gælder fra.


JobcenterSpoergeskema

I jobcenteret er der udfyldt en række oplysninger, som skal tilgå uddannelsesinstitutionen, når den unge har fået et uddannelsespålæg. Disse oplysninger gives ligeledes til KUI, når betingelserne herfor at opfyldt.

Felt

Type

Krævet

Lovlige værdier

Beskrivelse

Behov

XML Element

Ja


Overordnet overblik over den unges behov ved start på uddannelse.

StoettePerson

XML Element

Ja


Oplysning om hvorvidt der findes en kontakt-/støtteperson i jobcenteret. Kan for eksempel være en mentor.

KontaktOensket

XML Element

Ja


Angivelse af om jobcenteret ønsker Uddannelsesinstitutionen kontakter dem om den unges start på uddannelsen.

JobcenterTest

XML Element

Ja


Oplysninger om hvorvidt der er foretaget test af den unge i jobcenteret. For eksempel læse eller regne test.


Behov

Oversigt over den unges behov ved uddannelsesstart vurderet af jobcenteret.

Felt

Type

Krævet

Lovlige værdier

Beskrivelse

FagligStoettebehov

XML Element

Ja


Den unges faglige støttebehov.

SocialtStoettebehov

XML Element

Ja


Den unges sociale støttebehov.

DokumenteretStoettebehov

XML Element

Ja


Angivelse af om der findes dokumentation i jobcenteret for den unges støttebehov.

IngenStoettebehov

XML Element

Ja


Angivelse af om den unge ingen støttebehov har.


h7.FagligStoettebehov
Faglige støttebehov vurderet af jobcenteret.

Felt

Type

Krævet

Lovlige værdier

Beskrivelse

SpoergsmaalsTekst

String (500)


Ja

Aftalt med STAR. Se tekst i beskrivelse.

Jobcenteret vurderer, at der er brug for faglig støtte under uddannelsen

SpoergsmaalsSvar

Integer (2)

Ja

1: Ja
2: Nej
3: Ingen data




h7.SocialtStoettebehov
Sociale støttebehov vurderet af jobcenteret.

Felt

Type

Krævet

Lovlige værdier

Beskrivelse

SpoergsmaalsTekst

String (500)


Ja

Aftalt med STAR. Se tekst i beskrivelse.

Jobcenteret vurderer, at der er brug for støtte til sociale, personlige eller helbredsmæssige udfordringer under uddannelsen

SpoergsmaalsSvar

Integer (2)

Ja

1: Ja
2: Nej
3: Ingen data




h7.DokumenteretStoettebehov
Findes der dokumentation for den unges støttebehov.

Felt

Type

Krævet

Lovlige værdier

Beskrivelse

SpoergsmaalsTekst

String (500)

Ja

Aftalt med STAR. Se tekst i beskrivelse.

Jobcenteret har dokumentation for ét eller flere støttebehov

SpoergsmaalsSvar

Integer (2)

Ja

1: Ja
2: Nej
3: Ingen data




h7.IngenStoettebehov
Har jobcenteret vurderet at der ingen støttebehov er.

Felt

Type

Krævet

Lovlige værdier

Beskrivelse

SpoergsmaalsTekst

String (500)


Ja

Aftalt med STAR. Se tekst i beskrivelse.

Jobcenteret vurderer, at der ikke umiddelbart er et støttebehov i forhold til at klare sig igennem uddannelsen

SpoergsmaalsSvar

Integer (2)

Ja

1: Ja
2: Nej
3: Ingen data




StoettePerson


Findes der en person i jobcenteret, som har en særlig tilknytning til den unges overgang til uddannelse.

Felt

Type

Krævet

Lovlige værdier

Beskrivelse

SpoergsmaalsTekst

String (500)


Ja

Aftalt med STAR. Se tekst i beskrivelse.

Der er tilknyttet en mentor og/eller en anden støtteperson i overgangen til uddannelse

SpoergsmaalsSvar

Boolean

Ja

True/False


StoettepersonSlutDato

DateTime

Nej




KontaktOensket


Ønsker jobcenteret at blive kontaktet af uddannelsesinstitutionen omkring den unges start på uddannelsen.

Felt

Type

Krævet

Lovlige værdier

Beskrivelse

SpoergsmaalsTekst

String (500)


Ja

Aftalt med STAR. Se tekst i beskrivelse.

Jobcenteret vil gerne kontaktes af uddannelsesinstitutionen mhp. konkret dialog om vedkommendes start på uddannelsen

SpoergsmaalsSvar

Boolean

Ja

True/False



JobCenterTest


Er der foretaget en læse-, skrive- og regnetest i jobcenteret

Felt

Type

Krævet

Lovlige værdier

Beskrivelse

SpoergsmaalsTekst

String (500)


Ja

Aftalt med STAR. Se tekst i beskrivelse.

Der foreligger læse-, skrive- og regnetest

SpoergsmaalsSvar

Boolean

Ja

True/False


JobcenterTestDato

DateTime

Nej


Dato hvor testen er foretaget.


Fejlkoder

Der sendes ikke valideringssvar med advis til kommunen, men kun fejlkoder, som returneres direkte i svaret på forespørgslen fra kommunen.
Herunder er de mulige fejlkoder vist.

Fejlkoder ved afvist underretning

Fejlnr.

Fejltekst

Forklaring

Blød fejl: BHård fejl: H

14

Den unge findes ikke i Ungedatabasen

CPR-nr kan ikke genfindes i Ungedatabasen i relation til en aktiv ung bosiddende i Danmark

H

15

Aldersgrænse overskredet

Aldersgrænse overskredet.  Den unges skal være fyldt 15 år og under 30 år.

H

55

Ingen hændelser eller manglende tilladelse

CPR-nummer, som er efterspurgt, findes ikke i Ungedatabasen, eller må ikke udleveres til den spørgende part.

H

69

Det efterspurgte hændelsesnummer og/eller CPR-nummer findes ikke i Ungedatabasen

Det efterspurgte hændelsesnummer findes ikke i Ungedatabasen

H

101

exeption – UDB

Intern fejl i UDB

H


Det bemærkes, at formattjek foretages i integrationsplatformen og kan resultere i fejl 400.
Hårde fejl angives med numre op til 199.
Bløde fejl angives med numre fra 200.

Endpoints til testmiljø

Endpoints til testmiljø kan findes her: https://viden.stil.dk/display/OFFintegrationsplatformen/Services
Webservicens ligger under System Ungedatabasen og har navnet HaendelserTilKommunen version 3.