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
3 Hvilke personer skal indberetningen omfatte?. 4
4 Hvornår skal der indberettes?. 4
5 Hvilke oplysninger skal indberettes?. 4
9 Yderligere teknisk information. 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) | |
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