Dato
20-10-2021
VersionStatus
2.0 Gældende fra og med den 1. januar 2022
Ansvarlig
UDB-teamet
Ændringshistorik
Version | Gældende fra | Kapitel/afsnit | Beskrivelse |
1.0 | 1/8/19 | 5.1.1.1 | KontaktMail er et krævet felt |
1.1 | 1/8/19 | 3 | Kontaktperson er beskrevet mere indgående |
2.0 | 21/10/21 | Hele dokumentet | Tilpasset Integrationsplatformen IPL |
Indhold
1 Indledning
2 Hvilke unge skal underretningen omfatte?
3 Hvilke oplysninger underrettes der om?
4 WS IndberetningKontaktJobOgUddOensker
4.1 Struktur for IndberetningKontaktJobOgUddOenskerRequest
4.1.1 IndberetningKontaktJobOgUddOenskerRequest
4.1.2 KommuneKontakt
4.1.3 Jobonsker
4.1.4 UddannelsesOnsker
4.2 Struktur for IndberetningSvar
4.2.1 IndberetningSvar
4.2.2 Fejl
5 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 inden de fylder 25 år.
I denne forbindelse kan KUI indberette oplysninger om de unges kontaktpersoner i bopælskommunen til Ungedatabasen (UDB), som drives af Styrelsen for It og Læring (STIL).
Indberetning til UDB sker fra kommunernes administrative systemer via webservices udstillet på STIL's integrationsplatform IP-Ung. Platformen formidler også svar fra UDB vedrørende indberetningerne til de studieadministrative systemer. Det betyder, at de administrative systemer skal have funktioner, som understøtter denne dataudveksling.
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 (KUI) kan indberette til UDB. Kommunen får med det samme svar på, om indberetningen er gået godt.
Hvilke unge skal underretningen omfatte?
Indberetningen vil omfatte alle unge i alderen 15 til og med 24 år. Den unge kan få tilknyttet en kontaktperson udpeget af kommunalbestyrelsen med henblik på at kordinere vejledningsindsatsen for unge, når det vurderes, at den unge af personlige eller sociale årsager har behov for støtte fra flere enheder i kommunen. Kravet omtales i paragraf 2 l bekendtgørelsen " Lov om ændring af lov om vejledning om uddannelse og erhverv samt pligt til uddannelse, beskæftigelse m.v."
Yderligere vedrører indberetningen den unges uddannelses- og jobønsker, som holdes opdaterede ved ændring af uddannelsesplanen for den unge.
Hvilke oplysninger underrettes der om?
Indberetningen omfatter ændringer af følgende oplysninger om den unges kontaktperson i bopælskommunen:
- Kontaktpersonens navn
- Kontaktpersonens e-mailadresse
- Kontaktpersonens mobiltelefonnummer
Indberetningen omfatter ændringer i den unges uddannelsesønske:
- Den unges uddannelsesønske(hvilken uddannelse eller uddannelsesområde kan den unge tænke sig at blive uddannet indenfor) Indberetningen omfatter ændringer i den unges jobønske:
- Den unges jobønske(hvilket erhverv eller erhvervsområde kunne kan den unge tænke sig at arbejde inden for)
Indberetningen indeholde yderligere følgende oplysninger:
- Personidentifikation
- CPR-nummer
- Institutionsnummer på kommunens KUI, hvor den unge har bopæl
WS IndberetningKontaktJobOgUddOensker
Denne webservice udstilles på integrationsplatformen IPL. Servicen anvendes af kommunen ved indberetning af oplysninger om den unges kontaktperson i kommune og den unges uddannelses- og jobønsker.
Struktur for IndberetningKontaktJobOgUddOenskerRequest
Den overordnede struktur i xml'en fremgår af nedenstående figur.
Figur 4.1 XML struktur for Indberetning af kontaktoplysninger, uddannelsesønsker og jobønsker fra kommunen
IndberetningKontaktJobOgUddOenskerRequest
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 | String(10) | Ja | CPR-nummeret på den unge, som indberetningen vedrører. | |
KommuneInstitutionNummer | Integer | Ja | ||
KommuneKontakt | XML element | Nej | ||
JobOnsker | XML element | Nej | ||
UddannelsesOnsker | XML element | Nej |
KommuneKontakt
KommuneKontakt indeholder Kontaktoplysninger for den person ved Kommunen der har haft kontakt til den unge.
Felt | Type | Krævet | Lovlige værdier | Beskrivelse |
---|---|---|---|---|
KontaktNavn | String(100) | Ja | Navn på kontaktpersonen | |
KontaktMail | String(100) | Ja | Kontaktpersonens mailadresse | |
KontaktTelefon | Integer (10) | Nej | Kontaktpersonens mobiltelefonnummer | |
KontaktRegistreringstid | DateTime | Ja | Det tidspunkt oplysningerne er registreret i Kommunens systemer. |
Jobonsker
JobOnsker indeholder oplysninger om den unges jobønsker som de er registreret i kommunen.
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 Kommunens systemer. |
UddannelsesOnsker
UddannelsesOnsker indeholder oplysninger om den unges uddannelsesønsker, som de er registreret i kommunen.
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. |
Struktur for IndberetningSvar
Servicen returnerer med følgende svar, hvis ikke der opstår fejl i schemavalideringen i STIL's integrationsplatform.
Figur 4.2 XML struktur for IndberetningSvar
IndberetningSvar
Felt | Type | Krævet | Kommentar |
Ok | Boolean | Ja | Markering af om indberetninen er accepteret eller fejlmeldt |
Fejl | XML element | Nej | Beskrivelse af fejl i indberetningen. |
Fejl
Fejlbesked indeholder oplysninger om en konkret fejl, der er konstateret i relation til det parametersæt, der er sendt til Ungedatabasen ved ønske om underretning.
Felt | Type | Krævet | Kommentar |
---|---|---|---|
Fejlkode | Integer (10) | Ja | Entydig identifikation af fejltypen i Ungedatabasen |
Fejltekst | String | Ja | Beskrivelse af fejlen |
Mulige fejlkoder ved afvist underretning
Fejlkode | Fejltekst | Forklaring | Fejltype |
14 | Den unge findes ikke i Ungedatabasen | Ungedatabasen opdateres via et abonnement hos CPR, og der er ikke modtaget oplysninger om den unge fra CPR. | H |
15 | Aldersgrænse overskredet | Den unge er fyldt 25 år, hvorefter der ikke forventes data. | H |
86 | Bruger må ikke indberette oplysninger om dette CPR-nummer | Det er kun KUI i den unges bopælskommune, som må indberette. | H |
101 | exeption - UDB | Intern fejl i UDB. | H |
280 | Registreringstid for kontakt, uddannelses- eller jobønsker må ikke fremdateres | Indberettede oplysning skal være gældende på det tidspunkt, som de registreres. | B |
Endpoints til testmiljø
Endpoints til miljøer kan findes her: https://viden.stil.dk/display/OFFintegrationsplatformen/Services
Webservicens ligger under System Ungedatabasen og har navnet IndberetningKontaktJobOgUddOensker version 1.