Dokumentoplysninger

Ændringshistorik

Arkiveret ændringshistorik

Indhold

Indledning

Dette dokument beskriver strukturen for de AMU-bevisoplysninger, som institutioner og andre kan afhente fra AMU-bevisarkivet.

Det fremgår af de AMU-vejledninger, der var gældende frem til d. 27/3 2019, at "Uddannelsesbeviser registreres i en database i det administrative system EASY. Hvis et uddannelsesbevis bliver væk for en tidligere deltager, kan alle erhvervsskoler udskrive et nyt bevis på baggrund af oplysning om deltagerens personnummer, og institutionerne har pligt til at imødekomme sådanne forespørgsler." (VEJ nr. 10847 af 09/09/2015 https://www.retsinformation.dk/eli/retsinfo/2015/10847).

I forbindelse med afviklingen af EASY-A blev bevisoplysningerne flyttet til AMU-bevisarkivet, så udskrivningen kan ske fra det studieadministrative system, erhvervsskolen anvender til administration af arbejdsmarkedsuddannelser.

Hvem kan afhente og rette?

Uddannelsesinstitutioner, som gennemfører arbejdsmarkedsuddannelser og enkeltfag i fælles kompetencebeskrivelser, kan afhente bevisoplysninger samt PDF-udgave af bevis.

Det er muligt for den institution, der oprindeligt har udstedt et bevis, at rette i eller slette oplysninger om beviset i AMU-bevisarkivet.

Oplysninger kan også afhentes til brug i Min Kompetencemappe og af andre interessenter fx kompetencefonde. Udskrivning af beviser kan kun ske fra en uddannelsesinstitution.

Principper for AMU-bevisarkivet

Alle transaktioner i forhold til AMU-bevisarkivet sker for én person (CPR-nummer) af gangen. Det er derfor ikke muligt at lave opslag på flere personer i en enkelt forespørgsel.

AMU-bevisarkivet giver mulighed for følgende operationer:

1. Hent oversigt for person (HentAMUbeviser)
   Henter en liste over de kurser, der findes i AMU-bevisarkivet for en given person. Der kan kun hentes for én person af gangen. Det er muligt at afgrænse yderligere fx til periode og institution. Alle transaktioner påbegyndes med afhentning af liste for at hente bevis id'er.
2. Hent PDF med kursusbevis (HentPDFforAMUbevis)
   Henter en PDF-fil med et bevis for et kursus.
3. Ret bevisdata for person (RetAMUbevis)
   Giver den institution, der har udstedt det oprindelige bevis, mulighed for at ændre i bevisdata
4. Slet bevisdata for person (RetAMUbevis)
   Giver den institution, der har udstedt det oprindelige bevis, mulighed for at slette beviset.

Kontakt webservice

Kontakt til AMU-bevisarkivet sker ved kald fra det studieadministrative system til en webservice udstillet på STIL's integrationsplatform.

Afhængigt af opsætningen af det studieadministrative system skal enten den enkelte uddannelsesinstitution eller leverandøren af kildesystemet forinden indgå en tilslutningsaftale med STIL via STIL's tilslutningssystem: https://tilslutning.stil.dk/.

Det er også via tilslutningssystemet, at dataadgange administreres (leverandør) og godkendes (kunde/institution).

Ved hvert kald bliver den kaldende part autentificeret og autoriseret inden viderestilling til AMU-bevisarkivet.

De services, der giver mulighed for at udskrive, rette eller slette, kan kun kaldes på vegne af institutioner, der har (eller har haft) godkendelse til afholdelse af AMU kurser. Dette valideres i AMU-bevisarkivet.

Produktionsmiljø

Webservicen kaldes via STIL's integrationsplatform (Integrationsplatformen).

Integrationsplatformen er knudepunktet for STIL's eksternt rettede webservices. Den er en ren infrastrukturkomponent, som via autentificering, autorisering, logning og kryptering (https) understøtter en sikker, ensartet og effektiv udveksling af data mellem STIL's centrale systemer og eksterne systemer.

Integrationsplatformen anvendes af uddannelsesinstitutioner, myndigheder og organisationer/virksomheder på førskole- og grundskoleområderne samt på ungdomsuddannelsesområdet og voksen- og efteruddannelsesområdet.
Yderligere oplysninger om tilslutning og tekniske detaljer kan findes på STIL's supportsite for Integrationsplatformen via https://viden.stil.dk/x/BgBwBg.

Servicebeskrivelsen findes på siden https://viden.stil.dk/display/OFFintegrationsplatformen/Services.

AMU-arkivdata

HentAMUbeviser

Denne webservice kan hente oplysninger for AMU-beviser for et CPR-nummer.

Request

Requestet indeholder følgende tags:

Valideringer
Der foretages følgende valideringer af requestet:

I kolonnen Fejltekst skal <xxxx> erstattes af værdien af tagget xxxx.

Response

Responset indeholder følgende tags:

HentPDFforAMUbevis

Denne webservice kan hente PDF for et AMU-bevis.

Request

Requestet indeholder følgende tags:

Valideringer
Der foretages følgende valideringer af requestet:

Response

Responset indeholder følgende tags:

RetAMUbevis

Denne webservice kan rette eller slette et AMU-bevis.

Hvis der rettes i et AMU-bevis, gælder følgende:

• Person på AMU-beviset må ændres
  • • Hvis personen ikke eksisterer, bliver der oprettet en ny person
    • Hvis personen eksisterer, bliver fornavn og efternavn opdateret
• Skole på AMU-beviset kan ikke ændres
• Startdato, Slutdato, Lektioner og VarighedDage må ændres
• Kursustype må ændres, men kursustypen skal eksistere
• Rekvirent på kursustypen kan ikke ændres
• Bevislinjer på kursustypen kan ikke ændres

Request

Requestet indeholder følgende tags:

Hvis tagget Operation har værdien 'Update', skal følgende tags være udfyldt:

• Person
• Placering
• Kursustype

Hvis tagget Operation har værdien 'Delete', må ingen af følgende tags være udfyldt:

• Person
• Placering
• Kursustype

Valideringer
Der foretages følgende valideringer af requestet:

Response

Responset indeholder følgende tags:

Generelle fejlkoder

Eksempler

I nedenstående eksempler er korrekt CPR-nr. erstattet af 'xxxxxxxxxx'.

Eksempel på HentAMUbeviser request

       <ns:HentAMUbeviserRequest>

         <ns:Besked>

            <ns:Indhold>

               <ns:KaldendeInstNr>461420</ns:KaldendeInstNr>

               <ns:CPRnummer>xxxxxxxxxx</ns:CPRnummer>

               <ns:Fradato>2008-10-01</ns:Fradato>

               <ns:Tildato>2021-12-31</ns:Tildato>

               <ns:Kursustype>039343</ns:Kursustype>

               <ns:Bruger>Peter</ns:Bruger>

            </ns:Indhold>

         </ns:Besked>

      </ns:HentAMUbeviserRequest>

Eksempler på HentAMUbeviser response

Uden fejl

      <HentAMUbeviserResponse xmlns="http://amubevisarkivet.dk/2020/04/28/">

         <Resultat>

            <ResultatIndhold>

               <KaldendeInstNr>461420</KaldendeInstNr>

               <BehandlingsTidspunkt>2021-09-15 10:37:25</BehandlingsTidspunkt>

               <SvarKode>AMUBA-00</SvarKode>

               <SvarTekst>Ingen fejl</SvarTekst>

               <AMUbevisListe>

                  <AMUbevis>

                     <BevisId>19586974</BevisId>

                     <Person>

                        <CPRnummer>xxxxxxxxxx</CPRnummer>

                        <Fornavn>Kursist_374 Fornavne</Fornavn>

                        <Efternavn>Kursist_374_efternavn</Efternavn>

                     </Person>

                     <Skole>

                        <Institutionsnummer>621402</Institutionsnummer>

                        <Skolenavn>International Business College</Skolenavn>

                        <AktuelInstitutionsnummer/>

                        <AktuelSkolenavn/>

                     </Skole>

                     <Placering>

                        <Startdato>2010-03-04</Startdato>

                        <Slutdato>2010-03-05</Slutdato>

                     </Placering>

                     <Kursustype>

                        <Kursustypetype>ENK</Kursustypetype>

                        <Kursustype>039343</Kursustype>

                        <Betegnelse>Udlån II</Betegnelse>

                     </Kursustype>

                  </AMUbevis>

               </AMUbevisListe>

            </ResultatIndhold>

         </Resultat>

      </HentAMUbeviserResponse> 

Med fejl

      <HentAMUbeviserResponse xmlns="http://amubevisarkivet.dk/2020/04/28/">

         <Resultat>

            <ResultatIndhold>

               <KaldendeInstNr>461420</KaldendeInstNr>

               <BehandlingsTidspunkt>2021-10-07T12:16:37</BehandlingsTidspunkt>

               <SvarKode>AMUBA-11</SvarKode>

               <SvarTekst>CPR-nummer xxxxxxxxxx findes ikke i AMU-bevisarkivet</SvarTekst>

               <AMUbevisListe/>

            </ResultatIndhold>

         </Resultat>

      </HentAMUbeviserResponse>

Eksempel på HentPDFforAMUbevis request

      <ns:HentPDFforAMUbevisRequest>

         <ns:Besked>

            <ns:Indhold>

               <ns:KaldendeInstNr>461420</ns:KaldendeInstNr>

               <ns:BevisId>19586974</ns:BevisId>

               <ns:Bevisformat>A6</ns:Bevisformat>

               <ns:Skolenavn>AMU-Fyn</ns:Skolenavn>

               <ns:Gade>Petersmindesvej 50</ns:Gade>

               <ns:PostnrBy>5000 Odense C</ns:PostnrBy>

               <ns:Bruger>Anton</ns:Bruger>

            </ns:Indhold>

         </ns:Besked>

      </ns:HentPDFforAMUbevisRequest> 

Eksempel på HentPDFforAMUbevis response

Uden fejl

      <HentPDFforAMUbevis xmlns="http://amubevisarkivet.dk/2020/04/28/">

         <Resultat>

            <ResultatIndhold>

               <KaldendeInstNr>461420</KaldendeInstNr>

               <BehandlingsTidspunkt>2021-09-15 10:39:33</BehandlingsTidspunkt>

               <SvarKode>AMUBA-00</SvarKode>

               <SvarTekst>Ingen fejl</SvarTekst>

               <AMUbevis>

                  <BevisId>19586974</BevisId>

<Person>

    <CPRnummer>xxxxxxxxxx</CPRnummer>

    <Fornavn>Kursist_374 Fornavne</Fornavn>

    <Efternavn>Kursist_374_efternavn</Efternavn>

 </Person>

 <Skole>

    <Institutionsnummer>621402</Institutionsnummer>

    <Skolenavn>International Business College</Skolenavn>

    <AktuelInstitutionsnummer/>

    <AktuelSkolenavn/>

 </Skole>

 <Placering>

    <Startdato>2010-03-04</Startdato>

    <Slutdato>2010-03-05</Slutdato>

 </Placering>

 <Kursustype>

    <Kursustypetype>ENK</Kursustypetype>

    <Kursustype>039343</Kursustype>

    <Betegnelse>Udlån II</Betegnelse>

 </Kursustype>

               </AMUbevis>

            </ResultatIndhold>

         </Resultat>

      </HentPDFforAMUbevis> 

Med fejl

      <HentPDFforAMUbevisResponse xmlns="http://amubevisarkivet.dk/2020/04/28/">

         <Resultat>

            <ResultatIndhold>

               <KaldendeInstNr>461420</KaldendeInstNr>

               <BehandlingsTidspunkt>2021-10-07T12:37:01</BehandlingsTidspunkt>

               <SvarKode>AMUBA-21</SvarKode>

               <SvarTekst>Bevis 12210752 findes ikke i AMU-bevisarkivet</SvarTekst>

               <AMUbevis/>

            </ResultatIndhold>

         </Resultat>

      </HentPDFforAMUbevisResponse> 

Eksempel på RetAMUbevis request

Update

      <ns:RetAMUbevisRequest>

         <ns:Besked>

            <ns:Indhold>

               <ns:KaldendeInstNr>621402</ns:KaldendeInstNr>

               <ns:CPRnummer>xxxxxxxxxx</ns:CPRnummer>

               <ns:BevisId>19586974</ns:BevisId>

               <ns:Bruger>Berit Sand</ns:Bruger>

               <ns:Operation>Update</ns:Operation>

               <ns:Person>

                  <ns:CPRnummer>yyyyyyyyyy</ns:CPRnummer>

                  <ns:Fornavn>Kursist_374 Fornavne</ns:Fornavn>

                  <ns:Efternavn>Kursist_374_efternavn</ns:Efternavn>

               </ns:Person>

               <ns:Placering>

                  <ns:Startdato>2010-03-04</ns:Startdato>

                  <ns:Slutdato>2010-03-05</ns:Slutdato>

                  <ns:Lektioner>1</ns:Lektioner>

                  <ns:VarighedDage>1</ns:VarighedDage>

                  <ns:Certifikattekst/>

              </ns:Placering>

               <ns:Kursustype>

                  <ns:Kursustypetype>ENK</ns:Kursustypetype>

                  <ns:Kursustype>039343</ns:Kursustype>

               </ns:Kursustype>

            </ns:Indhold>

         </ns:Besked>

      </ns:RetAMUbevisRequest>

Bemærk, at hvis der ændres til et ikke gyldigt cpr nummer (yyyyyyyyyy i eksemplet), vil operationen fejle.

Delete

<ns:RetAMUbevisRequest>

         <ns:Besked>

            <ns:Indhold>

               <ns:KaldendeInstNr>621402</ns:KaldendeInstNr>

               <ns:CPRnummer>xxxxxxxxxx</ns:CPRnummer>

               <ns:BevisId>19586974</ns:BevisId>

               <ns:Bruger>jens</ns:Bruger>

               <ns:Operation>Delete</ns:Operation>

            </ns:Indhold>

         </ns:Besked>

      </ns:RetAMUbevisRequest>

Eksempel på RetAMUbevis response

Update – uden fejl

<RetAMUbevisResponse xmlns="http://amubevisarkivet.dk/2020/04/28/">

         <Resultat>

            <ResultatIndhold>

               <KaldendeInstNr>621402</KaldendeInstNr>

               <BehandlingsTidspunkt>2021-09-15 10:54:47</BehandlingsTidspunkt>

               <SvarKode>AMUBA-00</SvarKode>

               <SvarTekst>Ingen fejl</SvarTekst>

               <AMUbevis>

                  <BevisId>19586974</BevisId>

                  <Operation>Update</Operation>

               </AMUbevis>

            </ResultatIndhold>

         </Resultat>

      </RetAMUbevisResponse>

Update – med fejl

RetAMUbevisResponse xmlns="http://amubevisarkivet.dk/2020/04/28/">

         <Resultat>

            <ResultatIndhold>

               <KaldendeInstNr>621402</KaldendeInstNr>

               <BehandlingsTidspunkt>2021-10-07T10:59:49</BehandlingsTidspunkt>

               <SvarKode>AMUBA-11</SvarKode>

               <SvarTekst>CPR-nummer xxxxxxxxxx findes ikke i AMU-bevisarkivet</SvarTekst>

               <AMUbevis/>

            </ResultatIndhold>

         </Resultat>

      </RetAMUbevisResponse>

Delete – uden fejl

<RetAMUbevisResponse xmlns="http://amubevisarkivet.dk/2020/04/28/">

         <Resultat>

            <ResultatIndhold>

               <KaldendeInstNr>621402</KaldendeInstNr>

               <BehandlingsTidspunkt>2021-09-15 10:54:47</BehandlingsTidspunkt>

               <SvarKode>AMUBA-00</SvarKode>

               <SvarTekst>Ingen fejl</SvarTekst>

               <AMUbevis>

                  <BevisId>19586974</BevisId>

                  <Operation>Delete</Operation>

               </AMUbevis>

            </ResultatIndhold>

         </Resultat>

      </RetAMUbevisResponse>

Delete – med fejl

<RetAMUbevisResponse xmlns="http://amubevisarkivet.dk/2020/04/28/">

         <Resultat>

            <ResultatIndhold>

               <KaldendeInstNr>621402</KaldendeInstNr>

               <BehandlingsTidspunkt>2021-10-07T12:43:19</BehandlingsTidspunkt>

               <SvarKode>AMUBA-11</SvarKode>

               <SvarTekst>CPR-nummer xxxxxxxxxx findes ikke i AMU-bevisarkivet</SvarTekst>

               <AMUbevis/>

            </ResultatIndhold>

         </Resultat>

      </RetAMUbevisResponse>