Dato
17-09-2022
Versions Status
3.2 Gældende fra og med den XX. januar XXXX 2023  (version 3.0 af webservice)
Ansvarlig
Jørgen Bloch Vejbæk


Ændringshistorik


Version

Kapitel/afsnit

Beskrivelse

1.1

Dokumentet.

Tilføjet nye felter pga. FGU

2.1


Tilrettelser efter review i forhold til xsd

2.2

5.1

SenesteRegistrering returnerer ikke hændelser inklusiv det angivne tidsstempel (dato)

3.0

Hele dokumentet

Tilpasset Integrationsplatformen IPL

3.1

5.2.2

5.2.3
5.2.4

AfsluttetUddannelsesNiveau logik ændret.
ForloebStatus tilføjet. UddannelsesNiveau tilføjet.

3.2

5.2.3

5.2.4

Værdien OPT_RISK_FRA er fjernet fra ForloebStatus.
SIS erstattet med ESAS for aktivitetsgruppekoderne.


Indhold
1 Indledning
2 Hvem kan hente data?
3 Hvilke unge skal underretningen omfatte?
4 Hvilke oplysninger underrettes der om?
5 HændelserForSTAR
5.1 Struktur HentRequest
5.1.1 Hent
5.2 Struktur HentResponse
5.2.1 HentSvar
5.2.2 HaendelserUng
5.2.3 HaendelseUddannelsesForloeb
5.2.4 UddannelseSTAR
5.2.5 UddannelsesinstitutionKontakt
5.2.6 ElevKontakt
5.2.7 Uddannelsesinstitution
6 Fejl i skemavalidering
7 Endpoint til testmiljø

Indledning

Beskæftigelsesministeriet skal ifølge kontanthjælpsreformen sikre, at unge under 30 år uden uddannelse får uddannelseshjælp i stedet for kontanthjælp.
Til dette formål har uddannelsesinstitutioner pligt til at indberette oplysninger om unges uddannelse til Ungedatabasen (UDB), som drives af Styrelsen for It og Læring (STIL).
UDB videresender oplysningerne til jobcentre via Styrelsen for Arbejdsmarked og Rekruttering (STAR), jf. Beskæftigelsesministeriets lovgivning. Bekendtgørelse om det fælles it-baserede datagrundlag og det statistiske datavarehus på beskæftigelsesområdet
Dette dokument beskriver, hvorledes STAR's system DFDG, kan hente hændelser på unge, som er registreret med en uddannelsesaktivitet i Ungedatabasen.
UDB er udviklet til, at der skal ske en system til system-udveksling via STIL's integrationsplatform (IPL). Yderligere oplysninger om tilslutning og tekniske detaljer kan findes på STIL's supportsite for Integrationsplatformen via https://viden.stil.dk/x/BgBwBg.

Hvem kan hente data?

STAR's fælles datagrundlag DFDG kan hente data fra UDB. Det sker med henblik på distribution til jobcentrene.

Hvilke unge skal underretningen omfatte?

Underretningen vil omfatte hændelser for alle unge, som er registreret i Ungedatabasen med et uddannelsespålæg og en uddannelsesaktivitet. Uddannelsesaktiviteten omfatter forberedende uddannelser, ungdomsuddannelser og videregående uddannelser.
Underretningen vil inkludere alle hændelser på unge, som optages, afbryder, er i risiko for at afbryde en uddannelse eller gennemfører nogle forberedende uddannelser samt alle ungdomsuddannelse og videregående uddannelse.
Forberedende uddannelse at blandt andet typerne VUC enkeltfag og FGU uddannelse. Det er CØSA-formål, som angiver den enkelte uddannelsesaktivitet for disse typer. Yderligere kan de forberedende uddannelser være af typen forberedende uddannelser, som har sit eget kodesæt. De CØSA-formål og forberedende uddannelser, der modtages indberetninger om, er listet på STIL's hjemmeside under Ungedatabasen. For eksempel har STU følgende koder: Forberedende aktivitets 2201, CØSA-formål 1061, hvor der i praksis ind til videre kun er kommet data på 2201.
Ungdomsuddannelserne er STX, HHX, HTX, EUD, EUX og andre ungdomsuddannelser som fx maritime ungdomsuddannelser. Det er CØSA-formål, som angiver den enkelte uddannelsesaktivitet.
De videregående uddannelser benytter sig af forskellige andre kodesæt til indberetning af uddannelsesaktiviteten. Disse kodesæt er tilgængelige på STIL's hjemmeside. Hændelser vedrørende videregående uddannelser indberettes fra de studieadministrative systemer kaldet SIS og STADS samt Politiets og Forsvarets systemer.
Uddannelsesaktiviteterne omfatter forløb, som har en varighed på mindst 6 uger. Der indberettes ikke om eksamenstilmeldte, som ikke er tilmeldt undervisning, mens der skal indberettes for selvstuderende, som er tilmeldt undervisning.
Hvis uddannelsesinstitutionen har afdelinger, er det som udgangspunkt den relevante institutionsafdeling, som forestår indberetningen. Institutionsafdelingen er oprettet i UVM's institutionsregister. Hvis institutionen kun har et hovednummer (den juridiske institution), foretages indberetningen via dette hovednummer.

Hvilke oplysninger underrettes der om?

Underretningen omfatter ændringer i den unges uddannelse:

  • 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 grundforløbet, og 2. del af grundforløbet (der også fortsættes med i hovedforløbet). I FGU-uddannelsen sendes nye optag ved tilføjelse eller skift i skoleperiode samt speciale. Der kan således komme en del optag på samme uddannelsesforløb. I et bilag sidst i dette dokument ses hvilke skoleperioder, som kan følges i de 3 spor/specialer (AGU, PGU og EGU).
  • Afbrud af en uddannelse
  • Gennemførelse af et uddannelsesforløb


I de tilfælde, hvor der er tale om risiko for frafald, inddrages UU direkte på initiativ af 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.
Underretningen vil blandt andet indeholde følgende oplysninger:

  • Personidentifikation
    • CPR-nummer
  • Uddannelseskoder
    • Uddannelseskode (ofte CØSA-formål)
    • Uddannelsesversion (ved CØSA-formål)
    • Evt. specialekode
  • Institutions nummer

HændelserForSTAR

Denne webservice udstilles på integrationsplatformen. Servicen anvendes af STAR ved afhentning af hændelser for unge med et aktivt uddannelsespålæg. Generelt afgrænses de udstillede hændelser, så de kun omfatter forberedende aktiviteter, ungdomsuddannelser og videregående uddannelser. Dvs. der kommer ingen data fra grundskoler og SKAT.
Det er muligt at afgrænse forespørgslen, så der kun modtages ændringer set i forhold til de hændelser, der allerede er leveret.

Struktur HentRequest

Den overordnede struktur i xml'en fremgår af nedenstående figur.


 



 Figur 1 XML struktur for afhentning af hændelser

Hent

Felt

Type

Krævet

Lovlige værdier

Beskrivelse

SenesteRegistrering

DateTime

Nej


Datoen, hvor STAR senest hentede hændelser.
Når der er skrevet en dato i feltet, returneres alle hændelser fra og med den angivne dato (også tidligere sendte).
Når feltet efterlades blankt returneres alle hændelser, der ikke tidligere er sendt til STAR.

InstitutionNummer

String

Ja


STARs institutionsnummer (markering af hvem der sender data ind)


Struktur HentResponse

Generelt returneres maksimalt 99 hændelser. Disse kan være fordelt på et varierende antal unge, så der er ikke en bestemt afgræsning i xsd'en.
Hvis der spørges på HaendelseNummer, og der identificeres mere end 99 hændelser returneres de 99 med det laveste hændelsesnummer. Samtidigt returneres en markering for, at ikke alle hændelser er returneret. Derefter kan dataaftagerne spørge med det højeste hændelsesnummer i det svar, der modtages.

 
Figur 2 XML struktur for svar ved afhentning af hændelser


HentSvar

HentSvar indeholder oplysning om, hvorvidt der er flere hændelser, der opfylder søgekriteriet, samt det højeste hændelsesnummer, der er returneret i svaret.

Felt

Type

Krævet

Lovlige værdier

Beskrivelse

FindesFlereHaendelser

Boolean

Ja

True = Ja der findes flere hændelser og brugeren bør sørge 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 aktuelt servicesvar.
Anvendes, når der er forespurgt på "siden sidst" udtræk på hændelser, hvor der er identificeret flere end 99.
Når brugeren modtager besked om, at der findes flere hændelser, er det hensigten, at de spørger igen på de resterende hændelser.

SenesteRegistrering

DateTime

Nej



HaendelserUng

XML element

Nej




HaendelserUng

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

Felt

Type

Krævet

Lovlige værdier

Beskrivelse

CPRNr

String (10)

Ja

Skal kunne findes i CPR-registeret

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

AfsluttetUddannelsesNiveau

String (100)

Nej

Mulige værdier:
N (Ingen afsluttet uddannelse)

K (kompetencegivende uddannelse)

E (Erhvervskompetencegivende uddannelse)

Statusfelt, der oplyser, hvilket højeste uddannelsesniveau den unge har afsluttet.


Hvis der ikke er afsluttet en uddannelse der svarer til mindst en kompetencegivende uddannelse eller en Erhvervskompetencegivende uddannelse så returneres N (Ingen afsluttet uddannelse).

HaendelseUddannelsesForloeb

XML element

Nej




HaendelseUddannelsesForloeb

Svaret indeholder hændelser vedrørende forberedende aktiviteter, ungdomsuddannelser og videregående uddannelser.

Felt

Type

Krævet

Lovlige værdier

Beskrivelse

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 uddannelsekode.

ForloebStatus

String

Ja

OPTAFB
GEN
ANN
Se også beskrivelse.

OPT- Optaget
AFB - Afbrudt
GEN- Gennemført
(OPT_RISK_FRA - Optaget med risiko for frafald)
ANN- Annulleret

OPT_RISK_FRA svarer til OPT, der er blot modtaget et flag om fare for frafald. OPT_RISK_FRA benyttes ikke i praksis.

Ved Annullering sendes der ikke historik, men kun hændelse, som er annulleret.

HaendelseDato

Date

Ja


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

Se note 3

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

Annullering

Boolean

Nej

False = nej
True = ja

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

KildeLeverandoer

String (20)

Ja


Betegnelse eller kode, der identificerer kildeleverandøren

UddannelseStar

XML element

Nej



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 og derved har gennemført en ungdomsuddannelse.
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


Tidspunktet for registreringen af ændringen i kildesystemet.

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



Uddannelsesinstitution

XML element

Nej

Skal kunne genfindes i institutionsregisteret

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

FrafaldstruetIfoelgeKommunen

Boolean

Nej

True = Frafaldstruet
False = Ikke frafaldstruet


AfbrudIfoelgekommunen

Boolean

Nej

True = Afbrudt
False = Ikke Afbrudt


Skoleperiode

String

Nej

Skal findes i uddannelsesmodellen.

Betegnelse for periode i uddannelsesforløbet (kun udfyldt for FGU uddannelsen som har CØSA-formål 338).

EguUddannelsesbevis

Boolean

Nej

True = Har fået et uddannelsesbevis på EGU-spor
False = Har ikke fået et uddannelsesbevis på EGU-spor

Sand, hvis den unge har afsluttet FGU-uddannelsen på sporet EGU, og har fået et uddannelsesbevis på det.


Note 1: ForløbId
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. (Der skal ikke 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øbsId til datakilden. ForløbId'et tælles op til en højere værdi.
Bemærk, at Ungedatabasen sletter et indberettet forløbId, hvis det vurderes ikke at passer med de oplysninger, som Ungedatabasen ligger inde med og sætter et nyt forløbid på hændelsen. I så fald er det et nyt forløbId, 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, kan ses her https://viden.stil.dk/ i det vedhæftede dokument. Det inkluderer koder, som kan være tilegnet andre uddannelsesområder.

UddannelseSTAR


Felt

Type

Krævet

Lovlige værdier

Beskrivelse

Kodesaet

String(30)

Ja

  • AktivitetsgruppeKode
  • StadsKode
  • Etatkode
  • Cosa
  • Forberedende

Kode for hvilket kodesæt der anvendes for uddannelsen

UddannelseKode

String

Ja

Se note 4

Kode for uddannelsen ifølge det angivne kodesæt

UddannelseBetegnelse

String

Ja

Skal kunne genfindes i CØSA kodesættet (uddannelsesmodellen), hvis det er CØSA-formåls kodesættet koden er fra.

Tekstuel betegnelse for uddannelsen.
Kan indeholde betegnelser fra forskellige kodesæt: CØSA-formål (Lectio, Ludus, EASY), STADS, Aktivitetsgruppe koder (SIS), Politiet og Forsvaret.

COSAFormaalVersion

Integer (4)

Nej

Skal kunne genfindes i CØSA kodesættet (uddannelsesmodellen).
Udfyldes kun ved kodesæt = Cosa

Kode for ungdomsuddannelse versioneret fra CØSA

COSAformaalSpeciale

String

Nej

Skal kunne genfindes i CØSA kodesættet (uddannelsesmodellen).
Udfyldes kun ved kodesæt = Cosa

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

Hovedforloeb

Integer

Ja

1 = Grundforløb
2 = Hovedforløb

Niveauet angiver om uddannelsen er hoved- eller grundforløb på en erhvervsuddannelse. For alle andre uddannelser end erhvervsuddannelserne, sidestilles disse med erhvervsskolernes hovedforløb.

UddannelsesNiveau

String (100)

Ja

Mulige værdier:
N (Ingen afsluttet uddannelse)

K (kompetencegivende uddannelse)

E (Erhvervskompetencegivende uddannelse)

Statusfelt der oplyser hvilket uddannelsesniveau den aktuelle uddannelse har i denne hændelse.



Note 4
Aktivitetsgruppe koder for uddannelser aftalt med UFMSSIS
ESASSIS er et uddannelsesadministrativt system til korte og mellemlange videregående uddannelser. AktivitetsgruppeSIS-koderne hentes fra UFM's liste over koder. Ungedatabasen udstiller kodesættet på https://viden.stil.dk/.
Stadskoder for uddannelse aftalt med STADS

STADSkode

Uddannelsestype

Sendes til UDB

UU'ers vejledningsansvar ophører ved fuldførelse

Erhvervskompetencegivende uddannelse

1

Adgangskursus

Ja

Nej

Nej

2

Bachelor

Ja

Ja

Ja

3

Kandidat

Ja

Ja

Ja

4

p-bachelor

Ja

Ja

Ja

5

ph.d

Ja

Ja

Ja

6

Solist

Ja

Ja

Ja

7

Suppleringsfag

Ja

Nej

Nej

8

Udelt

Ja

Ja

Ja



Etatkoder

Etatkode

Betegnelse

PKAT kode

Er PKAT kode

Uddannelsesniveau

Kilde

249

Politikadet

249

Ja

F

Politi

303

Politibetjent

303

Ja

V

Politi

160

Værnepligtig

160,
660

Ja

F

Forsvar

161,
165,
661,
662,
665

Konstabelelev

161,
165,
661,
662,
665

Ja

F

Forsvar

267

Officerselev

267

Ja

V

Forsvar

567

Militærnægter

567

Ja

F

Forsvar

664

Sergentelev

664

Ja

F

Forsvar

270

Holdleder/Beredskabassistent

270

Ja

V

Forsvar


CØSA-formålskoder
CØSA-formål anvendes til ungdomsuddannelserne.
Kodesættes vedligeholdes af STIL. Ungedatabasen udstiller kodesættet på https://viden.stil.dk/

UddannelsesinstitutionKontakt

Ved indberetning af risiko for frafald indeholder UddannelsesinstitutionKontakt kontaktoplysninger om den relevante uddannelsesinstitution.

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

String(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

String

Nej


Den unges telefonnummer

Mail

String

Nej


Den unges mailadresse


Uddannelsesinstitution

Institution indeholder oplysninger om det institutionen, som den unge er tilknyttet.

Felt

Type

Krævet

Lovlige værdier

Beskrivelse

Hovedinstitutionnummer

Decimal

Nej

Skal kunne genfindes i institutionsregisteret

Kode for hovedskole (institution med enheder) ifølge institutionsregisteret

InstitutionCVRnummer

Decimal

Nej


Hovedafdelingens CVR-nummer (note 5)

InstitutionPnummer

Decimal

Nej


Produktionsenhedsnummer for DS-afdelingen hvor den unge undervises ifølge Institutionsregisteret (note 5)

InstitutionBetegnelse

String(128)

Nej


Uddannelsesstedets betegnelse
(Fra Institutionsregisteret)

Institutionnummer

Decimal

Ja


Uddannelsesstedets institutionsnummer ifølge institutionsregisteret

InstitutionsAdresse

String(128)

Nej


Vejnavn og nummer på institutionens adresse (Fra Institutionsregisteret)

Institutionpostnummer

Decimal

Nej


Postnummer på institutionens adresse (Fra Institutionsregisteret)

Institutionsstednavn

String(34)

Nej


Stednavn på institutionens adresse (Fra Institutionsregisteret)


Note 5:
Ved hændelser fra forsvaret, anvendes p-nummer og CVR-nummer fra Forsvarets Center for Digital Forvaltning og Uddannelse (Institutionsnummer 181403).
Ved hændelser fra Politiet anvendes institutionsnummer 153404.

Fejl i skemavalidering

STAR skal bemærke at der også kan komme formatfejl fra IPL (integrationsplatformen).
Spørges der med parameteren SenesteRegistrering, kan der komme fejl pga. formatet ikke er overholdt.

Bilag
Oversigt over kombinationen af mulige specialer i FGU uddannelsen, og tilhørende skoleperioder. Uddannelsen starter med et afsøgningsforløb.

Spor(speciale)

Betegnelse

1

AGU - Almen grunduddannelse

2

PGU - Produktionsgrunduddannelsen

3

EGU - Erhvervsgrunduddannelse



Spor(speciale)

Betegnelse

Skole-periode

Betegnelse knyttet til kombination af CØSA-formål, version, speciale og skoleperiode

Spor(speciale)

Betegnelse

Skole-periode

Betegnelse knyttet til kombination af CØSA-formål, version, speciale og skoleperiode



AF

Afsøgningsforløb Afsøgningsforløbet indberettes ikke til Ungedatabasen pr. 15. oktober 2021. Der kan fortsat modtages historiske hændelser om AF.



BA

Basisforløb, uddannelsesspor ikke valgt



SB

Supplerende basisforløb, uddannelsesspor ej valgt

1

Almen grunduddannelse

BA

Basisforløb, uddannelsesspor valgt

1

Almen grunduddannelse

SB

Supplerende basisforløb, uddannelsesspor valgt

1

Almen grunduddannelse

US

Uddannelsesspor

1

Almen grunduddannelse

FS

Forlængelse af uddannelsesspor

1

Almen grunduddannelse

ÅP

Årselevpulje

1

Almen grunduddannelse

KF

Kommuneforlængelse

2

Produktionsgrunduddannelse

BA

Basisforløb, uddannelsesspor valgt

2

Produktionsgrunduddannelse

SB

Supplerende basisforløb, uddannelsesspor valgt

2

Produktionsgrunduddannelse

US

Uddannelsesspor

2

Produktionsgrunduddannelse

FS

Forlængelse af uddannelsesspor

2

Produktionsgrunduddannelse

ÅP

Årselevpulje

2

Produktionsgrunduddannelse

KF

Kommuneforlængelse

3

Erhvervsgrunduddannelse

BA

Basisforløb, uddannelsesspor valgt

3

Erhvervsgrunduddannelse

SB

Supplerende basisforløb, uddannelsesspor valgt

3

Erhvervsgrunduddannelse

US

Uddannelsesspor

3

Erhvervsgrunduddannelse

FS

Forlængelse af uddannelsesspor

3

Erhvervsgrunduddannelse

ÅP

Årselevpulje

3

Erhvervsgrunduddannelse

KF

Kommuneforlængelse


Endpoint til testmiljø

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