Sidehistorik
...
IndberetningRequest indeholder alle data om den indberettede hændelse. Hændelser indberettes enkeltvis.
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). Bruges bl.a. til at sørge for, at valideringssvar sendes til korrekt system. | |
CPRNr | Integer (10) | Ja | Skal kunne findes i CPR-registeret | CPR-nummeret på den unge, som indberetningen vedrører. |
HaendelseNummer | String | Nej, men ja ved annullering | Unik id på indberetningen, såfremt indberetningen ikke afvises. | |
ForloebIdent | String | Nej | Se note 1. | 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 den tidligere integrationsplatform IP-UNG webservicen. |
InstitutionNummer | Integer(6) | Ja | Skal kunne genfindes i Institutionsregisteret | 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 eller gennemførelse, eller dato for risiko for frafald. |
Status | Integer(2) | Ja | Se note 3. | En kode, som beskriver status for den unges uddannelsesforløb (optaget, afbrudt og gennemført). |
AfbrudsaarsagsKode | Integer | Nej, men ja vedstatus 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. |
KildeLeverandoer | Varchar (20) | Ja | En betegnelse, der identificerer kildeleverandørens system. | |
Annullering | Boolean | Nej | False = nej | Markering af, at en tidligere indberetning skal annulleres (fejl-indberetning). |
Uddannelse (XML-element) | Uddannelse | Ja | ||
GennemfoertHf | Boolean | Nej | False = nej | Sættes til 'ja', når en ung samlet set har opnået et HF-bevis baseret på enkeltfag. |
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. |
UddannelsesinstitutionKontakt | XML-element | Nej | ||
ElevKontakt | XML-element | Nej | ||
PraktikSted | XML-element | Nej | ||
FrafaldstruetIfoelgeUUcenter | Boolean | Nej | True = Frafaldstruet | 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. |
AfbrudIfoelgeUUcenter | Boolean | Nej | False= 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. |
Note 1: ForløbId (ForloebIdent)
Et forløbId sammenkæder flere indberetninger om samme uddannelse til et samlet forløb for den unge. På den måde skabes der en relation i UDB fra optaget til afbrudt eller gennemført.
...
Note 2: Afbrudsaarsagskoder
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. I regnearket findes koderne under fanebladet AFBRUDSÅRSAGS_KODE.
Note 3: Status
Værdi | Betegnelse for status | Beskrivelse |
1 | Optaget | Den unge optages på et uddannelsesforløb (eller tilmeldes til en optagelsesprøve). 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 (eller optagelsesprøve). |
3 | Gennemført | Den unge har gennemført sit uddannelsesforløb (eller optagelsesprøve). |
Uddannelse
Tabellen Uddannelse indeholder oplysninger om den uddannelse, som den indberettede hændelse vedrører.
Felt | Type | Krævet | Lovlige værdier | Beskrivelse |
---|---|---|---|---|
COSAFormaal | Integer(4) | Ja | Skal kunne genfindes i CØSA-kodesættet (Uddannelsesmodellen) | Kode for ungdomsuddannelse fra CØSA. |
COSAFormaalVersion | Integer(4) | Nej | Skal kunne genfindes i CØSA-kodesættet (Uddannelsesmodellen) | Kode for ungdomsuddannelse versioneret fra CØSA. |
COSAFormaalSpeciale | String(4) | Nej | Skal kunne genfindes i CØSA-kodesættet (Uddannelsesmodellen) | Kode for ungdomsuddannelse (EUD) fra CØSA. |
UddannelsesinstitutionKontakt
UddannelsesinstitutionKontakt indeholder kontaktoplysninger for den relevante uddannelsesinstitution.
Felt | Type | Krævet | Lovlige værdier | Beskrivelse |
---|---|---|---|---|
Navn | String (500) | Ja | Kontaktpersonen på institutionen, hvis der indberettes risiko for frafald: navn på person. | |
Telefon | Integer(10) | Nej | Kontaktpersonen på institutionen, hvis der indberettes risiko for frafald: telefonnummer på person. | |
String(50) | Nej | Kontaktpersonen på institutionen, hvis der indberettes risiko for frafald: email-adresse på person. |
ElevKontakt
ElevKontakt indeholder kontaktoplysninger for den unge.
Felt | Type | Krævet | Lovlige værdier | Beskrivelse |
---|---|---|---|---|
Telefon | Integer(10) | Nej | Den unges telefonnummer. | |
String | Nej | Den unges mailadresse. |
PraktikSted
Praktiksted indeholder oplysninger om det praktiksted, som den unge er tilknyttet.
Felt | Type | Krævet | Lovlige værdier | Beskrivelse |
---|---|---|---|---|
Cvrnr | Integer(10) | Ja | Praktikpladsens/lære-stedets CVR-nummer. | |
Lbrnr | Integer(20) | Ja | Praktikpladsens/lære-stedets løbenummer. | |
Navn | String(50) | Ja | Praktikpladsens/lære-stedets navn. | |
Adresse | String(50) | Ja | Praktikpladsens/lære-stedets adresse. | |
Postnr | Integer(4) | Ja | Praktikpladsens/lærestedets postnummer. | |
Bynavn | String(30) | Ja | Praktikpladsens/lære-stedets bynavn/post-distrikt. | |
Telefon | Integer (10) | Nej | Praktikpladsens/lære-stedets telefon | |
String(50) | Ja | Praktikpladsens/lære-stedets mailadresse. | ||
Kontaktperson | String(50) | Ja | Praktikpladsens/lære-stedets kontaktperson identificeret ved navn. |
Struktur for IndberetningResponse
Ved indberetning returnerer webservicen følgende synkrone svar, såfremt der ikke opstår fejl i schemavalideringen i STIL's integrationsplatform.
IndberetningResponse
Felt | Type | Krævet | Lovlige værdier | Beskrivelse |
---|---|---|---|---|
HaendelseNummer | String | Ja | Unik ident, der identificerer indberetningen i UDB. |
Hvis der opstår fejl i schemavalideringen, 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: BHård fejl: H |
---|---|---|---|---|
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 | Kode for en af værdierne: Klassetrin, CØSA-formål, Jobcenter aktivitetstype, Jobcenter aktivitetskode, Aktivitetsgruppekode, SU uddannelseskode, PKAT (Etat kode) eller Forberedende aktivitetskode er ikke i liste over gyldige værdier. | H |
3 | Afbrudsårsagskode | Ugyldig afbrudsårsagskode | Kun årsagskoder iht. myndighedskrav er gyldig for indberetning. | H |
4 | Uddannelseskode | Uddannelseskoden ønskes ikke i Ungedatabasen | Aktiviteter med den anførte uddannelseskode ønskes ikke registreret i UDB. Indberetningen er ikke indlæst i UDB. | H |
5 | Institutionsnummer | Ukendt institutionsnummer | Institutionsnummeret findes ikke i Institutionsregisteret | H |
6 | Hændelsesdato | Hændelsesdatoen må ikke fremdateres | Hændelsesdatoen for gennemførsel/afbrud må ikke ligge efter registreringstiden for hændelsen. | H |
7 | Afbrudsårsagskode og Afbrud | Afbrudsårsagskode skal angives ved afbrud | Der skal angives en gyldig afbrudsårsag, når en ung afbryder sin uddannelse. | H |
8 | Afbrudsårsagskode og Afbrud | Afbrudsårsag angives kun ved afbrud | Afbrudsårsag kan ikke angives ved andre former for indberetninger end afbrud. | 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 1 samt 15-19 må anvendes), eller når der ikke indberettes om optagelsesprøver, men benyttes kode 15-19. | H |
10 | ForloebIdent | ForløbsId mangler | Ved 'Afbrud ifølge UU-center' eller 'Risiko for frafald ifølge UU-center' skal der medsendes identifikation af det forløb, KUI mener, er berørt. | H |
11 | Optagelsesprøve | Der kan ikke indberettes optagelsesprøve på unge over 25 | Der kan ikke indberettes optagelsesprøve på unge over 25 år. | 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 Ungedatabasen | 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 |
17 | Risiko for frafald | Risiko for frafald kan kun angives ved optag | Ved risiko for frafald skal Status være optag. | H |
30 | Kildeleverandør | Kildeleverandør ikke gyldigt | Betegnelsen for kildekoden kendes ikke i UDB. | H |
49 | Gennemført HF | Status skal være gennemført, og CØSA-formål skal være 3015 | Ved markering af gennemført HF for enkeltfag skal status på indberetningen være sat til Gennemført, og CØSA-formål skal være 3015. | H |
62 | Dublet | Dublet | Der er registreret en indberetning, hvor følgende er identisk:CPR-nummerInstitutionsnummerUddannelseskodeHændelsesdatoStatusSpeciale (hvis udfyldt).Registreringstiderne er ikke nødvendigvis identiske. Ved samtidig afbrud og gentilmelding på samme uddannelse, skal afbruddet registreres først. | H |
101 | Exception - UDB | Intern fejl i UDB. | H | |
209 | UddannelsesinstitutionKontaktnavn | Kontaktpersonnavn mangler | Kontaktpersonoplysninger er angivet, men der mangler navn på kontakten. | B |
Fejlkoder i forbindelse med behandling af indberetningen
Fejlnr. | Relateret attribut | Fejltekst | Forklaring | Blød fejl: B Hård fejl: H |
---|---|---|---|---|
12 | ForloebIdent | ForloebId er krævet og skal matche registreringer | Forløbsidenten på indberetningen peger på et forløb, der ikke matcher indberetningen for så vidt angår CPR-nummer, hovedinstitution eller uddannelseskode. Det er krævet for indberetninger om risiko for frafald og afbrud fra KUI. | H |
75 | ForloebIdent | 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 | ForloebIdent | 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 forløbsident på denne indberetning. Der tildeles et nyt forløbId. | B |
257 | ForloebIdent | Forløb mangler optag | Der forventes et Optag, før der modtages et afbrud eller gennemførelse. | B |
264 | ForloebIdent | Der findes tidligere indberetning om afbrud ifølge KUI | Der er tidligere registreret afbrud ifølge KUI. | B |
265 | ForloebIdent | 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 | ForloebIdent | 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 | ForloebIdent | Der er tidligere indberettet hændelse med senere registreringstid og/eller hændelsesdato, som er lig med eller senere | Der er tidligere indberettet hændelse på forløbet med senere registreringstid og/eller hændelsesdato, som er lig med eller senere end i den aktuelle indberetning. | B |
Hårde fejl angives med numre op til og med 199.
...