Du ser en gammel version af denne side. Se den nuværende version.

Sammenlign med nuværende Vis sidehistorik

« Forrige Version 3 Næste »

Introduktion

Dette er en forretningsmæssigbeskrivelse af EDUP AMU udlån. Formålet er understøtte udvekslingen af data mellem skoler i forbindelse med udlån af AMU godkendelser. Den data, der udveksles, anvendes at skolerne til indberetning af tilskudsudløsende aktiviteter. 

Processen for udlån af AMU godkendelser  via EDUP mellem afholdende og godkendte skole indeholder to overordnede procestrin og fire subbeskedtyper.

  • Anmodning om AMU udlån og svar 
  • Indberetning af AMU udlån og svar 
SubbeskedtypeBemærkning
Anmodning om AMU udlånStarter beskedudvekslingen og angiver SagsID
Svar på anmodning om AMU udlånSvar på anmodning
Inberetning af AMU udlånIndberetning til godkendte skole
Svar på indberetning af AMU udlånTeknisk svar på indberetning


"Anmodning om AMU" udlån starter en sag, således at det EDUPID, der tildeles denne besked, anvendes som gennemgående SagsID i de efterfølgende beskeder. SagsID har dermed den samme værdi i hele besked-kæden, hvorimod EDUPID tælles op for hver fremsendte besked, idet denne værdi er unik for den enkelte EDUP-besked.

EDUP påtvinger ikke anvenderne nogen besked-rækkefølge, idet er op til modtager-systemet at bestemme, hvilke beskeder der afhentes i EDUP i hvilken rækkefølge og hvornår disse behandles.

Besked-struktur

Anmodning om AMU udlån

Denne subbeskedtype starter en sag mellem den afholdende skole og den godkendte skole omkring indberetning af AMU udlån.
Subbeskedtypen “Anmodning om AMU udlån” er den eneste beskedtype, der kan starte en sag omkring indberetning AMU udlån. Ved efterfølgende beskeder anvendes EDUPID fra denne anmodning som værdien i SagsID i efterfølgende beskeder.

Beskeder med subbeskedtypen “Anmodning om AMU udlån” kan udelukkende sendes til den godkendte skole.

Anmodning om AMU udlån

TagNiveauTypeObligatoriskBeskrivelse
AfholdendeSkole
1Integer(6)
JaInstitutionsnummer på den afholdende skole
GodkendteSkole
1Integer(6)
JaInstitutionsnummer på den godkendte skole
Indberetningskvartal110 tegnJaKvartalet, indberetningen tilhører
Kontaktperson1100 tegnNejKontaktperson på gennemførende skole
Eksempel: Anmodning om AMU udlån
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:v1="http://stil.dk/ipung/services/edup/v1.0">
   <soap:Header/>
   <soap:Body>
      <v1:SendBesked>
         <v1:Modtager>
            <v1:ModtagerSystemID>Test</v1:ModtagerSystemID>
            <v1:ModtagerSystemTransaktionsID>Test-transID</v1:ModtagerSystemTransaktionsID>
         </v1:Modtager>
         <v1:BeskedKuvert>
            <v1:AfsenderGUID>tester01</v1:AfsenderGUID>
            <v1:Versionsnummer>testV-1.0</v1:Versionsnummer>
            <v1:Kaldstidspunkt>2019-04-08T16:05:00</v1:Kaldstidspunkt>
            <v1:Modtager>654321</v1:Modtager>
            <v1:Beskedtype xsi:type="ns347:AmuudlaanBeskedtype" xmlns:ns347="http://stil.dk/ipung/services/edup/common/types/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">Amuudlaan</v1:Beskedtype>
            <v1:Subbeskedtype xsi:type="ns347:AnmodningomamuudlaanSubbeskedtype" xmlns:ns347="http://stil.dk/ipung/services/edup/common/types/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">Anmodning om AMU udlaan</v1:Subbeskedtype>
         </v1:BeskedKuvert>
         <v1:BeskedData xsi:type="Anmodningomamuudlaan" xmlns="http://stil.dk/ipung/services/edup/amuudlaan/types/v1.0" xmlns:ns2="http://stil.dk/ipung/services/edup/common/types/v1.0" xmlns:ns3="http://stil.dk/ipung/services/edup/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
            <AfholdendeSkole>123456</AfholdendeSkole>
            <GodkendteSkole>654321</GodkendteSkole>
            <Indberetningskvartal>Q3 2019</Indberetningskvartal>
            <Kontaktperson>Navn Navnsen</Kontaktperson>
         </v1:BeskedData>
      </v1:SendBesked>
   </soap:Body>
</soap:Envelope>


Svar på anmodning om AMU udlån

Subbeskedtypen “Svar på anmodning om AMU udlån” indeholder svaret fra den godkendte skole på, hvorvidt anmodningen om AMU udlån fra den afholdende skole kan accepteres eller ej.

Returneres der fejl i tagget FejlModtagneData, betyder det at modtageren ikke er i stand til at læse de modtagne data. 

Beskeder med subbeskedtypen “Svar på anmodning om AMU udlån” kan udelukkende sendes til den afholdende skole.

Svar på anmodning om AMU udlån

TagNiveauTypeObligatoriskBeskrivelse
AfholdendeSkole
1Integer(6)JaInstitutionsnummer på den afholdende skole
GodkendteSkole
1Integer(6)
JaInstitutionsnummer på den godkendte skole
FejlModtagneData1
JaEt tag til at pakke de følgende to tags ind
Fejlkode220 tegnJaVærdier vælges af afsender, bortset fra fejlkoden OK, hvor den tilhørende fejltekst også er OK
Fejltekst22000 tegnJaVærdier vælges af afsender. Det kan fx være ”Indberetnings-kvartal findes ikke”
Svar1
NejEt tag til at pakke det følgende tag ind. Tagget Svar vil kun være udfyldt, hvis værdien i tagget Fejlkode ovenfor er OK.
SvarAnmodning21 tegnJaDette tag er indlejret i Svar tag. Værdierne eller kan angives.
Eksempel: Svar på anmodning om AMU udlån
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:v1="http://stil.dk/ipung/services/edup/v1.0">
   <soap:Header/>
   <soap:Body>
      <v1:SendBesked>
         <v1:Modtager>
            <v1:ModtagerSystemID>Test</v1:ModtagerSystemID>
            <v1:ModtagerSystemTransaktionsID>Test-transID</v1:ModtagerSystemTransaktionsID>
         </v1:Modtager>
         <v1:BeskedKuvert>
            <v1:AfsenderGUID>tester02</v1:AfsenderGUID>
            <v1:Versionsnummer>testV-1.0</v1:Versionsnummer>
            <v1:Kaldstidspunkt>2019-04-08T16:05:00</v1:Kaldstidspunkt>
            <v1:Modtager>123456</v1:Modtager>
            <v1:Beskedtype xsi:type="ns347:AmuudlaanBeskedtype"
                           xmlns:ns347="http://stil.dk/ipung/services/edup/common/types/v1.0"
                           xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">Amuudlaan</v1:Beskedtype>
            <v1:Subbeskedtype xsi:type="ns347:SvarPaAnmodningomamuudlaanSubbeskedtype"
                              xmlns:ns347="http://stil.dk/ipung/services/edup/common/types/v1.0"
                              xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">Svar på anmodning om AMU udlaan</v1:Subbeskedtype>
            <v1:SagsID>1234</v1:SagsID>
            <v1:ReferenceGUID>TestGUID</v1:ReferenceGUID>
         </v1:BeskedKuvert>
         <v1:BeskedData xsi:type="Svarpaaanmodningomamuudlaan"
                        xmlns="http://stil.dk/ipung/services/edup/amuudlaan/types/v1.0"
                        xmlns:ns2="http://stil.dk/ipung/services/edup/common/types/v1.0"
                        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
            <AfholdendeSkole>123456</AfholdendeSkole>
            <GodkendteSkole>654321</GodkendteSkole>
            <FejlModtagneData>
               <ns2:Fejlkode>OK</ns2:Fejlkode>
               <ns2:Fejltekst>OK</ns2:Fejltekst>
            </FejlModtagneData>
            <Svar>
               <SvarAnmodning>J</SvarAnmodning>
            </Svar>
         </v1:BeskedData>
      </v1:SendBesked>
   </soap:Body>
</soap:Envelope>


Indberetning af AMU udlån

Når den godkendte skole har svaret positivt på den afholdende skoles anmodning om AMU udlån, kan den afholdende skole danne en AMU aktivitetsindberetning i subbeskedtypen “Indberetning af AMU udlån”.

Beskedtypen kan sendes flere gange, fx hvis den afholdende skole opdager ændringer efter at have sendt en indberetning til den godkendte skole. Indholdet af en indberetning af AMU udlån vil altid være en total, og dermed afspejle øjebliksbilledet i afsendersystemet. Det betyder, at det er op til modtagersystemet at udlede ændringer i forhold til evt. tidligere fremsendte indberetninger, og at det altid er den nyeste, modtagne indberetning, der er retvisende.

Der skelnes i denne sammenhæng ikke imellem indberetning og supplerende indberetning. En supplerende indberetning fra den afholdende skole vil altid blot betegnes som en indberetning. Hvis en sådan indberetning fra den afholdende skole modtages efter at den godkendte skole har indberettet den endelige AMU-aktivitet til CØSA, er det op til den godkendte skole at skelne imellem modtagne indberetningsdata, der allerede ER indberettet til CØSA og modtagne indberetningsdata, der IKKE allerede er indberettet til CØSA. Det er ligeledes den godkendte skole, der danner og indsender en supplerende indberetning til CØSA baseret på de modtagne og evt. egne ændrede indberetningsdata.


Hver indberetning er en total, derfor er det den godkendte skoles ansvar at skelne imellem hvornår der er tale om indberetnings-data, der skal anvendes i en endelig indberetning og supplerende indberetnings-data.
Beskeder med subbeskedtypen “Indberetning af AMU-aktivitet” kan kun sendes til den godkendte skole.

Indberetning af AMU udlån

TagNiveauTypeObligatoriskBeskrivelse
AfholdendeSkole
1Integer(6)JaInstitutionsnummer på den afholdende skole
GodkendteSkole
1Integer(6)
JaInstitutionsnummer på den godkendte skole
IndberetningListe1
JaEt tag til at pakke de følgende tags ind. Beskeden kan indeholde flere indberetninger
Indberetning2
Ja (Unbounded)Et tag til at pakke de følgende tags ind
Afdeling3Integer(6)JaUVM-afdeling på gennemførende skole
Uddannelse3
JaEt tag til at pakke de følgende tags ind
CoesaFormaal
44 tegnJaCØSA-formål for uddannelsen
UddannelseVersion
4Integer(4)JaVersion for uddannelsen
Fag3
JaEt tag til at pakke de følgende tags ind
FagNummer4Integer(5)
JaUVM-fagkode for faget
Niveau41 tegnJaNiveau for faget
Tmk35 tegnJaTilskudsmærkekombination for faget
VarighedDage3Decimal(4,1)JaVarighed for den afholdte undervisning
Rekvirenttype34 tegnJaRekvirent/rekvirenttype (UVM, kommune etc.) der har rekvireret uddannelsesaktiviteten
Bidrag3Decimal(12,5)JaAfholdt undervisningsaktivitet mål i årselever eller antal, alternativt også udgiftsbeløb
AntalElever3Integer(6)JaAntal elever, der har deltaget i undervisningen
Betalingsstatus32 tegnJaStatus for deltagerbetaling
Startdato3DatoNejKursistens startdato på holdet
RevisionsoplysningerListe3
NejEt tag til at pakke de følgende tags ind. Indberetningen kan indeholde flere revisionsoplysninger.
Revisionsoplysninger4
Nej (unbounded)Et tag til at pakke de følgende tags ind
CPRNummer410 tegnJa
Kursistens CPR-nummer
Betalingsstatus42 tegnJa
Status for kursistens deltagerbetaling
TilstededagListe4
JaEt tag til at pakke de følgende tags ind. Indberetningen kan indeholde oplysninger om flere tilstededage.
Tilstededag5
Ja (unbounded)Et tag til at pakke de følgende tags ind
Tilstededato6DatoJaDato hvor kursisten har været til stede på kurset
Timer64 tegnNejAntal timer kursisten har været til stede på kursusdatoen. Decimaltal angives med komma.
TimerFravaer64 tegnNejAntal timer kursisten har været fraværende på kursusdatoen. Decimaltal angives med komma.
Eksempel: Indberetning af AMU udlån
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:v1="http://stil.dk/ipung/services/edup/v1.0">
   <soap:Header/>
   <soap:Body>
      <v1:SendBesked>
         <v1:Modtager>
            <v1:ModtagerSystemID>Test</v1:ModtagerSystemID>
            <v1:ModtagerSystemTransaktionsID>Test-transID</v1:ModtagerSystemTransaktionsID>
         </v1:Modtager>
         <v1:BeskedKuvert>
            <v1:AfsenderGUID>tester01</v1:AfsenderGUID>
            <v1:Versionsnummer>testV-1.0</v1:Versionsnummer>
            <v1:Kaldstidspunkt>2020-06-02T00:00:00.000+01:00</v1:Kaldstidspunkt>
            <v1:Modtager>654321</v1:Modtager>
            <v1:Beskedtype xsi:type="ns462:AmuudlaanBeskedtype" xmlns:ns462="http://stil.dk/ipung/services/edup/common/types/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">Amuudlaan</v1:Beskedtype>
            <v1:Subbeskedtype xsi:type="ns957:IndberetningafamuudlaanSubbeskedtype" xmlns:ns957="http://stil.dk/ipung/services/edup/common/types/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">Indberetning af AMU udlaan</v1:Subbeskedtype>
            <v1:SagsID>1234</v1:SagsID>
            <v1:ReferenceGUID>TestGUID</v1:ReferenceGUID>
         </v1:BeskedKuvert>
         <v1:BeskedData xsi:type="ns654:Indberetningafamuudlaan" xmlns:ns682="http://stil.dk/ipung/services/edup/elevudlan/types/v1.0" xmlns:ns654="http://stil.dk/ipung/services/edup/amuudlaan/types/v1.0" xmlns:ns392="http://stil.dk/ipung/services/edup/elevdeling/types/v1.0" xmlns:ns978="http://stil.dk/ipung/services/edup/elevflytning/types/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
   <ns654:AfholdendeSkole>123456</ns654:AfholdendeSkole>
   <ns654:GodkendteSkole>654321</ns654:GodkendteSkole>
   <ns654:IndberetningListe>
      <ns654:Indberetning>
         <ns654:Afdeling>123456</ns654:Afdeling>
         <ns654:Uddannelse>
            <v11:CoesaFormaal xmlns:v11="http://stil.dk/ipung/services/edup/common/types/v1.0">4123</v11:CoesaFormaal>
            <v11:UddannelseVersion xmlns:v11="http://stil.dk/ipung/services/edup/common/types/v1.0">1234</v11:UddannelseVersion>
         </ns654:Uddannelse>
         <ns654:Fag>
            <v11:FagNummer xmlns:v11="http://stil.dk/ipung/services/edup/common/types/v1.0">123</v11:FagNummer>
            <v11:Niveau xmlns:v11="http://stil.dk/ipung/services/edup/common/types/v1.0">B</v11:Niveau>
         </ns654:Fag>
         <ns654:Tmk>3123</ns654:Tmk>
         <ns654:VarighedDage>2.0</ns654:VarighedDage>
         <ns654:Rekvirenttype>UVM</ns654:Rekvirenttype>
         <ns654:Bidrag>1234,56</ns654:Bidrag>
         <ns654:AntalElever>2</ns654:AntalElever>
         <ns654:Betalingsstatus>01</ns654:Betalingsstatus>
         <ns654:Startdato>2020-06-23+02:00</ns654:Startdato>
         <ns654:RevisionsoplysningerListe>
            <ns654:Revisionsoplysninger>
               <ns654:CPRNummer>1111111111</ns654:CPRNummer>
               <ns654:Betalingsstatus>01</ns654:Betalingsstatus>
               <ns654:TilstededagListe>
                  <ns654:Tilstededag>
                     <ns654:Tilstededato>2020-06-23+02:00</ns654:Tilstededato>
                     <ns654:Timer>4</ns654:Timer>
                     <ns654:TimerFravaer>?</ns654:TimerFravaer>
                  </ns654:Tilstededag>
               </ns654:TilstededagListe>
            </ns654:Revisionsoplysninger>
         </ns654:RevisionsoplysningerListe>
      </ns654:Indberetning>
   </ns654:IndberetningListe>
</v1:BeskedData>
      </v1:SendBesked>
   </soap:Body>
</soap:Envelope>

Svar på indberetning af AMU udlån

Hvis den godkendte skole ikke finder fejl i de tilsendte data, returneres “OK” i fejlkode og besked om at indberetningen er accepteret ved at angive teksten “ACCEPTERET” i feltet SvarIndberetning.

Hvis den godkendte skole modtager en "indberetning af AMU udlån", med data i indberetningen som den ikke kan læse, skal der sendes et svar herom. I disse tilfælde sendes en besked med subbeskedtype ”Svar på indberetning af AMU udlån” tilbage til afsenderen, hvor der er angivet en fejlkode/fejltekst, der er forskellig fra OK og, at indberetningen er afvist ved at angive teksten “AFVIST” i feltet SvarIndberetning. 

Beskeder med subbeskedtypen “Svar på indberetning af AMU-aktivitet” kan udelukkende sendes til den afholdende skole.

Svar på indberetning af AMU udlån

TagNiveauTypeObligatoriskBeskrivelse
AfholdendeSkole
1Integer(6)
JaInstitutionsnummer på den afholdende skole
GodkendteSkole
1Integer(6)
JaInstitutionsnummer på den godkendte skole
FejlModtagneData1
JaEt tag til at pakke de følgende to tags ind
Fejlkode220 tegnJaVærdier vælges af afsender, bortset fra fejlkoden OK, hvor den tilhørende fejltekst også er OK
Fejltekst22000 tegnJaVærdier vælges af afsender. Det kan fx være ”Det angivne CØSA-formål findes ikke”
Svar1
NejEt tag til at pakke det følgende tag ind. Tagget Svar vil kun være udfyldt, hvis værdien i tagget Fejlkode ovenfor er OK.
SvarIndberetning210 tegnJaDette tag er indlejret i Svar tag. Værdierne ACCEPTERET eller AFVIST kan angives.
Eksempel: Svar på indberetning af AMU udlån
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:v1="http://stil.dk/ipung/services/edup/v1.0">
   <soap:Header/>
   <soap:Body>
      <v1:SendBesked>
         <v1:Modtager>
            <v1:ModtagerSystemID>Test</v1:ModtagerSystemID>
            <v1:ModtagerSystemTransaktionsID>Test-transID</v1:ModtagerSystemTransaktionsID>
         </v1:Modtager>
         <v1:BeskedKuvert>
            <v1:AfsenderGUID>tester02</v1:AfsenderGUID>
            <v1:Versionsnummer>testV-1.0</v1:Versionsnummer>
            <v1:Kaldstidspunkt>2019-04-08T16:05:00</v1:Kaldstidspunkt>
            <v1:Modtager>123456</v1:Modtager>
            <v1:Beskedtype xsi:type="ns347:AmuudlaanBeskedtype" xmlns:ns347="http://stil.dk/ipung/services/edup/common/types/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">Amuudlaan</v1:Beskedtype>
            <v1:Subbeskedtype xsi:type="ns347:SvarPaIndberetningafamuudlaanSubbeskedtype" xmlns:ns347="http://stil.dk/ipung/services/edup/common/types/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">Svar på indberetning af AMU udlaan</v1:Subbeskedtype>
            <!--Optional:-->
            <v1:SagsID>1234</v1:SagsID>
            <!--Optional:-->
            <v1:ReferenceGUID>TestGUID</v1:ReferenceGUID>
         </v1:BeskedKuvert>
         <v1:BeskedData xsi:type="Svarpaaindberetningafamuudlaan" xmlns="http://stil.dk/ipung/services/edup/amuudlaan/types/v1.0" xmlns:ns2="http://stil.dk/ipung/services/edup/common/types/v1.0" xmlns:ns3="http://stil.dk/ipung/services/edup/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
            <AfholdendeSkole>123456</AfholdendeSkole>
            <GodkendteSkole>654321</GodkendteSkole>
            <FejlModtagneData>
                  <ns2:Fejlkode>OK</ns2:Fejlkode>
                  <ns2:Fejltekst>OK</ns2:Fejltekst>
            </FejlModtagneData>
            <Svar>
                  <SvarIndberetning>ACCEPTERET</SvarIndberetning>
            </Svar>
         </v1:BeskedData>
      </v1:SendBesked>
   </soap:Body>
</soap:Envelope>


Fejlkoder

Dette afsnit indeholder en beskrivelse af fejlkoder, som EDUP stiller til rådighed som en fælles standard for de mest almindeligt forekommende fejl i forbindelse med indberetning af AMU udlån.

Fejlkoderne i indeværende afsnit supplerer de allerede definerede fejlkoder/-tekster for EDUP.

Fejlkoder i EDUP
FejlkodeFejltekst
EDUPINST-140Indberetnings-kvartal findes ikke
EDUPINST-141Der er tidligere indberettet for dette indberetnings-kvartal på et andet SagsID
EDUPINST-142Indberetnings-kvartal er forskelligt fra tidligere angivet indberetnings-kvartal
EDUPINST-143UVM-afdeling ukendt
EDUPINST-144UVM-afdeling ikke tilknyttet gennemførende institution på indberetningsperiodens slutdato
EDUPINST-145UVM-afdelingen er ikke gyldig på indberetningsperiodens slutdato
EDUPINST-146UVM-faget er ikke gyldigt i FKB-en på indberetningsperiodens slutdato
EDUPINST-147Skolen er ikke godkendt til UVM-faget på indberetningsperiodens slutdato
EDUPINST-148Holdet eller skolefaget overlapper et årsskifte
EDUPINST-149TMK ukendt
EDUPINST-150TMK ikke gyldig på indberetningsperiodens slutdato
EDUPINST-151Rekvirenttype ukendt
EDUPINST-152Rekvirent ikke gyldig på indberetningsperiodens slutdato
EDUPINST-152Bidrag ikke angivet som antal elever selvom TMK opgørelsesmetode er antal