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 heluppdatering av befintlig bevakning i LEFI Prenumeration IT-tjänst: LEFI Skribent: Version: RevA Godkänd av:
1(13) Ändringsförteckning Nedanstående tabell redovisar ändringshistoriken för detta dokument. Version Beskrivning Namn RevA 2011-10-24 Fastställd utgåva 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
2(13) Innehåll 1 BESKRIVNING... 3 2 PUBLICERING... 3 3 TJÄNSTER OCH VERSIONSHANTERING... 4 3.1 LEFI ONLINE... 4 3.2 LEFI PRENUMERATION... 5 4 SCHEMAÄNDRINGAR... 6 4.1 LEFI PRENUMERATION... 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
3(13) 1 Beskrivning Dokumentet ger en kortfattad sammanställning av de schemaändringar som kommer att göras i ITtjä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 Nya sjukpenningstyper LEFI Prenumeration 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 Boendetillägg, ny förmån. Endast utb. LEFI Prenumeration 2012-01-01 2011-01-01 LEFI Online LEFI Prenumeration Se utbetalning punkt 4.3.1 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 versionsnumrering.
4(13) 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 (. ). 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: <?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
5(13) 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 Schema: exi_online_frage_svar_kfm_v1_2_6.xsd v1.2.6 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 Schema: exi_online_frage_svar_kfm_v1_3_0.xsd v1.3.0 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.
6(13) 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 <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
7(13) förändrad information senast) <informationsfalt> <person informationstyp="0"> <personnummer>199999999999</personnummer> <statusbestallning> <kundstatus>1</kundstatus> <formansinformation> <arbetsskadelivranta>1</arbetsskadelivranta>... </formansinformation> </statusbestallning>... </person> </informationsfalt>
8(13) 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 101 = Sjukpenning Förekomst: 0 1 102 = Sjukpenning (Redare) Värdemängd: Ja 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 <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>
9(13) 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. <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 BOT = Boendetillägg JBO = Jämställdhetsbonus, maskinell Värdemängd: Ja 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
10(13) 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 <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>
11(13) 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) <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.
12(13) 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.