Webservicen anvendes til afhentning af FTU ansøgninger (Fælles Tilmelding til Ungdomsuddannelserne) til ungdomsuddannelser og 10. klasse. Ansøgningerne oprettes af 9. og 10. klasses elever i grundskolen eller uden for skole (UFS) ansøgere, som ikke går i grundskolen.
Én ansøgning til ét udbud af en uddannelse for én ansøger
Nedenfor illustreres de logiske sammenhænge I Optagelse.dk, og hvordan relationerne er mellem forretningsbegreberne.
En ansøger er en borger, som søger en ungdomsuddannelse på Optagelse.dk. Ansøgeren opretter en ansøgning til ét specifikt udbud af en uddannelse på ét uddannelsessted. Alt efter hvilket udbud ansøgeren søger skal der angives uddannelsesspecifikke informationer, som er afhængig af typen af uddannelse der udbydes. Oprettes der flere ansøgninger til det kommende skoleår angives der en indbyrdes prioritering for ansøgningerne, som angiver hvilken uddannelse og institution ansøgeren helst vil optages på (ansøgninger til indeværende skoleår prioriteres ikke). Til en ansøgning kan en ansøgere vedlægge ét eller flere bilag, som ansøger ønsker skal indgå i vurderingen af ansøgningen. Beviser vedlægges altid ansøgningen som et bilag, hvis de eksisterer i den nationale Karakterdatabasen fra 9. og 10. klasse, samt hvis der eksistere beviser på gymnasial niveau i den nationale Eksamensdatabase.
Endpoints
Miljø | Endpoint på IPL (WSDL + XSD) | Beskrivelse |
---|---|---|
Prod | v1.5 https://integrationsplatformen.dk/services/Optagelsedk/ftuAnsoegning/v1.5 (https://integrationsplatformen.dk/services/Optagelsedk/ftuAnsoegning/v1.5?wsdl) v1.4 lukkes 15. november 2023 - anvend 1.5. https://integrationsplatformen.dk/services/Optagelsedk/ftuAnsoegning/v1.4 (https://integrationsplatformen.dk/services/Optagelsedk/ftuAnsoegning/v1.4?wsdl) v1.2 lukkes 15. november 2023 - anvend 1.5. https://integrationsplatformen.dk/services/Optagelsedk/ftuAnsoegning/v1.2 (https://integrationsplatformen.dk/services/Optagelsedk/ftuAnsoegning/v1.2?wsdl) | Hent FTU ansøgninger. v1.5 - Ny bilagstype til Karakteroversigt, godkendelsesstatus på forrang, videresendelse af ansøgninger. v1.4 - Rettidighed, bopælsland (sms-ansøger), anden aktivitet og forrang tilføjet. Statusmodel ændret. v1.2 - SMS-ansøger uden CPR, Uddannelsesparathedsvurdering, Ansøgers nuværende institution, Studievalgsportfolio. |
Eksternt Testmiljø (ET/INT) | v1.6 https://et.integrationsplatformen.dk/services/Optagelsedk/ftuAnsoegning/v1.6?wsdl v1.5 https://et.integrationsplatformen.dk/services/Optagelsedk/ftuAnsoegning/v1.5 (https://et.integrationsplatformen.dk/services/Optagelsedk/ftuAnsoegning/v1.5?wsdl) v1.4 lukkes 15. november 2023 - anvend 1.5. https://et.integrationsplatformen.dk/services/Optagelsedk/ftuAnsoegning/v1.4 (https://et.integrationsplatformen.dk/services/Optagelsedk/ftuAnsoegning/v1.4?wsdl) v1.2 lukkes 15. november 2023 - anvend 1.5. https://et.integrationsplatformen.dk/services/Optagelsedk/ftuAnsoegning/v1.2 (https://et.integrationsplatformen.dk/services/Optagelsedk/ftuAnsoegning/v1.2?wsdl) | Hent FTU ansøgninger. v1.6 - Fødselsdato, personstatus, flere årsager for videresend, fritaget for upv, hent bilag med zip er fjernet, mv. v1.5 - Ny bilagstype til Karakteroversigt, godkendelsesstatus på forrang, videresendelse af ansøgninger. v1.4 - Rettidighed, bopælsland (sms-ansøger), anden aktivitet og forrang tilføjet. Statusmodel ændret. v1.2 - SMS-ansøger uden CPR, Uddannelsesparathedsvurdering, Ansøgers nuværende institution, Studievalgsportfolio. |
Adgang
Webservicen kan anvendes af studieadministrative systemer, som er under systemrevision.
Den er tilgængelig på STILs Integrationsplatform (IPL) og adgangsstyringen til data sker via STILs Tilslutningssystem. Har dit system ikke tidligere anvendt Integrationsplatformen? Så læs her, hvordan du kommer i gang. Når der anmodes om adgang, skal det kort beskrives hvad formålet med adgangen er, hvilke opgave systemet der skal integrer løser og hvad det bruges til.
To webservices
Webservicen ftuAnsoegning, der beskrives på denne side, anvendes til at hente ansøgninger til en given institution. Hvis der derimod skal hentes ansøgninger for en kommune til den kommunale ungeindsats, skal webservicen ftuKUIAnsoegning anvendes. Læs mere om webservicen her: Hent ansøgninger for en kommune (KUI)
Brug af webservicen
Webservicen består af en række metoder, der samlet gør det muligt at hente alle ansøgninger for en hovedinstitution eller en afdeling.
For at kunne anvende webservicen korrekt, er det vigtigt at kalde med det rigtige institutionsnummer. Læs mere om de forskellige institutionstyper her: Beskrivelse af institutioner
Metoder på webservicen
- echo()
- Tester forbindelsen til webservicen og leverer en OK ved succes.
- Returnerer en kode 200 = "Forbindelse oprettet" eller en 500 = "Forbindelse ikke oprettet"
Sekvens diagrammer
Betydning af status på ansøgning
Status i webservice | Betydning | SA-systemer |
---|---|---|
AfventerFordeling | Ansøgningen afventer regionens eller elevfordelingsalgoritmens fordeling. | Får prioritet 1. ansøgninger. Vil kun være gym/hf ansøgninger. |
Tildelt | Ansøgeren er tildelt plads på ansøgningen af regionen. | Får alle ansøgninger |
TilBehandling | Ansøgningen er klar til behandling på institutionen. | Får prioritet 1. ansøgninger og videresendte ansøgninger. |
IkkeAktuel | Ansøgningen er trukket tilbage og er pt. ikke længere relevant for institutionen. Det kan fx ske ved:
Ansøgningen kan dog blive aktuel igen på et senere tidspunkt. | Får id'erne på de ansøgninger institutionen tidligere har kunne hente. Selve ansøgningen og tilhørende bilag kan ikke længere hentes. |
Videresendt | Ansøgningen er videresendt af institutionen selv på Optagelse.dk ifm. videresendelse af ansøgningen til en lavere prioritet. | |
Slettet | Ansøgningen er slettet af ansøgeren og bliver dermed ikke aktuelt igen på et senere tidspunkt. |
Felter i svar fra webservicen
Se beskrivelse af de properties, der returneres for ansøgningen: Properties for en ansøgning
Testvejledning og testdata til ny webservice
For at teste den nye webservice er der oprettet en testvejledning, samt en beskrivelse af tilgængeligt testdata.
Se testvejledning og testdata: Hent ansøgninger for en institution
Mapning af felter mellem ny webservice og felter i nuværende webservice
I nedenstående tabel er properties fra den nuværende webservice FtuApplicationService og properties fra den nye webservice FtuAnsoegning beskrevet mod hinanden.
Hvis en property fra den nuværende FtuApplicationService ikke kan findes i tabellen, er det fordi den ikke eksistere i den nye FtuAnsoegning. Nogle felter i kolonnen Property i FtuApplicationService er noteret med Findes ikke, hvilket betyder, at det er en ny indført property som ikke er tilstede i eksisterende webservice.
Property i | Property i |
---|---|
Ansoegninger/ | |
Ansoegning xsi:type= | Findes ikke |
AnsoegningId | FtuApplicationId |
Oprettet | CreatedDate |
Underskrevet | Findes ikke |
OpdateretDato | ModifiedDate |
Status | State |
Prioritet | PriorityNumber |
AnsoegerUnderskrevet + ForaeldermyndighedEtUnderskrift + ForaeldermyndighedToUnderskrift | |
UnderskriverCpr | SignatureName |
UnderskriftTidspunkt | SignatureDate |
Ansoeger | |
Cpr | CivilRegistrationNumber |
CPR_UUID | Findes ikke |
Navn | PersonGivenName + PersonSurnameName |
Adresse | StreetAddress |
Postnummer | postalCode |
By | PostalDistrict |
Kommunekode | MunicipalityName |
NavneOgAdresseBeskyttelse | IsProtected |
EmailAddress | |
Telefon | PhoneNumber |
\Ansoeger | |
UddannelsesUdbud xsi:type= | Findes ikke |
StudieStart | StudyStartDate |
SkoleAar | SchoolYear |
EjerInstitution | |
Navn | InstitutionName |
InstitutionsNr | InstitutionNumber |
UndervisningsInstitution | Findes ikke |
AnsoegningsInstitution | Findes ikke |
CoesaFormaal | |
CoesaformaalBetegnelse | Coesa |
Betegnelse | Findes ikke |
EudGf1UddannelsesUdbud + EudGf2UddannelsesUdbud + EudGfPlusUddannelsesUdbud | |
OnlineForloeb | Findes ikke |
EUXTilbydes | Findes ikke |
EUXObligatorisk | Findes ikke |
FagRetning | SubjectAreaName |
InternationalebUddannelsesUdbud | |
Hovedomraade | MainObjective |
\UddannelsesUdbud | |
ForaeldremyndighedsindehaverBase + Foraeldremyndighedsindehaver + ForaeldremyndighedsindehaverHarUnderskrevet | |
Foraeldremyndighedsindehaver xsi:type= | Findes ikke |
Cpr | CivilRegistrationNumber |
Navn | PersonGivenName + PersonSurnameName |
EmailAddress | |
Telefon | PhoneNumber |
NavneOgAdresseBeskyttelse | IsProtected |
Bilag | |
Id | Findes ikke |
OriginalFilnavn | ApplicantsEnclosureName |
UploadDatoTid | Findes ikke |
Filtype | Findes ikke |
Type | Findes ikke |
Filkilde | EnclosureType |
UniktFilnavn | EnclosureName |
Ansoegning xsi:type="stx" | |
KunstneriskFag1 | ArtisticSubject |
FremmedSprog | ForeignLanguageSubjec |
Ansoegning xsi:type="ToAarigStx" | |
FremmedSprog | ForeignLanguageSubjec |
StudieretningsFag | Category |
Ansoegning xsi:type="EudGf1"+ "EudGf2" | |
EuxValgt | EUXSelected |
Ansoegning xsi:type="Hf" | |
KunstneriskFag1 | ArtisticSubjectAndSportsFirstPriority |
KunstneriskFag2 | ArtisticSubjectAndSportsSecondPriority |
Ansoegning xsi:type="Hhx" | |
FremmedSprog | ForeignLanguageSubject |
\ansoegning |