API-export till Beda
Med API-export till Beda skickar din skola gymnasieelevers slutbetyg direkt från Meitner till UHR:s betygsdatabas Beda. Funktionen hanterar både GY11 och Gy25 och väljer automatiskt rätt GUV-version (GUV5, GUV6 eller GUV7) baserat på elevens kursuppsättning. Den här guiden går igenom hur du konfigurerar anslutningen, kör en export och tolkar resultaten i exportloggen.
✅Förutsättningar
Innan du kan köra en export behöver två saker vara på plats på skolan:
| Inställning | Var den finns | Beskrivning |
|---|---|---|
| Skolenhetskod | Admin › Konfiguration › Skolinfo › Skolenhetskod | Skolans åttasiffriga skolenhetskod från Skolverket. Skickas med varje merit som skolans identitet i Beda. |
| Anslutningspart (Beda‑nyckel) | Admin › Konfiguration › Integrationer › Beda | Den anslutningsparts-identifierare ni fått av UHR. Används som anslutningspart-parameter i varje anrop till Beda. |
Om Anslutningspart eller Skolenhetskod saknas kommer Beda att avvisa anropet med ett valideringsfel. Dubbelkolla att båda värdena är ifyllda innan första exporten.
⚙️Konfigurera anslutningen till Beda
Anslutningsparten konfigureras en gång per skola. Du behöver vara skoladministratör för att redigera fältet.
-
1
Gå till Admin › Konfiguration › Integrationer › Beda i administratörsvyn.
-
2
Fyll i fältet Anslutningspart med den identifierare ni fått av UHR. Tomt värde tas bort vid sparning, vilket effektivt stänger av integrationen.
-
3
Klicka på Spara. När bekräftelsen visas är anslutningen aktiv och kan användas direkt på exportsidan.
📤Använd Beda-exporten
För att exportera examensdata till Beda går du till Admin › Betyg › Beda. Där finner du två flikar: Exportera och Exportlogg.
När du skapat ett betygsdokument (examensbevis, studiebevis eller gymnasieintyg) för en eller flera elever hittar du datan att exportera till Beda här.
Filtrera fram rätt elever
Klicka på filterknappen ovanför tabellen för att begränsa urvalet.
| Filter | Standardvärde | Funktion |
|---|---|---|
| Utfärdandedatum från | 30 dagar bakåt | Lägsta utfärdandedatum på betygsdokumentet som listas. |
| Utfärdandedatum till | Dagens datum | Högsta utfärdandedatum. |
| Klass | Inget filter | Begränsar urvalet till en eller flera klasser. |
| Dölj exporterade | På | När den är på visas endast elever som inte är exporterade än, eller där studieplanen ändrats efter senaste exporten. |
| Sökruta | Tom | Söker på elevens namn eller personnummer. |
Använd Filtrera för att exportera klassvis. Då får du bättre kontroll om du behöver hantera felkoder i exportloggen.
Statusvärden i tabellen
Kolumnen Status visar var i exportflödet varje elev befinner sig.
| Status | Innebörd |
|---|---|
| Inte exporterad | Eleven har ett betygsdokument men ingen export är genomförd. |
| Exporterad | Senaste exportförsöket lyckades och elevens uppgifter är inrapporterade till Beda. |
| Uppdaterad efter export | Exporten har lyckats tidigare, men studieplanen eller en kurs har ändrats efter den senaste exporten. En ny export behövs för att Beda ska få den uppdaterade datan. |
| Export misslyckades | Senaste anropet till Beda gav ett fel. Klicka på raden för att läsa felmeddelandet i detalj. |
Genomför en export
-
1
Markera kryssrutan för de elever du vill exportera. Du kan välja flera samtidigt. Knappen Exportera dyker upp längst ner.
-
2
Klicka på Exportera. En bekräftelsedialog öppnas.
-
3
I dialogen finns kryssrutan Eleverna går i gymnasiet. Lämna den ikryssad om de markerade eleverna fortfarande är aktiva gymnasieelever. Avmarkera den om du exporterar för elever som inte längre studerar. Det påverkar hur markeringen "P" (prövning) sätts på enskilda kurser.
-
4
Klicka på Exportera i dialogen för att skicka. Meitner skickar en merit per elev, en i taget, till Beda. Om någon misslyckas fortsätter resten ändå.
-
5
När exporten är klar visas antingen ett grönt meddelande om att allt gick bra, eller ett rött meddelande med antal misslyckade elever. Dessa rader markeras kvar i tabellen så att du enkelt kan försöka igen efter att felet är åtgärdat.
Om samma elev exporteras flera gånger uppdaterar Meitner automatiskt den befintliga meriten i Beda istället för att skapa en ny. Du behöver alltså inte oroa dig för dubbletter när du kör om en export efter att ha rättat ett betyg.
🎓Vilken typ av merit skickas?
Meitner väljer GUV-version automatiskt utifrån elevens betygsdokumenttyp och vilka kurstyper (GY11, Gy25, grundskola) som ingår i studieplanen. Du behöver inte själv styra detta, men det är bra att känna till hur det fungerar vid felsökning.
| GUV-version | Används när | Skickade dokumenttyper |
|---|---|---|
| GUV5 | Endast GY11-kurser (och eventuellt grundskolekurser). | Examensbevis högskoleförberedande, examensbevis yrkesexamen, studiebevis, gymnasieintyg. |
| GUV6 | Blandning av GY11 och Gy25. | Gymnasieintyg (under hybridperioden). |
| GUV7 | Endast Gy25, eller Gy25 i kombination med grundskolekurser. | Examensbevis högskoleförberedande, examensbevis yrkesexamen, studiebevis, gymnasieintyg. |
Regler som påverkar vad som skickas
- Endast kurser med Räkna med vid slutbetyg ikryssat tas med i exporten.
- Endast underskrivna kurser inkluderas, utom kurser med reducerad omfattning, som alltid räknas med.
- Finns minst en kurs med reducerad omfattning konverteras dokumentet automatiskt till ett studiebevis i exporten, även om det är registrerat som examensbevis i Meitner.
- Kurser utan satt betyg hoppas över. Betyget
SAKNASöversätts till-mot Beda. - Personnummer skickas utan bindestreck.
📋Exportloggen
I fliken Exportlogg ser du alla anrop som skickats till Beda från din skola, både lyckade och misslyckade. Loggen är skrivskyddad och kan inte raderas; den fungerar som spårbarhet om UHR eller revision behöver verifiera vad som skickats och när.
Kolumner i logglistan
| Kolumn | Innehåll |
|---|---|
| Exportdatum | Datum och tid då anropet skickades. |
| Elev | Namn på den elev meriten avser. |
| Betygsdokument | Typ av dokument: examensbevis högskoleförberedande, examensbevis yrkesexamen, studiebevis eller gymnasieintyg. |
| HTTP-metod | POST innebär att en ny merit skapades, PUT att en befintlig uppdaterades. |
| Status | HTTP-statuskod från Beda. 200 och 201 räknas som lyckade, allt annat som fel. |
| Felmeddelande | Eventuellt felmeddelande från Beda, formaterat som punktlista när det handlar om valideringsfel. |
| Exporterad av | Namn på den användare som körde exporten. |
| GUV-version | Vilken Beda-endpoint som användes: guv5, guv6 eller guv7. |
| Utfärdandedatum | Utfärdandedatum från meriten som skickades. Används av Beda som en del av den unika nyckeln på en merit. |
Detaljvyn för en post
Klicka på en logg-rad för att öppna detaljvyn. Där visas också:
- Elev-ID i Meitner (intern UUID).
- Anropad URL hos Beda, inklusive vilken GUV-version som användes.
- Begäran: den fullständiga JSON-payload som skickades till Beda.
Detaljvyn visar alltid den fullständiga begäran i läsbar JSON-form. Det gör det enkelt att skicka exakt det Meitner försökte skicka till UHR:s support om Beda avvisar en merit utan en tydlig orsak.
🔧Vanliga felmeddelanden
Beda returnerar ofta strukturerade valideringsfel som Meitner formaterar som en punktlista i tabellen. Här är några vanliga lägen.
| Status | Trolig orsak | Åtgärd |
|---|---|---|
| 422 | Valideringsfel från Beda, t.ex. ogiltigt personnummer, saknad skolenhetskod, eller "gymnasiekursbetyg får inte vara tomt". | Läs den uppdelade felpunktlistan i detaljvyn. Rätta värdet i Meitner och kör om exporten. |
| 401 / 403 | Anslutningsparten är felaktig, har gått ut eller saknar behörighet hos UHR. | Verifiera värdet i Admin › Konfiguration › Integrationer › Beda. Kontakta UHR vid behov. |
| 500 / Nätverk | Tillfälligt fel hos Beda eller mellan systemen. | Försök igen om en stund. Kontakta Meitners support om felet kvarstår. |
| Inga studieplaner hittades | Eleven saknar en studieplan med kurser för aktiv skola. | Säkerställ att studieplanen är korrekt kopplad till rätt skola och innehåller minst en kurs. |
Om utfärdandedatum eller studievägskod ändras efter att en merit redan har skickats, arkiveras den gamla meriten i Beda och en ny skapas vid nästa export. Detta sker automatiskt, men det innebär att exporthistoriken i Beda kan visa två poster för samma elev. Det är normalt och inget fel.
🔄Studiebevis som ska ersättas av examensbevis
Om skolan först utfärdar ett studiebevis som rapporterats in till Beda och därefter uppdaterar dokumentet till ett examensbevis (exempelvis om eleven kompletterat för att få ett godkänt betyg istället för F eller -), måste skolan höra av sig till betygsdb@uhr.se och makulera studiebeviset först. Ett studiebevis (posten i betygsdatabasen) kan inte uppdateras till en examen, och det går inte heller att lägga till en ny examen om det redan finns ett studiebevis på personen.
Vid inkommen makuleringsbegäran från skolans rektor försöker UHR först utröna huruvida studiebeviset ska plockas bort för att lämna plats åt en examen för elev som är elev i gymnasieskolan, eller om studiebeviset ska ligga kvar och en examen för elev som ej är elev i gymnasieskolan ska utfärdas. Makuleringen av studiebevis är inget som Meitner kan styra över, utan följer UHR:s regler. Det är därför skolan själv som behöver kontakta UHR i dessa fall.