Grænseflade til oprettelse af abonnement på unge med uddannelsespålæg


Dato:
14-10-2021


Version

Status

3

Gældende fra og med den 1. januar 2022.

Ansvarlig
Jørgen Bloch Vejbæk




Ændringshistorik

Version

Kapitel/afsnit

Beskrivelse

1.1


Dato for registrering af plan af typen uddannelsespålæg indføres. Uddannelsespålæg trin samt data fra jobcenteret sendes samtidig.
Dato hvor jobcenteret ikke nødvendigvis påtager sig vejledningsansvaret indføres.

1.2

4.2, 4.4, 1.2, 1.4. 2.2, 2.4

CPRNr: Integer(10) rettet til String(10).

1.3

4.2

Telefonnummer format ændret.

1.4

4.1
5.2, 6.2

Figur ændret (1:1 relationer)
AarsagTilAfbrud tilføjet

2.0

Hele dokument påvirket

Overgang til at Bruge integrationsplanformen IPL, som erstatter IPung.

3.0

Hele dokument påvirket

Tilføjelse af jobcenter spørgeskema, kontaktperson i jobcenter og nedlæggelse af JobcenterAnsvarStop.



Indhold
1 Indledning
2 Hvad omfatter abonnementet?
3 Hvilke personer skal indberetningen omfatte?
4 AbonnementForUddannelsesPaalaeg
4.1 Overordnet struktur
4.2 Oprettelse af abonnement (Opret)
4.2.1 Struktur ved abonnementsoprettelse
4.2.2 Opret
4.2.3 OpretSvar
4.2.4 Struktur for OpretSvar
4.3 Registrering af Uddannelsespålæg (Uddannelsespaalaeg)
4.3.1 Struktur ved uddannelsespålæg information
4.3.2 Uddannelsespaalaeg
4.3.3 UddannelsespaalaegSvar
4.3.4 Struktur for UddannelsespaalaegSvar
4.3.5 Sammenkobling mellem svar og spørgsmålstekst
4.4 Registrering af kontaktperson (Kontaktperson)
4.4.1 Struktur ved Kontaktperson
4.4.2 Kontaktperson
4.4.3 KontaktpersonSvar
4.4.4 Struktur for KontaktpersonSvar
4.5 Lukning af abonnement (Luk)
4.5.1 Struktur ved abonnements lukning
4.5.2 Luk
4.5.3 LukSvar
4.5.4 Struktur for LukSvar
5 Fejlkoder
5.1 Fejlkoder i forbindelse med oprettelse af abonnement
5.2 Fejlkoder i forbindelse med oprettelse af Uddannelsespålæg til abonnementet
5.3 Fejlkoder i forbindelse med oprettelse af kontaktperson til abonnementet
5.4 Fejlkoder i forbindelse med lukning af abonnement
6 Endpoints til test

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.
Dette dokument beskriver, hvorledes DFDG systemet hos Styrelsen for Arbejdsmarked og Rekruttering (STAR) kan oprette og lukke abonnementer i Ungedatabasen (UDB) for unge, som kan tildeltes fra uddannelsespålæggets trin 1 i jobcentret.
Dokumentet omhandler grænsefladebeskrivelsen til webservicen AbonnementForUddannelsesPaalaeg.
Dataudvekslingen med UDB forgår via webservices udstillet på STIL's integrationsplatform (IPL), hvor STAR skal autentificeres og autoriseres.
Oplysninger om tilslutning og tekniske detaljer kan findes på STIL's supportsite for Integrationsplatformen via https://viden.stil.dk/x/BgBwBg.
Yderligere skal Ungedatabasen have kendskab til en række oplysninger om de unges behov, som er angivet i jobcenteret via et spørgeskema. Jobcenteret angiver yderligere en kontaktperson/gruppe. Ungedatabasen skal i en anden webservices videregive disse formationer til Uddannelsesinstitutionerne, som svarer med en kontaktperson på uddannelsesinstitutionerne. UDB sikre, at DFDG kan hente kontaktperson på uddannelsesinstitutionerne i en anden webservice.

Hvad omfatter abonnementet?

Ved hjælp af abonnementerne kan UDB levere alle hændelser på unge, som optages, afbryder, er i risiko for at afbryde eller gennemfører en forberedende uddannelse, ungdomsuddannelse eller videregående uddannelse.
De forberedende uddannelser dækker blandt andet over VUC og FGU uddannelser.
Ungdomsuddannelserne omfatter STX, HHX, HTX, EUD, EUX og andre ungdomsuddannelser som fx maritime ungdomsuddannelser. Det er generelt CØSA-formål, som angiver uddannelsesaktiviteten. De CØSA-formål, der modtages indberetninger om, er listet på STIL's hjemmeside under Ungedatabasen.
De videregående uddannelser benytter sig af forskellige andre kodesæt til indberetning af uddannelsesaktiviteten. Disse kodesæt er ligeledes tilgængelige på STIL's hjemmeside. Hændelser vedrørende videregående uddannelser indberettes fra de studieadministrative systemer kaldet esas/SIS og STADS samt Politiets og Forsvarets systemer.

Hvilke personer skal indberetningen omfatte?

Denne grænseflade omfatter oprettelse af abonnement på unge fra 15 til og med 29 år.
Kun unge med bopæl i Danmark jf. CPR-registret kan sættes i abonnement.

AbonnementForUddannelsesPaalaeg

Denne webservice anvendes af STAR til følgende:

  • Opret: Oprettelse af et abonnement for en ung.
  • Uddannelsesspaalaeg: Registrering af støttebehov, støtteperson og eventuelle læse/skrive/regnetest for en given ung.
  • Kontaktperson: Registrering af kontaktperson fra jobcentret på en unge.
  • Luk: Lukning af abonnement for en ung.


Overordnet struktur

Oprettelse af abonnement (Opret)

Oprettelse af et abonnement medfører, at STAR kan hente data om de unges uddannelser.
Abonnementet oprettes, når den unge får en plan af typen uddannelsesplan med et uddannelsespålæg.
Den unge kan starte på et vilkårligt trin af uddannelsespålægget.
Der kan foretages opdateringer af information om jobcentret (jobcenternummer, jobcenter navn og telefon) ved at sende en Opret med det opdaterede information på et allerede eksisterende abonnement (på samme CPR-nummer). Hvis dato'er eller trin også opdateres bliver disse ændringer ikke gemt i Ungedatabasen.

Struktur ved abonnementsoprettelse

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

Figur 1: XML-struktur for oprettelse af abonnement for uddannelsespålæg

Opret


Felt

Type

Krævet

Lovlige værdier

Beskrivelse

InstitutionNummer

Integer(6)

Ja


STARs institutionsnummer (markering af hvem der sender data ind)

UngMedUddannelsespaalaeg

XML element

Ja



UngMedUddannelsespaalaeg

Indeholder blandt andet datoer for start på abonnement og start på uddannelsespålæg.

Felt

Type

Krævet

Lovlige værdier

Beskrivelse

CPRNr

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

Abonnementsdato

Date

Ja

Fx 2002-05-30

Dato, hvor abonnementet begynder. Datoen kan ligge før dags dato hvorved der abonneres på hændelser, som allerede er indberettet i Ungedatabasen.

UddannelsespaalaegTrin

Integer

Ja

1-4

Angiver hvilket trin den unge starter på når uddannelsespålægget gives.

DatoUddannelsespaalaeg_start

Date

Ja

Fx 2019-05-30

Dato hvor den unge får registreret et uddannelsespålæg
(tildeles plantypen uddannelsespålæg)

JobcenterNummer

Integer

Ja

10000-99999

Nummer på jobcenteret, der har givet uddannelsespålæg til den unge

JobcenterNavn

String(50)

Nej


Navn Nummer på jobcenteret, der har givet uddannelsespålæg til den unge

JobcenterTelefon

String(10)

Nej


Telefonnummer til jobcenteret, der har givet uddannelsespålæg til den unge


OpretSvar

Servicen returnerer synkront en fejlbesked eller en kvittering.

Struktur for OpretSvar

Felt

Type

Krævet

Beskrivelse

CPRNr

String(10)

Ja

CPR-nummeret på den unge, som indberetningen vedrører.
Den unge skal have bopælsadresse i Danmark.

IndberetningOk

Boolean

Ja

Markerer om oprettelsen af abonnement er gået godt

Fejlkode

Integer(10)

Nej

Fejlkoderne er beskrevet i afsnit 5 længere nede i grænsefladebeskrivelsen.


Registrering af Uddannelsespålæg (Uddannelsespaalaeg)

Ved registrering af støttebehov for en given ung, skal disse indberettes til Ungedatabasen, således at uddannelsesinstitutionen, den unge er aktiv på, kan afhente dem. For at opdatere den indberettede information for en given ung kan Uddannelsespaalaeg operationen kaldes igen med samme CPR-nummer.

Struktur ved uddannelsespålæg information

Uddannelsespaalaeg

Nedenstående oplysninger stammer fra et spørgeskema udfyldt i jobcenteret, som omhandler den unges behov i forhold til den ønskede uddannelse, der er givet uddannelsespålæg til.

Felt

Type

Krævet

Lovlige værdier

Beskrivelse

InstitutionNummer

Integer(6)

Ja


STARs institutionsnummer (markering af hvem der sender data ind)

UddannelsespaalaegInfo

XML element

Ja




UddannelsespaalaegInfo
Ved registrering af nedenstående data vil der i felterne FagligStoettebehov, SocialtStoettebehov, DokumenteretStoettebehov, IngenStoettebehov være tilladt at angive værdierne 1, 2 eller 3.
Disse værdier skal oversættes til følgende betydning:

Kode

Betydning

1

Ja

2

Nej

3

Ikke udfyldt (tom, betyder at der ikke er taget stilling)

Felt

Type

Krævet

Lovlige værdier

Beskrivelse

CPRNr

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

FagligStoettebehov

Integer(2)

Ja

1,2,3


SocialtStoettebehov

Integer(2)

Ja

1,2,3


DokumenteretStoettebehov

Integer(2)

Ja

1,2,3


IngenStoettebehov

Integer(2)

Ja

1,2,3


Stoetteperson

Boolean

Ja

True/False


StoettepersonSlutDato

Datetime

Nej


Sættes ved True i Stoetteperson

OenskesKontaktetAfUddInst

Boolean

Ja

True/False


JobcenterTest

Boolean

Ja

True/false


JobcenterTestDato

DateTime

Nej


Sættes ved True i JobcenterTest



UddannelsespaalaegSvar

Servicen returnerer synkront en fejlbesked eller kvittering.

Struktur for UddannelsespaalaegSvar

Felt

Type

Krævet

Beskrivelse

CPRNr

String(10)

Ja

CPR-nummeret på den unge, som indberetningen vedrører.
Den unge skal have bopælsadresse i Danmark.

IndberetningOk

Boolean

Ja

Markerer om oprettelsen af Uddannelsespålæg er gået godt. Ved false returneres Fejlkode.

Fejlkode

Integer(10)

Nej

Fejlkoderne er beskrevet i afsnit 5.



Sammenkobling mellem svar og spørgsmålstekst

I forbindelse med at data om uddannelsespålæg sendes til institutionerne følger der hjælpetekst til hvert spørgsmål.
Hjælpeteksten linkes som følger:

Felt i webservice

Svarmulighed

Tekst til spørgsmål

FagligStoettebehov

1,2,3

Jobcenteret vurderer, at der er brug for faglig støtte under uddannelsen

SocialtStoettebehov

1,2,3

Jobcenteret vurderer, at der er brug for støtte til sociale, personlige eller helbredsmæssige udfordringer under uddannelsen

DokumenteretStoettebehov

1,2,3

Jobcenteret har dokumentation for ét eller flere støttebehov 

IngenStoettebehov

1,2,3

Jobcenteret vurderer, at der ikke umiddelbart er et støttebehov i forhold til at klare sig igennem uddannelsen

Stoetteperson

Ja/Nej

Der er tilknyttet en mentor og/eller en anden støtteperson i overgangen til uddannelse

StoettepersonSlutDato

Datostempel (datetime) eller tom

(Sendes under samme tekst som ovenfor)

OenskesKontaktetAfUddInst

Ja/Nej

Jobcenteret vil gerne kontaktes af uddannelsesinstitutionen mhp. konkret dialog om vedkommendes start på uddannelsen

JobcenterTest

Ja/Nej

Der foreligger læse-, skrive- og regnetest

JobcenterTestDato

Datostempel (datetime) eller tom

(Sendes under samme tekst som ovenfor)





Registrering af kontaktperson (Kontaktperson)

Ved registrering af kontaktperson på jobcentret for en given ung, skal denne indberettes til Ungedatabasen, således at uddannelsesinstitutionen, den unge er aktiv på, kan afhente den.
For at opdatere den indberettede information kan Kontaktperson operationen kaldes igen med samme CPR-nummer. Ungedatabasen vil herefter gemme de opdaterede felter.

Struktur ved Kontaktperson

Kontaktperson

Felt

Type

Krævet

Lovlige værdier

Beskrivelse

InstitutionNummer

Integer(6)

Ja


STARs institutionsnummer (markering af hvem der sender data ind)

KontaktpersonInfo

XML element

Ja




KontaktpersonInfo

Felt

Type

Krævet

Lovlige værdier

Beskrivelse

Elev

XML element

Ja

Max 100

En eller flere forekomster. Angiver de elever, der skal angives kontaktpersonen for. Max 100 i ét kald.

KontaktPerson

String(250)

Ja


Kontaktpersonens navn eller gruppe

KontaktTelefon

String(20)

Ja



KontaktMail

String(64)

Ja



SlutDato

Datetime

Nej



Elev

Felt

Type

Krævet

Lovlige værdier

Beskrivelse

CPRNr

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


KontaktpersonSvar

Servicen returnerer synkront en fejlbesked eller kvittering.

Struktur for KontaktpersonSvar


ElevStatus

Felt

Type

Krævet

Beskrivelse

CPRNr

String(10)

Ja

CPR-nummeret på den unge, som indberetningen vedrører.
Den unge skal have bopælsadresse i Danmark.

IndberetningOk

Boolean

Ja

Markerer om oprettelsen af Kontaktperson er gået godt. Ved false returneres Fejlkode.

Fejlkode

Integer(10)

Nej

Fejlkoderne er beskrevet i afsnit 5.



Lukning af abonnement (Luk)

Lukningen af et abonnement medfører, at STAR ophører med at kunne hente hændelser om den unge. Lukning af abonnement vil være sammenfaldende med ophør af vejledningsansvar i jobcenteret. Vejledningsansvaret kan dog frafaldes før lukning af abonnement.
Ved lukning af abonnement slettes data omkring Uddannelsespaalaeg (indberettet i afsnit om Registrering af Uddannelsespålæg) og Kontaktperson i jobcentret (indberettet i afsnit om Registrering af kontaktperson).
Derudover slettes også kontaktpersonen fra uddannelsesinstitutionen, som institutionen har sendt til Ungedatabasen.

Struktur ved abonnements lukning

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

Figur 2: XML-struktur for Lukning

Luk


Felt

Type

Krævet

Lovlige værdier

Beskrivelse

InstitutionNummer

Integer(6)

Ja


STARs institutionsnummer (markering af hvem der sender data ind)

UngUdenUddannelsespaalaeg

XML element

Ja






UngUdenUddannelsespaalaeg


Felt

Type

Krævet

Lovlige værdier

Beskrivelse

CPRNr

String(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. Der skal findes et aktivt abonnement på den unge.

AarsagTilAfbrud

String

Nej


Beskrivende årsag til hvorfor den unge ikke længere er relevant. F.eks. 'Plantypeskift' eller ' Plantypeskift. Se mere her.

LukSvar

Servicen returnerer synkront en fejlbesked eller kvittering.

Struktur for LukSvar

Felt

Type

Krævet

Beskrivelse

CPRNr

String(10)

Ja

CPR-nummeret på den unge, som indberetningen vedrører.
Den unge skal have bopælsadresse i Danmark.

IndberetningOk

Boolean

Ja

Markerer om lukningen af abonnement er gået godt

Fejlkode

Integer(10)

Nej

Fejlkoderne er beskrevet i afsnit 5.


Fejlkoder

Herunder er de mulige fejlkoder vist.

Fejlkoder i forbindelse med oprettelse af abonnement

Fejlnummer

Relateret attribut

Fejltekst

Forklaring

14

CPRNr

Den Unge findes ikke i Ungedatabasen

Der skal kun indberettes for unge med bopæl i Danmark. CPR nummeret kan ikke genfindes i Ungedatabasen i relation til en aktiv ung bosiddende i Danmark.

Fejlkoder i forbindelse med oprettelse af Uddannelsespålæg til abonnementet

Fejlnummer

Relateret attribut

Fejltekst

Forklaring

14

CPRNr

Den Unge findes ikke i Ungedatabasen

Der skal kun indberettes for unge med bopæl i Danmark. CPR nummeret kan ikke genfindes i Ungedatabasen i relation til en aktiv ung bosiddende i Danmark.

68

CPRNr

Den unge findes ikke i aktivt abonnement

Den unge findes ikke i aktivt STAR abonnement i Ungedatabasen og kan derfor ikke lukkes.

Fejlkoder i forbindelse med oprettelse af kontaktperson til abonnementet

Fejlnummer

Relateret attribut

Fejltekst

Forklaring

14

CPRNr

Den Unge findes ikke i Ungedatabasen

Der skal kun indberettes for unge med bopæl i Danmark. CPR nummeret kan ikke genfindes i Ungedatabasen i relation til en aktiv ung bosiddende i Danmark.

68

CPRNr

Den unge findes ikke i aktivt abonnement

Den unge findes ikke i aktivt STAR abonnement i Ungedatabasen og kan derfor ikke lukkes.


Fejlkoder i forbindelse med lukning af abonnement

Fejlnummer

Relateret attribut

Fejltekst

*Forklaring*Kan fejlkode 14 ikke fås ved Luk?
Fx hvis de lukker efter den unge er fyldt 30 år, og vi har nået at slette.

68

CPRNr

Den unge findes ikke i aktivt abonnement

Den unge findes ikke i aktivt STAR abonnement i Ungedatabasen og kan derfor ikke lukkes.


Integrationsplatformen IPL står for skemavalidering af xlm, men der er for en sikkerhedsskyld ligeledes indsat validering i Ungedatabasen, som kan resultere i 'fejl 500'. Sådanne fejl vil blive returneret i elementet ServiceFaultDetailer, der ses i xsd'en.

Endpoints til test

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