För dig som är utvecklare
Tjänsten LEFI Online står för "leverera förmånsinformation". Tjänsten tar emot frågor och utlämnar person- och förmånsinformation om efterfrågad person från Försäkringskassan och Pensionsmyndigheten. Den kan användas via två olika gränssnitt, webbgränssnitt och system till systemgränssnitt.
Versioner
LEFI system-system finns i 2-3 versioner. I webbgränssnittet är alltid senaste version implementerad.
Information och filer för gällande och tidigare versioner återfinns under avsnittet Tekniskt dokumentation och rubriken Versioner.
På sidan Releaseinformation presenteras alltid information om förändringar gällande versioner. Bland annat publiceras där information om kommande versioner.
Versionshantering
LEFI Online system till system använder sig av en semantisk versionshantering.
Versionshanteringen kommer innebära följande:
- Ändringshanteringen för tjänsten planeras mot 1–2 releaser per år.
- Versionshanteringen stödjer 2 versioner (gällande + föregående version).
- Äldre version stöds i 1 år (end-of-life).
Det här innebär att när det kommer en ny version (version 2) av tjänsten stöds föregående (version 1) i 1 år från och med releasetillfället. Detta gäller såvida det inte under denna period kommer ytterligare en ny version (version 3), då slutar stödet för första versionen (version 1) i och med att den nyaste versionen releasas.
Som användare innebär det att man behöver i drift stödja nuvarande eller föregående
version för att tjänsten ska fungera.
Syftet med denna versionshantering är att säkra en effektiv informationsförsörjning som ger möjligheter till:
- kontrollerad ändringshantering
- rimlig tid för användare att anpassa sig till nya versioner.
Minska risken att användare använder äldre versioner med risk att man missar tillkommen/ändrad information
Teknisk dokumentation för version 9
I nedanstående fil finner ni teknisk dokumentation om version 9 av LEFI Online. Den tekniska dokumentationen innehåller OpenAPI specifikation samt information om hur anslutning går till ur ett tekniskt perspektiv. Den tekniska dokumentationen är föränderlig och uppdateras vid behov.
LEFI Online version 9
Zip, 57 kB, öppnas i nytt fönster.
Teknisk dokumentation för versionerna 5, 6 och 7
Inlämningsadress för SSEK intressenter (till exempel försäkringsbolag):
https://fmansinfo.forsakringskassan.se/ssek/FK.EXA.Lefi.Fraga
Länk till annan webbplats.
Inlämningsadress för WS intressenter (till exempel kommuner):
https://fmansinfo.forsakringskassan.se:7020/shs2 Länk till annan webbplats.
https://fmansinfo.forsakringskassan.se:7020/ws Länk till annan webbplats.
XML-scheman
Länk till zipfiler Zip, 10 kB.
XMLfråga- och svarsfiler (exempel)
Xml.zip (zip med xml-filer) Zip, 36 kB, öppnas i nytt fönster.
WSDL-filer*
fkExaLefiHamtaFormansinformation_v4.wsdl
Öppnas i nytt fönster.
EXAHamtaFormansinformation.wsdl Öppnas i nytt fönster.(from version 5)
Certifikathantering för produktion och test
FK IT har en säkerhetspolicy som gör att vi för tillfället enbart använder servercertifikat för produktion i samtliga externt uppkopplade miljöer.
Det måste inte vara samma certifikat som ska användas i produktion och test men det måste vara samma CA.
Godkända utgivare är Expisoft (tidigare Steria) och certifikat från Siths.
Expisoft (eid.expisoft.se)
Länk till annan webbplats, öppnas i nytt fönster.
Identifieringstjänst Siths (inera.se) Länk till annan webbplats, öppnas i nytt fönster.
Gå in på eid.expisoft för instruktioner hur du beställer ett Steria/expisoft server certifikat.
Observera att FK IT inte supportar några certifikatfrågor. Tekniska frågor gällande certifikaten hänvisas till respektive CA utfärdare (Steria/expisoft i detta fall).
Certifikathantering Försäkringskassan
Pdf, 538 kB, öppnas i nytt fönster.
Testmiljön för LEFI Online vänder sig till systemutvecklare för integrationer mot tjänsten. För slutanvändare hänvisas till stöd för användare.
Varför en testmiljö till LEFI Online?
Syftet med testmiljön är att stödja en kontrollerad och kvalitativ förändringshantering av tjänsten och de integrationer som finns mot tjänsten.
Genom testmiljön ges möjlighet att:
- Få bättre bild av vad tjänsten LEFI Online innehåller och hur den fungerar
- Möjlighet till tester (kommunikationstester, integrationstester).
Vad innehåller LEFI Onlines testmiljö och hur fungerar den?
Testmiljön innehåller vanligen de versioner som produklionsmiljön av tjänsten LEFI Online stödjer. det till säga senaste version samt föregående version. Kommande version kommer finnas i testmiljön i tid innan den nya versionen driftsätts i produktionsmiljön.
För att få tillgång till tabell och beskrivning över testpersoner som finns i testmiljön och beställa underlaget, mejla till registeruttag@forsakringskassan.se
Anropet och svaret görs enligt gällande schema för tjänsten LEFI Online. Testmiljön får användas för att utföra funktionella tester. Den är inte skapad för att utföra prestanda- och lasttester.
Hur ansluter man sig till LEFI Onlines testmiljö?
För att använda tjänsten LEFI Onlines testmiljö behöver man ansluta sig separat till denna testmiljö. Detta görs genom att fylla i Kontaktformulär för LEFI Onlines testmiljö och skicka in till Försäkringskassan. Adressen finns i formuläret. Därefter kommer behövd information delges ansluten part.
Kontaktformulär för LEFI Onlines testmiljö Pdf, 683 kB, öppnas i nytt fönster.
Anslutningen handläggs i normalfallet inom 10 arbetsdagar från att kontaktformuläret inkommit till Försäkringskassan, under förutsättning att underlaget är komplett. Därefter sker återkoppling med behövd information till ansluten part.
Allmän information om LEFI Onlines testmiljö
För samtliga är IP-nummer/DNS-namn:194.71.80.30 (DNS shsext.forsakringskassan.se)
https://shsext.forsakringskassan.se:8200/ws Länk till annan webbplats, öppnas i nytt fönster.
https://shsext.forsakringskassan.se:8200/shs2 Länk till annan webbplats, öppnas i nytt fönster.