Sidehistorik
...
Optag indberettes ved påbegyndelse af FGU samt når der sker tilføjelse eller skift i skoleperiode samt speciale. Specialet viser, hvilket spor (AGU/PGU/EGU), den unge har valgt gennem uddannelsen. Skoleperioden (SKP) viser, hvor langt den unge er i uddannelsesforløbet. Her ses mulige kombinationer af spor/speciale og skoleperiode:
Spor(speciale) | Betegnelse | Skole- periode | Betegnelse knyttet til kombination af CØSA-formål, version, speciale og skoleperiode |
---|---|---|---|
BA | Basisforløb, uddannelsesspor ej valgt | ||
1 | Almen grunduddannelse | BA | Basisforløb, uddannelsesspor valgt |
1 | Almen grunduddannelse | US | Uddannelsesspor |
1 | Almen grunduddannelse | ÅP | Årselevpulje |
1 | Almen grunduddannelse | KF | Kommuneforlængelse |
2 | Produktionsgrunduddannelse | BA | Basisforløb, uddannelsesspor valgt |
2 | Produktionsgrunduddannelse | US | Uddannelsesspor |
2 | Produktionsgrunduddannelse | ÅP | Årselevpulje |
2 | Produktionsgrunduddannelse | KF | Kommuneforlængelse |
3 | Erhvervsgrunduddannelse | BA | Basisforløb, uddannelsesspor valgt |
3 | Erhvervsgrunduddannelse | US | Uddannelsesspor |
3 | Erhvervsgrunduddannelse | ÅP | Årselevpulje |
3 | Erhvervsgrunduddannelse | KF | Kommuneforlængelse |
Ungedatabasen har ikke behov for at blive informeret om skift til skoleperioderne Årselevpulje og Kommuneforlængelse.
...
Figur 1: XML-struktur for Indberetning af forberedende grunduddannelsesforløb.
IndberetningForberedendeGrundUddannelseRequest
IndberetningForberedendeGrundUddannelseRequest indeholder alle data om hændelsen i det forberedende forløb. Hændelser indberettes enkeltvis.
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. |
HaendelseNummer | String | Nej | Unik id på indberetningen, såfremt indberetningen ikke fejler. | |
ForloebId | String | Nej | Se note 1 (under tabellen). | Unik id for forløbet.Et forløb defineres ved samme kombination af CPR-nummer, hovedinstitution og CØSA-formål. ForløbId'et skal sendes med, hvis hændelsen omhandler et allerede igangsat forløb. |
DataKildeInstitutionNummer | Integer(6) | Ja | Skal kunne genfindes i institutionsregisteret | Institutionsnummeret for den institution, der foretager indberetningen. Bruges til at identificere hvilken institution, der indberetter for på den måde bl.a. at kunne sende valideringssvar til rette institution. DataKildeInstitutionNummer svarer til Username i IP-UNG webservicen. |
InstitutionNummer | Integer(6) | Ja | Skal kunne genfindes iinstitutionsregisteret. | Afdeling hvor undervisningen eller aktiviteten administreres. |
HaendelseDato | DateTime | Ja | yyyy-mm-dd hh:mm_ss.sssssss | Dato, hvor hændelsen indtræffer. Fx startdato på en uddannelse ved optagelse, datoen for afbrud af uddannelse, dato for gennemførelse eller dato for risiko for frafald. |
Status | Integer(2) | Ja | Se note 2. | Kode, som beskriver status for den unges uddannelsesforløb (optaget, afbrud og gennemført). |
AfbrudsaarsagsKode | Integer | Nej, men ja ved status Afbrud | Skal kunne genfindes i kodetabel for Afbrudsårsagskoder. | Kode for årsagen til afbruddet af forløbet eller aktiviteten.Feltet skal udfyldes, hvis den indberettede status er afbrud. |
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. | |
KildeLeverandoer | String (20) | Ja | En betegnelse, der identificerer kildeleverandørens system. | |
Annullering | Boolean | Nej | False = nej | Markering af, at en tidligere indberetning skal annulleres (fejlindberetning). |
COSAFormaal | Integer (4) | Ja | Skal kunne genfindes i CØSA-kodesættet. | Kode for ungdomsuddannelse fra CØSA. I praksis er det kode 338. |
COSAFormaalVersion | Integer (4) | Nej | Skal kunne genfindes i CØSA-kodesættet. | Kode for ungdomsuddannelse versioneret fra CØSA. |
COSAformaalSpeciale | String(4) | Nej | Skal kunne genfindes i CØSA-kodesættet. | Kode for forberedende grunduddannelse (FGU) fra CØSA. |
SkolePeriode | String (2) | Ja | Skal findes i uddannelsesmodellen under forberedende grunduddannelse. | Kode for skoleperiode under forberedende grunduddannelse (FGU). |
EguUddannelsesbevis | Boolean | Nej | True = Har fået et uddannelsesbevis på EGU-spor | Sand, hvis den unge har afsluttet FGU-uddannelsen på sporet EGU, og har fået et uddannelsesbevis på det. |
Registreringstid | DateTime | Ja | yyyy-mm-dd hh:mm_ss.sssssss | Tidspunkt for registrering af tilstanden eller ændringen i kildesystemet. |
FrafaldstruetMarkering | Boolean | Nej | True = Frafaldstruet | Markering af risiko for frafald. Markeringen anvendes, når den unge vurderes at være frafaldstruet. Markering kræver, at Status er 'Optaget'. |
FrafaldstruetIfoelgeKommune | Booelan | Nej | Ifølge KUI's informationer er den unge frafaldstruet. Feltet anvendes, når KUI mener, at der mangler en indberetning om risiko for frafald fra en anden datakilde (uddannelsesinstitution). Status angives som et optag. | |
AfbrudtIfoelgeKommune | Boolean | Nej | Ifølge KUI's informationer har den unge afbrudt sit uddannelsesforløb. Feltet anvendes, når KUI mener, at der mangler et afbrud fra en anden datakilde (uddannelsesinstitution). Status angives som optag, og der skal ikke indberettes tilhørende afbrudsårsag. | |
UdddannelsesinstitutionKontakt | (XML-element) | Nej | Skal være udfyldt ved risiko for frafald. | |
ElevKontakt | (XML-element) | Nej |
Note 1: ForløbId
Et forløbId sammenkæder flere indberetninger om samme uddannelse til et samlet forløb for den unge. Dermed skabes der en relation i UDB fra optaget til afbrudt eller gennemført.
...
Bemærk, at UDB sletter et indberettet forløbId, hvis indberetningen ikke passer til det pågældende forløb. I så fald danner UDB et nyt forløbId, som vil blive returneret i valideringssvaret til datakilden.
Note 2: Status
Værdi | Betegnelse for status | Beskrivelse |
---|---|---|
1 | Optaget | Den unge optages på et uddannelsesforløb. Hvis der er risiko for, at den unge afbryder uddannelsesforløbet, anvendes status 'Optaget' også for denne indberetning. |
2 | Afbrudt | Den unge har afbrudt sit uddannelsesforløb. |
3 | Gennemført | Den unge har gennemført sit uddannelsesforløb. |
Note 3: Afbrudsaarsagskode
De værdier, der kan modtages i UDB, er vist her viden.stil.dk. Det inkluderer koder, som kan være tilegnet andre uddannelsesområder.
...
UddannelsesinstitutionKontakt indeholder kontaktoplysninger for den relevante uddannelsesinstitution.
Felt | Type | Krævet | Lovlige værdier | Beskrivelse |
---|---|---|---|---|
Navn | String (500) | Ja, hvis elementet tilføjes | Kontaktpersonen på institutionen, hvis der indberettes risiko for frafald: navn på person. | |
Telefon | Integer (10) | Ja, hvis elementet tilføjes | Kontaktpersonen på institutionen, hvis der indberettes risiko for frafald: telefonnummer for person. | |
String (50) | Ja, hvis elementet tilføjes | Kontaktpersonen på institutionen, hvis der indberettes risiko for frafald: mailadresse for person. |
ElevKontakt
ElevKontakt indeholder kontaktoplysninger for den unge.
Felt | Type | Krævet | Lovlige værdier | Beskrivelse |
---|---|---|---|---|
Telefon | Integer (10) | Ja, hvis elementet tilføjes | Den unges telefonnummer. | |
String (50) | Ja, hvis elementet tilføjes | Den unges mailadresse. |
Struktur for" IndberetningForberedendeGrundUddannelseSvar"
Ved indberetning returnerer webservicen følgende synkrone svar, såfremt der ikke opstår fejl i skemavalideringen i STIL's integrationsplatform.
Felt | Type | Krævet | Lovlige værdier | Beskrivelse |
---|---|---|---|---|
HaendelseNummer | String(20) | Ja | Unik ident, der identificerer indberetningen i UDB. |
Hvis der opstår fejl i skemavalideringen, sender STIL's integrationsplatform en fejlbesked. Information om dette findes på viden.stil.dk under Ungedatabasen.
...
Fejlkoder i forbindelse med validering
Fejlnr. | Relateret attribut | Fejltekst | Forklaring | Blød fejl: B |
---|---|---|---|---|
1 | Annullering | Annullering ugyldig, hændelsesnummer og CPR-nummer ikke fundet | Det er ikke muligt at finde det angivne hændelsesnummer og CPR-nummer, som skal annulleres. | H |
2 | Uddannelseskoder | Ugyldig uddannelseskode eller aktivitetskode | CØSA-formål skal være 338, når der indberettes forberedende grundforløb. | H |
3 | Afbrudsårsagskode | Ugyldig afbrudsårsagskode | Kun årsagskoder iht. myndighedskrav er gyldig for indberetning. | H |
5 | Institutionsnummer | Ukendt institutionsnummer | Institutionsnummeret findes ikke i Institutionsregisteret. | H |
6 | Hændelsesdato | Hændelsesdatoen må ikke fremdateres | Hændelsesdatoen for gennemførelse/afbrud må ikke ligge efter registreringstiden for hændelsen. | H |
7 | Afbrudsårsagskode | Afbrudsårsagskode skal angives ved afbrud | Der skal angives en gyldig afbrudsårsag, når en ung afbryder sin uddannelse.Afbrudsårsag skal også være angivet ved markering af 'Afbrud ifølge KUI'. | H |
8 | Afbrudsårsagskode | Afbrudsårsag angives kun ved afbrud | Afbrudsårsag kan ikke angives ved andre former for indberetninger end afbrud og 'Afbrud ifølge KUI'. | H |
9 | Afbrudsårsagskode og Afbrud | Afbrudsårsagskoden må ikke anvendes ved det angivne CØSA formål | Fejlen kan opstå, når der indberettes optagelsesprøver, og afbrudsårsagskoden ikke er beregnet til optagelsesprøve (kun kode 15-19 må anvendes), eller når der ikke indberettes om optagelsesprøver, men benyttes kode 15-19. | H |
10 | ForloebId | ForløbsId mangler | Ved 'Afbrud ifølge KUI' eller 'Risiko for frafald ifølge KUI' skal der medsendes identifikation af det forløb, KUI mener er berørt. | H |
13 | Afbrudsårsagskode og Afbrud | Afbrud ifølge KUI kan kun angives ved optag | Ved 'Afbrud ifølge KUI' skal Status være optag. | H |
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 |
16 | Status | Ugyldig statuskode | Kun status iht. liste i grænsefladebeskrivelsen er gyldig for indberetningen. | H |
30 | Kildeleverandør | Datakildebetegnelse format ikke gyldigt | Betegnelsen for kildekoden kendes ikke i UDB. | H |
62 | Dublet | Dublet | Der er registreret en indberetning, hvor følgende er identisk:
| H |
80 | Skoleperiode | Skoleperiode er ugyldig eller mangler | Skoleperioden mangler eller er ikke gyldig i forbindelse med FGU. | H |
81 | COSAFormaal | CØSA-formål må ikke anvendes for FGU aktivitet | Servicen kan kun anvendes til CØSA-formål 338. | H |
82 | EguUddannelsesbevis | Ikke lovlig skoleperiode og/eller speciale, når EguUddannelsesbevis er sand | EguUddannelsesbevis kan ikke sættes til 'True', med mindre den angivne skoleperiode kan forekomme, når der udstedes uddannelsesbevis på EGU. Yderligere skal specialet svare til EGU-sporet. | H |
83 | Speciale | Speciale er ugyldigt eller krævet på skoleperioden | Speciale er ugyldigt på FGU- uddannelsen eller krævet på den valgte skoleperiode. | H |
85 | EguUddannelsesbevis | EGU uddannelsesbevis kan kun tildeles på en gennemført uddannelse | Der må ikke angives ja til EguUddannelsesbevis, når der indberettes status optag og afbrud (kun ved gennemført) | H |
209 | Uddannelsesinstitutionkontaktnavn | Kontaktpersonnavn mangler | Kontaktpersonoplysninger er angivet, men mangler navn på kontakten. | B |
101 | exception - UDB | Intern fejl i UDB. | H |
Fejlkoder i forbindelse med behandling af indberetningen
Fejlnr. | Relateret attribut | Fejltekst | Forklaring | Blød fejl: B |
---|---|---|---|---|
12 | ForloebId | ForloebId er krævet og skal matche registreringer | Forløbidenten på indberetningen peger på et forløb, der ikke matcher indberetningen for så vidt angår CPR-nummer, hovedinstitution eller uddannelseskode. Dette er krævet for indberetninger om risiko for frafald og afbrud fra KUI. | H |
75 | ForloebId | Optag efter gennemført uddannelse ikke mulig | Uddannelsen er allerede gennemført. Dermed er indberetningen om optagelse afvist. Kræver annullering af hændelse for gennemført uddannelse inden anden status kan indberettes. Fejlen benyttes, hvis hændelsen ikke er historisk. | H |
213 | ForloebId | Nyt forløbid anvendt, da det indberettede forløbid ikke matcher et forløb på den unge | Forløbsidenten på indberetningen peger på et forløb, der ikke matcher indberetningen for så vidt angår CPR-nummer, hovedinstitution eller uddannelseskode, men der er ikke er krav om for løbs ident på denne indberetning. Der tildeles et nyt forløbsId. | B |
257 | ForloebId | Forløb mangler optag | Der forventes et optag, før der modtages et afbrud eller gennemførelse. | B |
264 | ForloebId | Der findes tidligere indberetning om afbrud ifølge KUI | Der er tidligere registreret afbrud ifølge KUI. | B |
265 | ForloebId | Der findes tidligere indberetning om afbrud, som bør annulleres | Der er tidligere registreret afbrud for forløbet. Afbruddet bør annulleres, hvis denne indberetning er korrekt. | B |
272 | ForloebId | Optag eller afbrud indberettet efter indberetning af gennemført forløb | Der er tidligere registreret, at forløbet er gennemført, hvilket harmonerer dårligt med, at der nu indberettes optag/afbrud. | B |
273 | ForloebId | Der er tidligere indberettet hændelse med senere registreringstid og eller hændelsesdato | Der er tidligere indberettet hændelse på forløbet med senere registreringstid og/eller hændelsesdato. | B |
Hårde fejl angives med numre op til og med 199.
...