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 | AfsluttetUddannelsesNiveau logik ændret. |
3.2 | 5.2.3 | Værdien OPT_RISK_FRA er fjernet fra ForloebStatus. |
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. | |
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. | Markering af, om der findes flere hændelser end dem, der er returneret i aktuelt servicesvar. |
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: | Statusfelt, der oplyser, hvilket højeste uddannelsesniveau den unge har afsluttet. |
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. |
ForloebStatus | String | Ja | OPTAFB | OPT- Optaget |
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 | 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 | 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. |
Registreringstid | DateTime | Ja | Tidspunktet for registreringen af ændringen i kildesystemet. | |
FrafaldstruetMarkering | Boolean | Nej | True = Frafaldstruet | Markering for registrering af risiko for frafald. |
UddannelsesinstitutionKontakt | XML element | Nej | ||
ElevKontakt | XML element | Nej | ||
Uddannelsesinstitution | XML element | Nej | Skal kunne genfindes i institutionsregisteret | Afdeling, hvor undervisningen eller aktiviteten administreres. |
FrafaldstruetIfoelgeKommunen | Boolean | Nej | True = Frafaldstruet | |
AfbrudIfoelgekommunen | Boolean | Nej | True = 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 | 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 |
| 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. |
COSAFormaalVersion | Integer (4) | Nej | Skal kunne genfindes i CØSA kodesættet (uddannelsesmodellen). | Kode for ungdomsuddannelse versioneret fra CØSA |
COSAformaalSpeciale | String | Nej | Skal kunne genfindes i CØSA kodesættet (uddannelsesmodellen). | Kode for ungdomsuddannelse (EUD) fra CØSA. |
Hovedforloeb | Integer | Ja | 1 = Grundforlø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: | 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, | Ja | F | Forsvar |
161, | Konstabelelev | 161, | 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 | |
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 | |
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 | |
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.