Planera anslutning tillsammans med EHM
Vilka aspekter omfattas i planeringsarbetet för anslutning till fritidskortets API
Planeringsarbetet omfattar och hanterar de krav som E‑hälsomyndigheten ställer, och fokuserar på de delar av det anslutande systemet som berörs av dessa krav. För fritidskortet innebär detta att följande aspekter följs upp och kontrolleras:
Att integrationen mot fritidskortstjänsten är korrekt: Det vill säga att funktioner i tjänsten anropas på rätt sätt, i rätt sammanhang och endast för tillåtna ändamål.
Säkerhetsaspekter: Hur inloggning och behörighetsstyrning fungerar i systemet.
Personuppgiftshantering: Att informationen som delas mellan myndigheten och aktören behandlas i enlighet med gällande lagstiftning.
Presentation av information: Hur information från fritidskortstjänsten och myndighetens register presenteras för användaren i föreningssystemet.
Systemleverantören, det anslutande systemet och de som använder systemet omfattas även av andra krav utöver de som ställs av E‑hälsomyndigheten. Sådana krav, till exempel interna rutiner eller andra lagkrav, omfattas inte av E‑hälsomyndighetens anslutning. Anslutningsprocessen säkerställer alltså att integrationen mot fritidskortstjänstens API sker på ett säkert, korrekt och ändamålsenligt sätt.
Förfrågan om anslutning inkommer
För att starta ett anslutningsärende för integration mot fritidskortstjänsten gör ni en Förfrågan om anslutning via följande Förfrågan om anslutning.
Om ni är osäkra på om en förändring i ett redan anslutet system kräver en ny anslutning, kontakta er kundansvarige för rådgivning.
När E‑hälsomyndigheten mottagit förfrågan registreras ett anslutningsärende, och ni blir kontaktade av en anslutningsansvarig för fortsatt dialog om nästa steg i processen.
Uppstartsaktiviteter genomförs
I processens första skede genomförs uppstartsaktiviteter som syftar till att:
Säkerställa att ni förstår vad anslutningsprocessen innebär och att myndigheten förstår vad ert ärende gäller. Vid behov hålls ett möte, och ni kan behöva komplettera med ytterligare information om ert system eller planerade förändringar.
Granska om det finns tekniska och juridiska förutsättningar för det som ärendet gäller, om detta inte redan är tydligt. Även här kan ni behöva lämna kompletterande information.
När det är tydligt vad ert ärende gäller avgör myndigheten vilka anslutningsaktiviteter som ska genomföras. Dessa bestäms utifrån en riskanalys av de nyheter och förändringar som ska införas i systemet.
Riskminimerande anslutningsaktiviteter genomförs
I nästa steg genomförs de anslutningsaktiviteter som identifierats, enligt en tidplan som ni och myndigheten kommer överens om. Det är ni som utför aktiviteterna, medan E‑hälsomyndigheten granskar och verifierar resultaten. När samtliga aktiviteter är genomförda med godkänt resultat kan anslutning utfärdas för systemversionen.
Exempel på vanliga anslutningsaktiviteter:
Ni redogör för hur ni har planerat och genomfört tester av systemet.
Ni beskriver systemets arkitektur.
Ni intygar att (och i vissa fall beskriver hur) de krav som ställs på anslutande system uppfylls.
Ni förser myndigheten med skisser eller bilder på systemets användargränssnitt från en testmiljö.
Vid större anslutningar genomförs även anslutningstester, där integrationen mot fritidskortstjänsten kontrolleras. Testfallen:
Tas fram av E‑hälsomyndigheten och utförs av er.
Utförs utöver de tester ni själva ansvarar för att planera och genomföra.
Genomförs när ni har utvecklat och testat färdigt på er sida.
Tidsåtgången för anslutningsaktiviteter varierar beroende på ärendets omfattning och takten i ert utvecklingsprojekt. De sista anslutningsaktiviteterna genomförs när ni anser att systemet är färdigutvecklat och kvalitetssäkrat.
Att beakta inför och under en anslutning för fritidskortet
När ni planerar att integrera ert föreningssystem mot fritidskortstjänsten och påbörja en anslutningsprocess finns det flera viktiga aspekter att tänka på:
Egen kompetens och resurser
Ni behöver ha tillgång till både utvecklarkompetens och verksamhetskompetens för att kunna utveckla och anpassa ert system för integration mot fritidskortstjänsten.
Planering av anslutningstester
I anslutningsärenden av större omfattning ingår alltid en aktivitet där anslutningstester genomförs i det färdigutvecklade systemet. Ni behöver därför planera in en viss ledtid för detta moment. Ledtidens längd beror på ärendets omfattning och utfallet av testerna.
Ju högre kvalitet ert system har i förhållande till myndighetens krav, desto smidigare går genomförandet av anslutningsaktiviteterna. Det minskar tiden till utfärdat anslutningsintyg och möjligheten till snabb anslutning.
Tekniska förberedelser
Som ny kund behöver ni få åtkomst till E‑hälsomyndighetens externa testmiljö. För att beställa åtkomst och ansluta till testmiljön för fritidskortet, använd anslutningsformuläret till testmiljö.
Kommunikation och språk
Myndighetens språk är svenska. Handboken tillhandahålls på svenska och kommunikationen mellan kund och E‑hälsomyndigheten under ett anslutningsärende sker på svenska.
Undantaget är den tekniska dokumentationen av tjänstegränssnitt (API:er) och tillhandahålls på engelska.
Kontaktpersoner
Under ett pågående anslutningsärende ska ni ha en utsedd kontaktperson gentemot E‑hälsomyndigheten.
På myndighetens sida har ni en anslutningsansvarig som er kontaktperson under hela ärendet.
Genom att förbereda er enligt ovanstående punkter ökar ni möjligheterna för en smidig och effektiv anslutningsprocess för integration mot fritidskortstjänsten.