Webservice version 1 | |
Grænseflade til indberetning af kontakt og tilbudstid til Ungedatabasen | |
Dato: 21-10-2021 | |
Dokument Version | Status |
2 | Gældende fra den 1. januar 2022 |
Ansvarlig Jørgen Bloch Vejbæk | |
Ændringshistorik
Version | Kapitel/afsnit | Beskrivelse |
1.1 | Kapitel 6 | Tilføjelse af Modtager XML element. |
1.2 | Kapitel 7 | Beskrivelse af valideringssvar flyttes til en selvstændig grænsefladebeskrivelse. |
2.0 | Hele dokumentet | Tilpasset Integrationsplatformen IPL |
Indhold
3 Hvilke personer skal indberetningen omfatte?. 5
4 Hvornår skal der indberettes?. 5
5 Hvilke oplysninger skal indberettes?. 5
6.1 Struktur for IndberetningRequest 6
6.1.1 IPLIndberetningRequest 7
6.2 Struktur for IndberetningResponse. 8
7 WS ValideringsSvarOgAdvis. 9
7.1.1 Fejlkoder i forbindelse med validering. 9
1 Indledning
Ifølge Vejledningsloven skal de kommunale uddannelsesvejledninger (Kommunale Unge Indsats - 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 indberetning af kontakt- og tilbudstid, som KUI skal indberette til UDB.
2 Hvem skal indberette?
Mht. vejledningsindsatsen skal KUI kontakte de 15-17 årige unge senest 5 arbejdsdage efter, at KUI er blevet bekendt med, at den unge har afbrudt sin uddannelsesplan. KUI skal endvidere tilbyde den unge en ny aktivitet senest 30 kalenderdage efter.
KUI skal indberette kontakt- og tilbudstider for disse henvendelser til UDB. Ved indberetning af kontakt og tilbudstid må den unge ikke være fyldt 18 år på tidspunktet for afbruddet. Indberetningspligten er ikke gældende ved uddannelse- og skoleskift, idet den unges afbrud vil blive erstattet af et nyt optag umiddelbart efter.
3 Hvilke personer skal indberetningen omfatte?
Indberetningen skal omfatte unge i alderen 15 til og med 17 år, som har afbrudt deres uddannelse.
4 Hvornår skal der indberettes?
Der indberettes umiddelbart efter, KUI er blevet bekendt med, at den unge har afbrudt en uddannelse.
Bemærk, at KUI bliver orienteret om, at den unge har afbrudt sin uddannelse ved at modtage en hændelse om dette fra Ungedatabasen. Hvis KUI ad anden vej er orienteret om, at den unge har afbrudt sin uddannelse, så har KUI mulighed for at indberette et afbrud ifølge KUI. Indberetning af kontakt- og tilbudstid skal så knyttes til det afbrud, som KUI indberetter.
5 Hvilke oplysninger skal indberettes?
Indberetningen indeholder kontakttid eller tilbudstiden.
Kommunen skal indberette kontakt- og tilbudstid for de 15-17 årige unge, som ikke er i uddannelse eller fuldtidsbeskæftigelse.
Indberetningspligten er ikke gældende ved uddannelses- og skoleskift, idet den unge forventes at være i gang med en ny aktivitet umiddelbart efter, det vil sige, at der her vil komme registrering om, at den unge er optaget på ny aktivitet.
Der skal indberettes umiddelbart efter, at kommunen er blevet bekendt med, at den unge har afbrudt en uddannelse, og at kommunen har taget kontakt til den unge.
Ved indberetning af kontakt- og tilbudstid må den unge ikke være fyldt 18 år på tidspunktet for afbruddet.
Indberetningen skal indeholde kontakttid eller tilbudstid som hændelsesdato, og der skal refereres til det afbrud (eller afbrud ifølge kommunen), som den unge er indberettet med.
6 WS KontaktOgTilbudstid
Indberetning af kontakt- og tilbudstid sker fra KUI til Ungedatabasen via en webservicen KontaktOgTilbudstid, som er udstillet på Integrationsplatformen (IPL) hos STIL.
6.1 Struktur for IndberetningRequest
Den overordnede struktur i xml’en fremgår af nedenstående figur.
Figur 6.1: XML struktur for Indberetning af kontakt- og tilbudstid
6.1.1 IPLIndberetningRequest
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). | |
CPRNr | Integer (10) | Ja | Skal kunne findes i CPR-registeret | CPR-nummeret på den unge, som indberetningen vedrører. Den unge skal have bopælsadresse i Danmark og være fra 15 til og med 17 år gammel. |
KontaktEllerTilbudstid | String (1) | Ja | K = kontakttid T = Tilbudstid | |
HaendelseDato | DateTime | Ja | yyyy-mm-dd hh:mm_ss.sssssss | Dato, hvor KUI registrerer kontakt- eller tilbudstiden. |
DataKildeInstitutionNummer | Integer(6) | Ja | Skal kunne genfindes i institutionsregisteret | Institutionsnummeret for den institution, der foretager indberetningen. |
InstitutionNummer | Integer(6) | Ja | Skal kunne genfindes i institutionsregisteret | KUIs institutionskode i Institutionsregisteret. |
KildeLeverandoer | String (20) | Ja | En betegnelse, der identificerer kildeleverandøren. | |
HaendelseNummer | String | Ja | Unik id på indberetningen, som indgår i underretningen til KUI. KUI skal indsætte hændelsesnummeret for den indberetning, som indikerer, at den unge har afbrudt sin uddannelse. |
6.2 Struktur for IndberetningResponse
Ved indberetning returnerer webservicen følgende synkrone svar, såfremt der ikke opstår fejl i schemavalideringen i STIL's integrationsplatform.
Figur 6.2 XML struktur for IndberetningResponse
6.2.1 IndberetningResponse
Felt | Type | Krævet | Lovlige værdier | Beskrivelse |
HaendelseNummer | String | Ja |
| Unik id, 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 under Ungedatabasen.
7 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.
7.1 Fejlkoder
Til orientering ses her hvilke fejlkoder, der kan komme i valideringssvaret, når webservicen KontaktOgTilbudstid er 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.
7.1.1 Fejlkoder i forbindelse med validering
Fejlnr. | Relateret attribut | Fejltekst | Forklaring | Blød fejl: B |
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 |
20 | Hændelsesnummer | Hændelsesnummer findes ikke | Ved angivelse af kontakt- eller tilbudstid, så findes hændelsesnummeret ikke i Ungedatabasen. | H |
23 | Alder | Den unge er over 18 år ved afbruddet | Den unge er over 18 år på tidspunktet for afbrud. Der skal derfor ikke indberettes kontakt og tilbudstid. | H |
67 | Hændelsesnummer | Hændelsesnummeret refererer ikke til et afbrud | Hændelsesnummeret i indberetning af kontakt- eller tilbudstid refererer ikke til en hændelse med status Afbrud. | H |
101 | exeption - UDB | Intern fejl i UDB | H |
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.
8 Endpoints
Endpoints til miljøerne kan findes her: https://viden.stil.dk/display/OFFintegrationsplatformen/Services
Webservicens ligger under System Ungedatabasen og har navnet KontaktOgTilbudstid version 1.