Grænseflade til indberetning af hændelser fra forberedende aktiviteter til Ungedatabasen | |
Dato: | |
Version | Status |
2 | Gældende fra den 1. januar 2022 |
Ansvarlig |
Ændringshistorik
Version | Gældende fra | Kapitel/afsnit | Beskrivelse |
1.0 | 9/6/17 | ||
1.1 | 9/6/17 | Kapitel 6 | Tilføjelse af Modtager XML felt. |
1.2 | 9/6/17 | Forsiden, 6.2 og kapitel 7 | Datoen for, hvornår beskrivelsen er gældende er ændret. |
1.3 | 30/8/18 | Kap. 7.1 | Beskrivelse af parameter SidstHentet er ændret. |
1.4 | 8/1/19 | Kap. 6.2 | 12. klassetrin kan indberettes. |
1.5 | 14/11/19 | Kap. 6.2 | Risiko for frafald ifølge UU (KUI) og afbrud ifølge UU (KUI) skal indberettes som optag. For sidstnævnte skal der derfor ikke angives afbrudsårsag. |
1.6 | 12/2/20 | Kap. 1 | UU erstattet af KUI. |
1.7 | 22/3/21 | Kap. 7 | Beskrivelse af valideringssvar flyttes til en selvstændig grænsefladebeskrivelse. |
2 | 21/10/21 | Hele dokumentet | Tilpasset Integrationsplatformen IPL. |
Indhold
1 Indledning
2 Hvem skal indberette?
3 Hvilke personer skal indberetningen omfatte?
4 Hvornår skal der indberettes?
5 Hvilke oplysninger skal indberettes?
6 WS ForberedendeForløb
6.1 Struktur for IndberetningRequest
6.1.1 IPLIndberetningRequest
6.2 Struktur for IndberetningResponse
6.2.1 IndberetningResponse
7 WS ValideringsSvarOgAdvis
7.1 Fejlkoder
7.1.1 Fejlkoder i forbindelse med validering
7.1.2 Fejlkoder i forbindelse med behandling af indberetningen
8 Endpoints til testmiljø
Indledning
Ifølge Vejledningsloven skal den kommunale ungeindsats (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 KUI og jobcentre via Styrelsen for Arbejdsmarked og Rekruttering (STAR). Derudover anvender STIL oplysningerne til statistiske formål.
Indberetninger til UDB sker fra institutionernes studieadministrative systemer via webservices udstillet på STIL's integrationsplatform. Platformen formidler også svar fra UDB vedrørende indberetningerne til de studieadministrative systemer. Det betyder, at de studieadministrative systemer skal have funktioner, som understøtter denne dataudveksling. Såfremt institutionen skifter administrativt system eller fusionerer, skal dette meddeles til STIL.
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 uddannelsesinstitutionerne og KUI skal indberette til UDB og som de kan afhente af valideringsvar.
Hvem skal indberette?
Uddannelsesinstitutioner, som varetager undervisning, der betegnes som en forberedende aktivitet skal indberette, dvs. 10.-12. skoleår, EUD 10, 20-20 ordning, forløb på daghøjskole, højskole, produktionsskole, frie fagskoler, danskuddannelse samt aktiviteter aftalt med KUI-center Listen over uddannelsesforløb findes i den tilhørende vejledning (se viden.stil.dk)..
Indberetning af enkelte forberedende forløb kan undtagelsesvis også modtages i grænsefladen for grundskoleforløb. Dette gælder 10.-12. skoleår.
Desuden kan indberetning af EUD10 og 20-20 ordning ved overgang til EUD undtagelsesvis også modtages i grænsefladen for ungdomsuddannelser, såfremt der benyttes CØSA-formål til at angive uddannelsesaktiviteten.
Skulle institutionen have afdelinger, så er det den relevante institutionsafdeling, hvor den unge modtager undervisning, som skal forestå indberetningen via institutionsnummeret. Institutionsafdelingen skal være oprettet i Undervisningsministeriets Institutionsregister. Hvis institutionen kun har et hovednummer (den juridiske institution), skal indberetningen foretages via dette hovednummer.
Hvilke personer skal indberetningen omfatte?
Vejledningsloven omhandler alle unge fra 15 til og med 29 år, og det er således uddannelsesinstitutionernes pligt at indberette om ændringer i disse unges uddannelsesforløb.
Indberetningerne skal vedrøre forløb, som har en varighed på mindst 3 måneder. Det betyder, at uddannelsesinstitutionen ikke skal indberette for fx brobygningselever (9-10. klasse elever i et kortvarigt brobygningsforløb på fx et gymnasium) eller for eksamenstilmeldte, som ikke er tilmeldt undervisning. Derimod skal uddannelsesinstitutionen indberette for selvstuderende, som er tilmeldt undervisning.
Hvornår skal der indberettes?
Der skal ske indberetning, når der er en ændring i den unges uddannelsesforløb. Dvs., når den unge bliver optaget, er i risiko for frafald, afbryder eller gennemfører aktiviteten. Disse ændringer betragtes som hændelser, der skal indberettes til UDB.
Indberetningerne skal foretages dagligt og uden unødig forsinkelse.
Ved optagelse ønskes hændelsen dog tidligst indberettet 3 måneder før påbegyndelse af uddannelsesforløb, såfremt kildeleverandøren har mulighed for at justere afsendelsen af indberetningen.
Hvilke oplysninger skal indberettes?
Indberetningen omfatter ændring i den unges uddannelsesforløb hos institutionen. Det gælder:
- Optagelse på en forberedende aktivitet (fx 10. klasse eller et forløb på en produktionsskole, forudsat den unge er fyldt 15 år).
- Afbrud af den forberedende aktivitet
- Gennemførelse af det forberedende aktivitetsforløb
- I de tilfælde, hvor der er tale om risiko for frafald, inddrages KUI direkte på initiativ af uddannelsesinstitutionen. Der angives 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 fortsat er Optaget.
Indberetningen skal blandt andet indeholde følgende oplysninger:
- Personidentifikation
- CPR-nummer
- Uddannelseskoder (forberedende aktivitetskode) eller oplysning om klassetrin
- Institutionsnummer
Bemærk, at det er væsentligt, at hændelserne sendes fra den enkelte institution til UDB i den rækkefølge, de registreres.
WS ForberedendeForløb
Indberetning af forberedende aktivitetsforløb sker ved kald fra det administrative system (datakilden) til en webservice udstillet på integrationsplatformen. Afhængig af opsætningen af det administrative system skal enten den enkelte uddannelsesinstitution eller leverandøren af kildesystemet forinden indgå en tilslutningsaftale med STIL. Ved hvert kald bliver den kaldende part autentificeret og autoriseret inden viderestilling til UDB. Information om tilslutning til integrationsplatformen findes på viden.stil.dk.
Struktur for IndberetningRequest
Den overordnede struktur i xml'en fremgår af nedenstående figur.
Figur 1: XML struktur for Indberetning af forberedende forløb
IPLIndberetningRequest
IPLIndberetningRequest indeholder alle data om hændelsen i det forberedende forløb. Hændelser indberettes enkeltvis.
Felt | Type | Krævet | Lovlige værdier | Beskrivelse |
---|---|---|---|---|
ModtagerSystemID | String(100) | Ja | En streng, som udpeger det eksterne system – dvs. navnet på systemet. ModtagerSystemID svarer til samme element i IP-UNG webservicens element Modtager. Skal udfyldes af samme værdi som står i SystemName (og hvis der tidligere har været tilkobling til IP-UNG, den samme værdi som blev sat i feltet af samme navn). Brugs bl.a. til at sørge for at valideringssvar sendes til korrekte system. | |
CPRNr | Integer (10) | Ja | Skal kunne findes i CPR-registeret | CPR-nummeret på den unge, som indberetningen vedrører. |
HaendelseNummer | String | Nej | Unik id på indberetningen, såfremt indberetningen ikke fejler. | |
ForloebIdent | String | Nej | Se note 1. | Unik id for forløbet.Et forløb defineres ved samme kombination af CPR-nummer, hovedinstitution og CØSA-formål. ForløbId'et skal sendes med, hvis hændelsen omhandler et allerede igangsat forløb. |
DataKildeInstitutionNummer | Integer(6) | Ja | Skal kunne genfindes i institutionsregisteret | Institutionsnummeret for den institution, der foretager indberetningen. Bruges til at identificere hvilken institution, der indberetter for på den måde bl.a. at kunne sende valideringssvar til rette institution. DataKildeInstitutionNummer svarer til Username i IP-UNG webservicen. |
InstitutionNummer | Integer(6) | Ja | Skal kunne genfindes i institutionsregisteret | Afdeling 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. |
AfbrudsaarsagsKode | Integer | Nej, men ja vedstatus Afbrud | Skal kunne genfindes i kodetabel for Afbrudsårsagskoder. | Kode for årsagen til afbruddet af forløbet eller aktiviteten.Feltet skal udfyldes, hvis den indberettede status er afbrud. |
Status | Integer(2) | Ja | Se note 3. | En kode, som beskriver status for den unges uddannelsesforløb |
KildeLeverandoer | String (20) | Ja | En betegnelse, der identificerer kildeleverandørens system. | |
KlasseTrin | Integer (2) | Nej | Se note 4. | Angivelse af klassetrin i grundskoleforløbet (00-11 klasse). |
ForberedendeAktivitetsKode | String (4) | Nej | Kode fra kodesæt til forberedende forløb. | |
KlasseType | Integer (2) | Nej | Se note 5. | Normalklasse eller specialklasse |
Elevtrin | Integer (2) | Nej | Se note 4. | Den unges individuelle niveau målt i klassetrin 00-11 |
KlasseNavn | String (30) | Nej | Fx "Mariehønen" eller "9B" | Navn på klassen tildelt af institutionen |
Annullering | Boolean | Nej | False = nej | Markering af, at en tidligere indberetning skal annulleres (fejl-indberetning). |
Registreringstid | DateTime | Ja | yyyy-mm-dd hh:mm_ss.sssssss | Tidspunkt for registrering af tilstanden eller ændringen i kildesystemet. |
FrafaldstruetMarkering | Boolean | Nej | True = Frafaldstruet | Markering af risiko for frafald. Markeringen anvendes, når den unge vurderes at være frafaldstruet. Markering kræver, at Status er Optaget. |
FrafaldstruetIfoelgeUUcenter | Boolean | Nej | True = Frafaldstruet | Ifølge KUI's informationer er den unge frafaldstruet. Feltet anvendes, når KUI mener, at der mangler en indberetning om risiko for frafald fra en anden datakilde (uddannelsesinstitution). Status angives som et optag. |
AfbrudIfoelgeUUcenter | Boolean | Nej | False= nej | Ifølge KUI's informationer har den unge afbrudt sit uddannelsesforløb. Feltet anvendes, når KUI mener, at der mangler et afbrud fra en anden datakilde (uddannelsesinstitution). Status angives som optag, og der skal ikke indberettes tilhørende afbrudsårsag. |
UdddannelsesinstitutionKontakt | (XML element) | Nej | ||
ElevKontakt | (XML element) | Nej |
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 UDB fra optaget til afbrudt eller gennemført.
UDB 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.
Bemærk, at UDB sletter et indberettet forløbId, hvis indberetningen ikke passer til det pågældende forløb. I så fald danner UDB et nyt forløbId, som vil blive returneret i valideringssvaret til datakilden.
Note 2: Afbrudsaarsagskode
De værdier, der kan modtages i UDB, er vist her viden.stil.dk. Det inkluderer koder, som kan være tilegnet andre uddannelsesområder.
Note 3: 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 4: KlasseTrin
Der skal indberettes på følgende klassetrin. Mindre klassetrin skal ikke indberettes, da disse finder sted før de unge fylder 15 år.
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
UddannelsesinstitutionKontakt
UddannelsesinstitutionKontakt indeholder kontaktoplysninger for den relevante uddannelsesinstitution.
Felt | Type | Krævet | Lovlige værdier | Beskrivelse |
---|---|---|---|---|
Navn | String (500) | Ja, hvis elementet tilføjes | 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 | Skal overholde mail-syntaks. Fx test@email.dk. | Kontaktpersonen på institutionen, hvis der indberettes risiko for frafald: e-mail på person |
ElevKontakt
ElevKontakt indeholder kontaktoplysninger for den unge.
Felt | Type | Krævet | Lovlige værdier | Beskrivelse |
---|---|---|---|---|
Telefon | Integer (10) | Nej | Den unges telefonnummer. | |
String | Ja, hvis elementet tilføjes | Skal overholde mail-syntaks. Fx test@email.dk. | Den unges mailadresse. |
Struktur for IndberetningResponse
Ved indberetning returnerer webservicen følgende synkrone svar, såfremt der ikke opstår fejl i schemavalideringen i STIL's integrationsplatform.
IndberetningResponse
Felt | Type | Krævet | Lovlige værdier | Beskrivelse |
---|---|---|---|---|
HaendelseNummer | String | Ja | Unik ident, der identificerer indberetningen i UDB. |
Hvis der opstår fejl i schemavalideringen, sender STIL's integrationsplatform en fejlbesked. Information om dette findes på viden.stil.dk dk under Ungedatabasen.
WS ValideringsSvarOgAdvis
Der er oprettet en selvstændig webservice (ValideringsSvarOgAdvis) til at give svar på om indberetningerne af hændelser på de unge gik godt. Servicen returnerer valideringssvar tilhørende den enkelte datakilde (uddannelsesinstitution). Webservicen er udstillet på integrationsplatformen (IPL).
Valideringssvaret kan yderligere indeholder beskeder (Advis) fra kommunen, som relaterer sig til de indberetninger, som institutionen har sendt.
Valideringssvar til institutionen beskrives i en selvstændig grænsefladebeskrivelse.
Fejlkoder
Til orientering ses her hvilke fejlkoder, der kan komme i valideringssvaret, når webservicen ForberedendeForloeb anvendes. Beskrivelse af fejlbeskeder kan også findes via den selvstændige grænsefladebeskrivelse for valideringssvar.
Der oprettes ikke hændelser ved hårde fejl. Disse indberetninger afvises. Der vil således være behov for at gensende indberetninger, hvis det ud fra fejlbeskeden vises at være relevant.
Der dannes hændelser for indberetninger med bløde fejl, men der returneres en fejlbesked alligevel, da det antages, at der er uregelmæssigheder ved indberetningen.
Herunder er de mulige fejlkoder vist. Se viden.stil.dk for en opdateret oversigt.
Fejlkoder i forbindelse med validering
Fejlnr. | Relateret attribut | Fejltekst | Forklaring | Blød fejl: BHård fejl: H |
---|---|---|---|---|
1 | Annullering | Annullering ugyldig, hændelsesnummer og CPR-nummer ikke fundet | Det er ikke muligt at finde det angivne hændelsesnummer og CPR-nummer, som skal annulleres. | H |
2 | Uddannelseskoder | Ugyldig uddannelseskode eller aktivitetskode | Kode for en af værdierne: Klassetrin, CØSA-formål, Jobcenter aktivitetstype, Jobcenter aktivitetskode, Aktivitetsgruppekode, PKAT (Etat kode) eller Forberedende aktivitetskode er ikke i liste over gyldige værdier. | H |
3 | Afbrudsårsagskode | Ugyldig afbrudsårsagskode | Kun årsagskoder iht. myndighedskrav er gyldig for indberetning. | H |
4 | Uddannelseskoder | Uddannelseskoden ønskes ikke i Ungedatabasen | Uddannelseskoden er i listen at et af kodesættende, men er markeret som ikke ønsket (på negativlisten). | H |
5 | Institutionsnummer | Ukendt institutionsnummer | Institutionsnummeret findes ikke i Institutionsregisteret | H |
6 | Hændelsesdato | Hændelsesdatoen må ikke fremdateres | Hændelsesdatoen for gennemførsel/afbrud må ikke ligge efter registreringstiden for hændelsen. | H |
7 | Afbrudsårsagskode | Afbrudsårsagskode skal angives ved afbrud | Der skal angives en gyldig afbrudsårsag, når en ung afbryder sin uddannelse.Afbrudsårsag skal også være angivet ved markering af 'Afbrud ifløge KUI'. | H |
8 | Afbrudsårsagskode | Afbrudsårsag angives kun ved afbrud | Afbrudsårsag kan ikke angives ved andre former for indberetninger end afbrud og 'Afbrud ifølge KUI'. | H |
10 | ForloebIdent | ForløbsId mangler | Ved 'Afbrud ifølge KUI' eller 'Risiko for frafald ifølge KUI' skal der medsendes identifikation af det forløb, KUI mener er berørt. | H |
13 | Status | Afbrud Ifølge KUI kan kun angives ved optag | Den unge skal være optaget og ikke siden have afbrudt eller gennemført forløbet for, at KUI kan markere, at den unge har afbrudt. | H |
14 | CPR-nummer | Den unge findes ikke i UDB | Der skal kun indberettes for unge med bopæl i Danmark. CPR nummeret kan ikke genfindes i UDB i relation til en aktiv ung bosiddende i Danmark. | H |
15 | CPR-nummer | Aldersgrænse overskredet | Aldersgrænsen er overskredet. Den unge skal være fyldt 15 år og være under 30 år. | H |
16 | Status | Ugyldig statuskode | Kun status iht. liste i grænsefladebeskrivelsen er gyldig for indberetningen. | H |
17 | Status | Risiko for frafald kan kun angives ved optag | Den unge skal være optaget og ikke siden have afbrudt eller gennemført forløbet for, at det kan markeres, at den unge har afbrudt. | H |
30 | Kildeleverandør | Datakildebetegnelse format ikke gyldigt | Betegnelsen for kildekoden kendes ikke i UDB. | H |
62 | Dublet | Dublet | Der er registreret en indberetning, hvor følgende er identisk:CPR-nummerInstitutionsnummerUddannelseskodeHændelsesdatoStatusSpeciale (hvis udfyldt).Registreringstiderne er ikke nødvendigvis identiske. Ved samtidig afbrud og gentilmelding på samme uddannelse, skal afbruddet registreres først. | H |
209 | Uddannelsesinstitutionkontaktnavn | Kontaktpersonnavn mangler | Kontaktpersonoplysninger er angivet, men mangler navn på kontakten. | B |
101 | exeption - UDB | Intern fejl i UDB | H |
Fejlkoder i forbindelse med behandling af indberetningen
Fejlnr. | Relateret attribut | Fejltekst | Forklaring | Blød fejl: BHård fejl: H |
---|---|---|---|---|
12 | ForloebIdent | ForloebIdent er krævet og skal matche registreringer | Forløbsidenten på indberetningen peger på et forløb, der ikke matcher indberetningen for så vidt angår CPR-nummer, hovedinstitution eller uddannelseskode. Det er krævet for indberetninger om risiko for frafald og afbrud fra KUI. | H |
75 | ForloebIdent | Optag efter gennemført uddannelse ikke mulig | Uddannelsen er allerede gennemført. Dermed er indberetningen om optagelse afvist. Kræver annullering af hændelse for gennemført uddannelse inden anden status kan indberettes. Fejlen benyttes hvis hændelsen ikke er historisk. | H |
213 | ForloebIdent | Nyt forløbid anvendt, da det indberettede forløbid ikke matcher et forløb på den unge | Forløbsidenten på indberetningen peger på et forløb, der ikke matcher indberetningen for så vidt angår CPR-nummer, hovedinstitution eller uddannelseskode, men der er ikke er krav om forløbsident på denne indberetning. Der tildeles et nyt forløbsId | B |
257 | ForloebIdent | Forløb mangler optag | Der forventes et Optag, før der modtages et afbrud eller gennemførelse. | B |
264 | ForloebIdent | Der findes tidligere indberetning om afbrud ifølge KUI | Der er tidligere registreret afbrud ifølge KUI | B |
265 | ForloebIdent | Der findes tidligere indberetning om afbrud, som bør annulleres | Der er tidligere registreret afbrud for forløbet. Afbruddet bør annulleres, hvis denne indberetning er korrekt | B |
272 | ForloebIdent | Optag eller afbrud indberettet efter indberetning af gennemført forløb | Der er tidligere registreret at forløbet er gennemført, hvilket harmonerer dårligt med, at der nu indberettes optag/afbrud | B |
273 | ForloebIdent | Der er tidligere indberettet hændelse med senere registreringstid og eller hændelsesdato | Der er tidligere indberettet hændelse på forløbet med senere registreringstid og/eller hændelsesdato | B |
Hårde fejl angives med numre op til og med 199.
Bløde fejl angives med numre fra 200.
Det bemærkes, at formattjek (tjek af xml schema) foretages i integrationsplatformen og kan resultere i fejl 400.
Ved fejl 500 kontaktes Ungedatabasens produktejere via STIL's support. Kan forekomme, hvis Ungedatabasen eller IPL er utilgængelig.
Endpoints til testmiljø
Endpoints til testmiljø kan findes her: https://viden.stil.dk/display/OFFintegrationsplatformen/Services
Webservicens ligger under System Ungedatabasen og har navnet ForberendeForloeb version 1.