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 | Parameteren InstitutionsNummer er fjernet fra forespørgslen (request). Informationen hentes fra brugernavnet i stedet. |
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. |
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. | |
CPRNr | String (10) | Nej | Skal kunne findes i CPR-registeret med adresse i Danmark | Her fremsøges hændelser når: |
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. | Markering af om der findes flere hændelser end dem, der er returneret i det aktuelle svar. |
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, | Statusfelt, der oplyser hvilket højeste uddannelsesniveau den unge har afsluttet. |
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. | |
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. |
InstitutionNummer | Integer(6) | Ja | Skal kunne genfindes i institutionsregisteret | Afdelingen, hvor undervisningen eller aktiviteten administreres. |
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). |
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. | |
Annullering | Boolean | Nej | False = nej | Markering af, at en tidligere indberetning med samme indhold skal annulleres (fejl-indberetning). |
Uddannelse | XML element | Nej | ||
Aktivitetsgruppekode | Integer(4) | Nej | 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 | Se note 6 | Kode for uddannelsesaktivitet på mellemlange og lange videregående uddannelser, som anvender det studieadministrative system STADS. |
Etatkode | Integer (10) | Nej | Se note 7 | Etat kode på 3 karakterer. Feltet anvendes til uddannelser indenfor politi og forsvar. |
GennemfoertHf | Boolean | Nej | False= nej | Sættes til 'Sand', når en ung samlet set har opnået et HF bevis baseret på enkeltfag. |
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 | Markering for registrering af risiko for frafald. |
UddannelsesinstitutionKontakt | XML element | Nej | ||
ElevKontakt | XML element | Nej | ||
PraktikSted | XML element | Nej | ||
JobcenterAktivitetType | String (1) | Nej | U = Uddannelsesaktivitet | 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 | 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. |
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 | |
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 | |
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 | Den unge kan være deltid, fuldtid, ikke beskæftiget. |
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, 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) |
| 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 |
h7.SocialtStoettebehov
Sociale støttebehov vurderet af jobcenteret.
Felt | Type | Krævet | Lovlige værdier | Beskrivelse |
|---|---|---|---|---|
SpoergsmaalsTekst | String (500) |
| 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 |
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 |
h7.IngenStoettebehov
Har jobcenteret vurderet at der ingen støttebehov er.
Felt | Type | Krævet | Lovlige værdier | Beskrivelse |
SpoergsmaalsTekst | String (500) |
| 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 |
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) |
| 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) |
| 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) |
| 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.