LEFI Schemaförändringar release dec 2011 samt feb 2012

LEFI – Schemaförändringar release dec 2011 samt feb 2012

Uppdateringar av scheman i LEFI Online/Prenumeration avseende förändrade begrepp gällande SJP, FP, BOT, jämställdhetsbonus samt förändringar för beställning av hel-

uppdatering av befintlig bevakning i LEFI Prenumeration

IT-tjänst: LEFI Version: RevA

Skribent: Godkändav:

Ändringsförteckning

Nedanstående tabell redovisar ändringshistoriken för detta dokument.

Bilage- och referensförteckning

Här ska man skriva in namn, identitet och sökväg till dokument som man vill referera till, såsom tidsplaner och testspecifikationer.

Nummer Titel, dokumentid, sökväg Version

Version Datum Beskrivning Namn

RevA 2011-10-24 Fastställd utgåva

Innehåll

1  BESKRIVNING ... 3 

2  PUBLICERING ... 3 

3  TJÄNSTER OCH VERSIONSHANTERING ... 4 

3.1  LEFIONLINE ... 4 

3.2  LEFIPRENUMERATION ... 5 

4  SCHEMAÄNDRINGAR ... 6 

4.1  LEFIPRENUMERATION ... 6 

4.1.1  Beställningstyp ... 6 

4.1.2  Person – informationstyp för svar ... 6 

4.2  SJUKPENNING ... 8 

4.2.1  LEFI Online ... 8 

4.2.2  LEFI Prenumeration ... 9 

4.3  UTBETALNING ... 9 

4.3.1  LEFI Online ... 9 

4.3.2  LEFI Prenumeration ... 11 

4.4  JÄMSTÄLLDHETSBONUS ... 11 

4.5  BOENDETILLÄGG ... 11 

4.5.1  LEFI Online ... 12 

4.5.2  LEFI Prenumeration ... 12 

1 Beskrivning

Dokumentet ger en kortfattad sammanställning av de schemaändringar som kommer att göras i IT- tjänsterna LEFI Online och LEFI Prenumeration. För övrigt hänvisas till respektive tjänsts

informationssida på www.forsakringskassan.se.

Nya versioner av scheman kommer att driftsättas 2012-01-01. Nedan ges en kortfattad sammanställning av nyheter/förändringar:

 Möjlighet att begära heluppdatering av befintlig bevakning i LEFI Prenumeration fr.o.m.

2012-02-26.

 LEFI Prenumerationssvar innehåller uppdateringstyp fr.o.m. 2012-01-01.

 Förmån sjukpenning har kompletterats med 6 nya sjukpenningstyper fr.o.m. 2012-01-01 pga. lagändring.

 Jämställdhetsbonus ny variant av föräldrapenning fr.o.m. 2012-02-26 .

 Ny förmån Boendetillägg fr.o.m. 2012-01-01.

2 Publicering

Följande tabell visar när scheman publiceras och när det börjar användas. (Grönt = fastställd, Gult = Preliminärt, Röd = Oklart):

Publiceras Används från Tjänst Beskrivning

2012-01-01 2012-02-26 LEFI Prenumeration Beställning av heluppdatering 2012-01-01 2012-01-01 LEFI Prenumeration Informationstyp för svar 2012-01-01 2012-01-01 LEFI Online

LEFI Prenumeration

Nya sjukpenningstyper 2012-01-01 2011-02-26 LEFI Online

LEFI Prenumeration

Jämställdhetsbonus. Endast utbetalning.

Se utbetalning punkt 4.3.1 och 4.3.2 2012-01-01 2012-01-01 LEFI Online

LEFI Prenumeration

Boendetillägg, ny förmån. Endast utb.

Se utbetalning punkt 4.3.1 2012-01-01 2011-01-01 LEFI Online

LEFI Prenumeration

Utbetalning, förändringar pga. a ovan ändrade punkter.

Nedan finns beskrivet de ändringar som är gjorda samt vilka filer som påverkats och dess versions- numrering.

3 Tjänster och versionshantering

3.1 LEFI Online

Gäller fr.o.m. 2012-01-01.

För LEFI Online publiceras nya scheman och tjänster. Dessa kommer att ha version 1.3.0.

Om man vill använda den nya versionen av scheman så gör man det på följande sätt:

1. Identifiera önskad schemaversion, versionsnummer består av ett 3-ställigt numeriskt fält med separator. Som separator används understreck (_) om det används i schema-namn, annars punkt (. ).

Exempel:

SHS https://<shs-server:shs-port>/ws/FK.Online.Fraga_v1_3_0 Schema: exi_online_frage_svar_v1_3_0.xsd

Versionstag: <version>1.3.0</version>

2. Använd publicerat schema för vald version från angiven schema-server.

T.ex.

http://schema.forsakringskassan.se/externa_intressenter/exi_online_frage_svar_v1_3_0.xsd 3. Ange versionstag i LEFI-fråga:

Exempel:

<?xml version="1.0" encoding="ISO-8859-1"?>

<FK.Online.Fraga xmlns="http://schema.forsakringskassan.se/externa_intressenter"

xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

xsi:schemaLocation="http://schema.forsakringskassan.se/externa_intressenter http://schema.forsakringskassan.se/externa_intressenter/exi_online_frage_svar_v1 _3_0.xsd">

<version>1.3.0</version>

<generelltfalt>

<organisationsnummer>5561112223</organisationsnummer>

</generelltfalt>

<informationsfalt>

<person>

...

...

4. Anropa SHS/eMottagningen på rätt tjänsteversion och tjänst:

https://<shs-server:shs-port>/ws/FK.Online.FragaFbolag_v1_3_0 https://<shs-server:shs-port>/ws/FK.Online.FragaKfm_v1_3_0 https://<shs-server:shs-port>/ws/FK.Online.FragaKom_v1_3_0

Följande tjänsteingångar kommer att finnas fr.o.m. 2012-01-01:

Organisation SHS/eMottagning och schema Befintlig version, v1.2.5

Försäkringsbolag

Kronofogdemyndigheten Kommun

Schema: exi_online_frage_svar.xsd

exi_online_frage_svar_fbolag.xsd exi_online_frage_svar_kfm.xsd exi_online_frage_svar_kom.xsd Tjänst: Befintlig

Försäkringsbolag v1.2.6 Schema: exi_online_frage_svar_fbolag_v1_2_6.xsd Tjänst: FK.Online.FragaFbolag_v1_2_6 Kronofogdemyndigheten

v1.2.6

Schema: exi_online_frage_svar_kfm_v1_2_6.xsd Tjänst: FK.Online.FragaKfm_v1_2_6

Kommun v.1.26 Schema: exi_online_frage_svar_kom_v1_2_6.xsd Tjänst: FK.Online.FragaKom_v1_2_6

Försäkringsbolag v1.3.0 Schema: exi_online_frage_svar_fbolag_v1_3_0.xsd Tjänst: FK.Online.FragaFbolag_v1_3_0

Kronofogdemyndigheten v1.3.0

Schema: exi_online_frage_svar_kfm_v1_3_0.xsd Tjänst: FK.Online.FragaKfm_v1_3_0

Kommun v.1.3.0 Schema: exi_online_frage_svar_kom_v1_3_0.xsd Tjänst: FK.Online.FragaKom_v1_3_0

Schema ovan ligger alltid i http://schema.forsakringskassan.se/externa_intressenter/ om inget annat anges.

Tjänst ovan finns alltid på https://<shs-server:shs-port>/ws/ om inget annat anges.

3.2 LEFI Prenumeration

Gäller fr.o.m. 2012-02-26.

Schema för LEFI Prenumeration uppdateras till version 1.3.0. Det går bra att i förväg uppdatera schemat lokalt innan det är publicerat på Försäkringskassans schemaserver då befintliga svar enligt gamla schemat är kompatibla med det nya schemat.

Kunder som använder LEFI Prenumeration kan [Preliminärt] fr.o.m. 2012-02-26 beställa

heluppdatering av en befintlig bevakning. För att kunna göra detta införs en ny beställningstyp som sätts i den prenumeration som extern intressent skickar till oss. Se punkt 4.1.1.

En heluppdatering innebär att för aktuell bevakning så hämtas all information som bevakningen gäller istället för att bara leverera den information som förändrats sen senast. Detta gör att man kan synkronisera extern parts journalsystem med befintlig information i Försäkringskassans förmåner.

Ta i beaktning att denna typ av beställning förbrukar mer resurser i Försäkringskassans system och bör ha en modererad användning. Om det gäller större volymer som t ex vid årskörning bör man kontakta Försäkringskassan i förväg och komma överens om hur de skall gå till.

4 Schemaändringar

4.1 LEFI Prenumeration

4.1.1 Beställningstyp

Gäller fr.o.m. 2012-02-26.

Ny beställningstyp införs så man begära en heluppdatering av befintlig bevakning. Denna har i övrigt exakt samma upplägg som för befintliga beställningstyper.

Post XML-fält Beskrivning Beställningstyp heluppdateringBevakning

nybestallningBevakning avbestallningBevakning

Vilken typ av beställning som avses:

heluppdatering (befintlig bevakning) beställning (ny beställning) eller avbeställning

Exempel:

<generelltfalt>

<organisationsnummer>1234567890</organisationsnummer>

</generelltfalt>

<informationsfalt>

<heluppdateringBevakning>

<person>

<personnummer>190000000000</personnummer>

<from>2011-08-13</from>

<formansinformation>

<pension>1</pension>

<prognos>1</prognos>

<sjukpenninggrundandeInkomst>1</sjukpenninggrundandeInkomst>

<levnadsintyg>1</levnadsintyg>

</formansinformation>

</person>

</heluppdateringBevakning>

4.1.2 Person – informationstyp för svar

Gäller fr.o.m. 2012-01-01.

I och med att det går att beställa heluppdatering av en bevakning så behövs ett sätt att meddela till mottagaren av prenumerationssvar vilket innehåll som kommer för en person så extern part kan särskilja mellan en uppdatering av information senast levererat eller om det är komplett information som levereras vid nybeställning eller heluppdatering.

Detta genomförs med ett attribut på aktuell person.

Fält Förklaring Beskrivning av värden Person

Attribut:informationstyp

Typ: short Förekomst: 0 - 1

0 = Komplett information (sätts vid nybeställning eller heluppdatering)

1 = Uppdaterad information (endast ny eller

förändrad information senast)

Exempel:

<informationsfalt>

<person informationstyp="0">

<personnummer>199999999999</personnummer>

<statusBestallning>

<kundStatus>1</kundStatus>

<formansinformation>

<arbetsskadelivranta>1</arbetsskadelivranta>

...

</formansinformation>

</statusBestallning>

...

</person>

</informationsfalt>

4.2 Sjukpenning

4.2.1 LEFI Online

Gäller fr.o.m. 2012-01-01.

Nya värden för sjukpenningtyp tillagt samt att beskrivning på tidigare typer har uppdaterats.

Fält Förklaring Beskrivning av värden (befintliga + nya + ändrade) sjukpenningtyp Typ: short

Förekomst: 0 – 1 Värdemängd: Ja

101 = Sjukpenning

102 = Sjukpenning (Redare) 104 = Sjukpenning enligt LAF 105 = Särskild arbetsskadeersättning 106 = Sjukpenning YFL

107 = Sjukpenning YFL (RFV) 108 = Sjukpenning LSP

109 = Särskild sjukförsäkring för studerande 111 = Reseersättning (arbetsresor)

113 = Sjukpenning särskilda fall

114 = Rehabiliteringsersättning särskilda fall

115 = Sjukpenning på fortsättningsnivå särskilda fall

116 = Rehabiliteringsersättning på fortsättningsnivå särskilda fall

117 = Fler dagar med sjukpenning på normalnivå särskilda fall 125 = Sjukpenning på fortsättningsnivå

126 = Fler dagar med sjukpenning på normalnivå 127 = Rehabiliteringsersättning på fortsättningsnivå 131 = Förebyggande sjukpenning

132 = Förebyggande sjukpenning på fortsättningsnivå 133 = Fler dagar med förebyggande sjukpenning på

normalnivå 141 = Sjuklönegaranti

Exempel:

<sjukpenning>

<meddelande>1</meddelande>

<sjpArende>

<sjukpenningtyp>113</sjukpenningtyp>

<anmalningsdatum>2012-01-19</anmalningsdatum>

<period>

<from>2012-01-19</from>

<tom>2012-01-20</tom>

<omfattning>1</omfattning>

<antalDagar>2</antalDagar>

</period>

<arendestatus>9</arendestatus>

</sjpArende>

</sjukpenning>

4.2.2 LEFI Prenumeration Gäller from 2012-02-26.

Nya värden för sjukpenningtyp tillagt samt att beskrivning på tidigare typer har uppdaterats. Nya beloppstyper har tillkommit i utbetalningsinformationen.

Se beskrivning av sjukpenningtyp i punkt 4.2.1 för dagpenningärende.

Exempel:

<sjukpenning>

<dagpenningarende>

<anmalningsdatum datumKomplett="1">2012-10-01</anmalningsdatum>

<from datumKomplett="1">2012-10-15</from>

<tom datumKomplett="1">2012-10-20</tom>

<omfattning>2</omfattning>

<antalErsattaDagar>6</antalErsattaDagar>

<arendestatus>0</arendestatus>

<sjukpenningtyp>115</sjukpenningtyp>

</dagpenningarende>

<utbetalning>

<beloppstyp>40</beloppstyp>

<from datumKomplett="1">2012-10-15</from>

<tom datumKomplett="1">2012-10-20</tom>

<omfattning>2</omfattning>

<antalDagar>6</antalDagar>

<bruttobelopp>1860</bruttobelopp>

</utbetalning>

</sjukpenning>

4.3 Utbetalning

4.3.1 LEFI Online

Gäller from 2012-01-01.

Dagpenningärenden har uppdaterats med nya delförmåner och beloppstyper. Dessa hör ihop med ändringar i sjukpenning, rehabiliteringsersättning, föräldrapenning samt jämställdhetsbonus.

Notera att beloppstypen hanteras som ett fritext-fält, dvs. det kan egentligen innehålla vad som helst.

Fält Förklaring Beskrivning av värden (endast nya, förändrade) Delförmån Typ: string

Förekomst: 1 Värdemängd: Ja

BOT = Boendetillägg

JBO = Jämställdhetsbonus, maskinell Beloppstyp Typ: string

Förekomst: 1

SJP = Sjukpenning

RBE = Rehabiliteringsersättning AS = Aktivitetsstöd

SF = Särskilda fall

SFF = Särskilda fall, fortsättningsnivå SFN = Särskilda fall, normalnivå DUB = Dubbeldagar

JBO = Jämställdhetsbonus

Följande kombinationer är nya:

Förmån Delförmån Beloppstyp Beskrivning

DAG RBE SF Rehabiliteringsersättning i särskilda fall

DAG RBE SFF Rehabiliteringersättning på fortsättningsnivå i särskilda fall

DAG SJP SF Sjukpenning i särskilda fall

DAG SJP SFN Sjukpenning på normalnivå i särskilda fall DAG SJP SFF Sjukpenning på fortsättningsnivå i särskilda fall DAG BOT SJP Boendetillägg, sjukpenning

DAG BOT RBE Boendetillägg, rehabiliteringsersättning DAG BOT AS Boendetillägg, aktivitetsstöd

DAG FP DUB Föräldrapenning dubbeldagar DAG JBO JBO Jämställdhetsbonus

Exempel:

<utbetalning>

<meddelande>1</meddelande>

<period>

<forman>DAG</forman>

<from>2011-01-01</from>

<tom>2011-01-31</tom>

<utbetalningstyp>M</utbetalningstyp>

<totaltBruttobelopp>3000</totaltBruttobelopp>

<totaltSkattebelopp>0</totaltSkattebelopp>

<totaltAvdragsbelopp>0</totaltAvdragsbelopp>

<nettobelopp>3000</nettobelopp>

<utbetalningsdatum>2011-02-01</utbetalningsdatum>

<utbetalningen>

<delforman>BOT</delforman>

<beloppstyp>SJP</beloppstyp>

<from>2011-01-01</from>

<tom>2011-01-31</tom>

<omfattning>0</omfattning>

<timmar>0</timmar>

<dagar>31</dagar>

<bruttobelopp>3000</bruttobelopp>

<avdragsbelopp>0</avdragsbelopp>

<skattebelopp>0</skattebelopp>

</utbetalningen>

</period>

</utbetalning>

4.3.2 LEFI Prenumeration Gäller from 2012-01-01.

I o m. de ändringarna i sjukpenning så tillkommer det nya beloppstyper:

Fält Förklaring Beskrivning av värden (endast nya) Beloppstyp Typ: short

Förekomst: 0 - 1

01 = Rehabiliteringsersättning i särskilda fall (RBE/SF) 12 = Sjukpenning i särskilda fall (SJP/SF)

14 = Föräldrapenning dubbeldagar (FP/DUB)

36 = Fler dagar med sjukpenning på normalnivå, särskilda fall (SJP/SFN)

38 = Rehabiliteringsersättning på fortsättningsnivå, särskilda fall (RBE/SFF)

40 = Sjukpenning på fortsättningsnivå, särskilda fall (SJP/SFF)

Exempel:

<sjukpenning>

<dagpenningarende>

<anmalningsdatum datumKomplett="1">2012-10-01</anmalningsdatum>

<from datumKomplett="1">2012-10-15</from>

<tom datumKomplett="1">2012-10-20</tom>

<omfattning>2</omfattning>

<antalErsattaDagar>6</antalErsattaDagar>

<arendestatus>0</arendestatus>

<sjukpenningtyp>115</sjukpenningtyp>

</dagpenningarende>

<utbetalning>

<beloppstyp>40</beloppstyp>

<from datumKomplett="1">2012-10-15</from>

<tom datumKomplett="1">2012-10-20</tom>

<omfattning>2</omfattning>

<antalDagar>6</antalDagar>

<bruttobelopp>1860</bruttobelopp>

</utbetalning>

</sjukpenning>

4.4 Jämställdhetsbonus

Gäller from 2012-02-26.

Jämställdhetsbonus redovisas f n. endast i utbetalning, se punkt 4.3.

4.5 Boendetillägg

Gäller from 2012-01-01.

4.5.1 LEFI Online

Redovisas endast i utbetalningspost. Se punkt 4.3.1.

4.5.2 LEFI Prenumeration

Detta är en ny förmån som vi inte kommer leverera funktionalitet för f n.