Grænseflade til indberetning fra STAR af jobcenteraktiviteter til Ungedatabasen

Dato:

17. februar 2024

Version

Status

1.0

Gældende fra og med den 21. juni 2024

Ansvarlig

Jørgen Bloch Vejbæk




Ændringshistorik

Version

Kapitel/afsnit

Beskrivelse

 1.0

 6.1

 Der skiftes ud i jobcenter aktivitetskoder, som er virksomhedspraktik relaterede (V)

 

 

 

 

 

 

 

 

 



Indhold

1      Indledning. 4

2      Hvem skal indberette?. 4

3      Hvilke personer skal indberetningen omfatte?. 4

4      Hvornår skal der indberettes?. 4

5      Hvilke oplysninger skal indberettes?. 4

6      Forløb i jobcenteret 5

6.1   Filindhold. 5

6.2   CSV struktur. 8

7      Fejlkvittering via mail 8

8      Tilgængelighed. 8

9      Yderligere teknisk information. 9

10    Support 9



1               Indledning

Ifølge Vejledningsloven skal de kommunale uddannelsesvejledninger 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 sikre, at unge under 30 år uden uddannelse skal have uddannelseshjælp i stedet for kontanthjælp.

Til dette formål har uddannelsesinstitutioner pligt til at indberette oplysninger om unges uddannelsesaktiviteter til Ungedatabasen (UDB), som drives af Styrelsen for It og Læring (STIL).  

UDB videresender oplysningerne til UU og jobcentre via Styrelsen for Arbejdsmarked og Rekruttering (STAR). Derudover anvender STIL oplysningerne til statistiske formål.

2               Hvem skal indberette?

STAR indberetter til STIL efter aftale om det fælles datagrundlag bestående af DFDG hos STAR og UDB hos STIL.

Indberetninger fra STAR foregår via sFTP til Ungedatabasen.

STAR indberetter alle aktiviteter registreret i STAR's BI system hver gang (fuld fil).

Det er aftalt, at der kun benyttes et fast institutionsnummer til at angive indberetningerne fra STAR.

3               Hvilke personer skal indberetningen omfatte?

Denne grænseflade omfatter indberetning om unge, som efter aftale med et jobcenter begynder en aktivitet, fx en uddannelse eller praktik i en virksomhed. 

Indberetningen omfatter alle unge fra 15 til og med 24 år.

Aktiviteterne skal kunne have en varighed på mindst 6 uger.

4               Hvornår skal der indberettes?

STAR leverer ugentligt en sFTP fil til STIL.

5               Hvilke oplysninger skal indberettes?

Indberetningen skal blandt andet indeholde følgende oplysninger:

  • Personidentifikation
    • CPR-nummer
  • Start- og slutdato på aktiviteten
  • STAR Statuskoder
    • STAR opererer med en del forskellige værdier. Ungedatabasen har interesse i ’Annulleret’ for at kunne danne hændelser ved afbrud. Ellers opfattes aktiviteten som gennemført, når en slutdato er passeret.
  • Aktivitetsforløbkode
    • V = Praktik i virksomhed
    • U = Uddannelsesrelateret aktivitet
  • Institutionsnummer (fast værdi tildelt STAR)

Det er ikke muligt at indberette risiko for frafald fra jobcentrene.


6                                       Indberetning om aktivitet i jobcenteret

Filen skal leveres i tegnsepareret format efter retningslinjerne beskrevet i afsnittet 6.2 CSV struktur.

Hver enkelt record overføres til og gemmes i UDB, såfremt alle records i filen er formateret korrekt.

En ung kan optræde flere gange i udtrækket (flere records), såfremt der er iværksat flere aktiviteter.

Der udføres efterfølgende en asynkron proces i UDB, hvor records – som er ændringer siden sidste indberetning – overføres som reelle indberetninger i UDB.

STAR sletter ikke nødvendigvis oplysninger om unges aktiviteter, når de er gennemført, men først når de er for gamle i forhold til den aftalte aldersbegrænsning.


6.1                                 Filindhold

Filen indeholder nedenstående felter i hver record:

Felt

Type

Krævet

Lovlige

værdier

Beskrivelse

JobcenterAktivitetsType

String (1)

Ja

’U’ eller ’V’

’U’ eller ’V’ afhængig af om det er en uddannelsesrelateret eller virksomhedsrettet aktivitet.

CPRnr.

Integer (10)

Ja

Skal kunne genfindes i CPR-registeret.

CPR-nummer på personen, der deltager i aktiviteten.

InstitutionNummer

Integer (6)

Ja

Skal være

99998

Identificerer institutionen, hvor den unge er i gang med en uddannelsesaktivitet. STAR anvender altid samme institutionsnummer.

StartDato                

Date

Ja


Dato, hvor hændelsen indtræffer. Startdato på aktiviteten.

SlutDato

Date

Ja


Dato, hvor aktiviteten ophører.

StarTypeKode

Integer (2)

Ja


Kode, der angiver aktivitetstypen. Dette er afhængig af, om der er angivet V eller U i feltet JobcenterAktivitetsType.

Kodebetegnelserne hos STAR:

V: (JobOrderTypeIdentifier) ItemIdentifier (der dog trækker herfra: Borgerindsats.JobtilbudTypeCodeList)
U: (CourseTypeIdentifier) ItemIdentifier
Note 1: liste over koder som indlæses

StarTypeTekst

Text

Nej


Betegnelser til koder

Status

String(20)

Ja


STAR’s koder for status. Ungedatabasen opfatter STAR's kode for annullering som et afbrud på det tidspunkt, hvor status er sat. Afbrud opfattes som afbrud Øvrige koder anvendes ikke.

Note 2: Liste over alle statiskoder fra STAR

KildeLeverandoer

String (20)

Ja

”STAR”

Betegnelse eller kode, der identificerer kildeleverandøren. Dette aftales med kildeleverandøren.

Registreringstid

DateTime

Ja


Tidspunkt for registrering af hændelsen i kildesystemet


Note 1:  

Herunder ses de STAR’s aktivitetskoder, som det er valgt at indlæse.


Kodetype

Kode

Beskrivelse

U

30

Øvrige forløb

U

32

Danskundervisning

U

33

Særlig tilrettelagt danskundervisning

U

34

Mentor, individuel

U

35

Mentor, Plads

U

39

Arbejdsmarkedsrettet danskundervisning

U

44

Danskuddannelse, introduktionsforløb

U

45

Danskuddannelse, LAB

V

 1

Ordinært job

V

 3

Voksenelev

V

 4

Fleksjob

V

 5

Job for førtidspensionister på særlige vilkår

V

 6

Virksomhedspraktik

V

 7

Ansættelse med løntilskud

V

 8

Samfundsnyttige opgaver

V

 9

Rotationsvikar (særlige grupper)

V

10

Almindelig rotationsvikar

"U" koder beskrives hos STAR her: https://starwiki.atlassian.net/wiki/spaces/FYS/pages/48890020/CourseTypeIdentifier

"V" koder beskrives hos STAR her: https://starwiki.atlassian.net/wiki/spaces/FYS/pages/3777921052/Borgerindsats.JobtilbudTypeCodeList


Note 2:

Kode

Beskrivelse

Planlagt

Planlagt

Optaget

Optaget (kun for kurser)

Annulleret

Annulleret

Afbrudt

Afbrudt

Gennemført

Gennemført (kun for kurser)

Henvist

Henvist (kun for virksomhedsrettede tilbud)

Ansat

Ansat (kun for virksomhedsrettede tilbud)

Afsluttet

Afsluttet



6.2                                 CSV struktur

For CVS strukturen gælder, at:

  • Tegnsættet i filen skal følge UTF-8 encoding
  • Filen skal indeholde kolonneoverskrifter i første linje
  • Hver række i filen skal afsluttes med carriage return og en line feed (karakterer 13 og 10).
  • Kolonneseparator skal være semikolon (;)
  • Hver række skal have samme antal kolonner. Dvs., at antallet af kolonneseparatorer skal være det samme i alle rækker.

7               Fejlkvittering via mail

Hele filen fejlmeldes, hvis der findes en fejl.


Der sendes en mail med beskrivelser af fejl til en mailadresse STAR har udvalgt.

Format i mail:

Emne: ”Modtaget fil kunne ikke indlæses i Ungedatabasen”

Indhold:

”Nedenstående indhold kunne ikke indlæses i Ungedatabasen.”


”Filnavn: ”<INDBERETNING_STAR_FIL.FILNAVN>

”Modtaget:” <INDBERETNING_STAR_FIL.DATO_MODTAGET>


”Fejl”

<FEJLKODE> <FEJLTEKST> ”Record: ” < INDBERETNING_STAR_RECORD.RECORD>


Følgende fejl kan forekomme:

FEJLKODE = ’9901’ (recorden har ikke det korrekte antal felter: <RECORD>)

FEJLKODE = ’9902’ (En eller flere felter i recorden overholder ikke formatet)

FEJLKODE = ’9903’ (En eller flere obligatoriske felter i recorden er ikke udfyldt)

8                    Tilgængelighed

Styrelsen for IT og Læring forbeholder sig ret til, indenfor fast aftalte servicevinduer at foretage optageringer og/eller fejlretninger af UDB.

Servicevinduer fastlægges efter behov.

Hvis det ikke er muligt at opretholde almindelig drift på grund af fejlretning eller vedligeholdelse af en service, vil udbedring ske: [ ]. Varsling herom sker…

Hvis nedetid skyldes forhold, der er STIL uvedkommende, f. eks. fejl i leverandørens eget udstyr, generelle netværksfejl eller fejl i kommunikationslinjer, udgør den manglende tilgængelighed ikke nedetid i denne forstand.

Det samme gælder driftshindringer, som leverandøren er ansvarlig for samt udefrakommende forstyrrelser, som f.eks. strømafbrydelser, lynnedslag, indbrud, brand, vandskader og lignende, medregnes ikke som nedetid.

Servicevinduer og øvrige varslede stop, medregnes ikke som nedetid.

9                    Yderligere teknisk information

Yderligere teknisk information om UDB findes på http://stil.dk. Det gælder for:

  • Systemadgang og brugeradgang til UDBs services, som håndteres af Integrationsplatformen.
  • Webservices (WSDL-filer)
  • IP-adressen for sFTP-servicen
  • Øvrige grænsefladebeskrivelser
  • Vejledning

10               Support

STILs support kan kontaktes på:

https://www.stil.dk/driftsstatus-og-support
Telefon: 3587 8881