MISLIFE: Teknisk översikt · Web viewMicrosoft Word (.docx) Adobe PDF (.pdf) En beskrivning av hur...

MISLIFE: Teknisk översiktEn XML-vokabulär för utbyte av pensions- och livförsäkringsrelaterad information mellan organisationer i försäkringsbranschen.

Dokumentets ID:mislife-1.7.0-oversikt

Dokumentets plats:http://www.sfm.se/mislife/ mislife-1.7.0-oversikt.docx http://www.sfm.se/mislife/ mislife-1.7.0-oversikt.pdf

Författare:Daniel Stolt, SigmaHåkan Svensson, Capitex

Medverkande:[Lista alla medverkande bolag i teknikgruppen]

Sammanfattning:Detta dokument utgör en introduktion till och en teknisk översikt av standarden MISLIFE. Dokumentet är huvudsakligen icke-normativt.

Status:Under uppbyggnad.Detta dokument är en del av standarden MISLIFE som förvaltas av Svenska Försäkringsförmedlares Förening (SFM). Det har producerats av teknikgruppen genom en särskilt tillsatt arbetsgrupp.Detta dokument beskriver version 1.7.0 av standarden.Detta är revision CB av detta dokument.

Revisionshistorik:Datum Ny version Författare Beskrivning

2010-11-27 1.7.0-A Daniel Stolt Första utkast.2010-11-29 1.7.0-B Daniel Stolt Små justeringar efter feedback från Håkan Svensson.

Accepterat alla ändringsmarkeringar.2011-06-14 1.7.0-C Daniel Stolt Lagt till elementet /PersonType/Fodelsedatum.

1

2

3

45

678

91011

1213

141516

171819202122

23

24

1 Innehåll1 Innehåll.....................................................................................................2

2 Introduktion............................................................................................. 42.1 Övriga dokument..................................................................................................................................4

2.2 Konventioner och notation...................................................................................................................5

2.2.1 Nyckelord......................................................................................................................................5

2.2.2 XPath-notation..............................................................................................................................5

2.2.3 Namespace-prefix.........................................................................................................................5

2.2.4 Formatteringar..............................................................................................................................5

2.3 Definitioner...........................................................................................................................................5

3 MISLIFE som informationsstandard...........................................................63.1 Tillämpningsneutral..............................................................................................................................6

3.2 Ej tvingande..........................................................................................................................................7

3.3 Avgränsning..........................................................................................................................................7

4 MISLIFE som XML-vokabulär.....................................................................74.1 Namespace...........................................................................................................................................7

4.2 Äldre och nyare struktur.......................................................................................................................8

4.3 Språk.....................................................................................................................................................8

4.4 Best practices........................................................................................................................................9

4.5 XSD-filer och schema-validering............................................................................................................9

4.5.1 Förenklad variant........................................................................................................................10

4.6 Versionshantering...............................................................................................................................10

4.7 Tillämpningsspecifik utökning.............................................................................................................10

4.7.1 Validering av tillämpningsspecifikt innehåll................................................................................11

4.7.1.1 Alternativ 1: Använd endast officiella XSD-filer...................................................................11

4.7.1.2 Alternativ 2: Kopiera och modifiera officiell XSD.................................................................11

4.7.1.3 Alternativ 3: Kombinera officiell XSD med tillämpningsspecifik XSD...................................12

4.8 Allmänna tillämpningsregler...............................................................................................................12

4.8.1 Utelämnat element vs NIL vs noll................................................................................................12

4.8.2 Tidsangivelser..............................................................................................................................13

5 Översikt av strukturen............................................................................145.1.1 Alternativt rotelement................................................................................................................14

6 Generella typer.......................................................................................15

25

26

27

28

29

30

31

32

33

34

35

36

37

38

39

40

41

42

43

44

45

46

47

48

49

50

51

52

53

54

55

56

57

6.1 Identitet..............................................................................................................................................15

6.1.1 Person.........................................................................................................................................15

6.1.2 Organisation................................................................................................................................16

6.2 Belopp.................................................................................................................................................16

6.2.1 Absolut belopp............................................................................................................................16

6.2.2 Indexbelopp................................................................................................................................16

6.2.3 Förmån........................................................................................................................................16

6.3 Varaktighet.........................................................................................................................................17

6.3.1 Ålder............................................................................................................................................17

6.3.2 Tjänstetid....................................................................................................................................17

6.4 Avgifter...............................................................................................................................................17

6.4.1 Avgift...........................................................................................................................................17

6.5 Premier...............................................................................................................................................17

6.5.1 Premie.........................................................................................................................................17

6.6 Innehav...............................................................................................................................................17

7 Informationsenheter...............................................................................177.1 Teckningar...........................................................................................................................................17

7.1.1 Anslutning...................................................................................................................................18

7.1.2 Försäkring....................................................................................................................................18

7.2 Definitioner.........................................................................................................................................18

7.2.1 Avtal............................................................................................................................................18

7.2.2 Produkt.......................................................................................................................................18

8 Moment..................................................................................................188.1 Momentgrupper.................................................................................................................................18

8.2 Förmånsbestämd ålderspension.........................................................................................................18

8.3 Premiebestämd ålderspension...........................................................................................................19

8.4 Efterlevandepension...........................................................................................................................19

8.5 Premiebefrielse...................................................................................................................................19

8.6 Förtids-/invaliditetskapital..................................................................................................................19

8.7 Olycksfallsförsäkring...........................................................................................................................19

8.8 Sjukförsäkring.....................................................................................................................................19

8.9 Sjukvårdsförsäkring.............................................................................................................................19

58

59

60

61

62

63

64

65

66

67

68

69

70

71

72

73

74

75

76

77

78

79

80

81

82

83

84

85

86

87

88

89

90

2 IntroduktionDetta dokument är en introduktion till och en teknisk översikt av standarden MISLIFE, och syftar till att ge en överblick utifrån informationsstrukturen i en MISLIFE-fil. Dokumentet är inte en normativ del av standarden, utan ska endast användas upplysningsvis för att erhålla en övergripande förståelse för standardens uppbyggnad och innehåll.

Dokumentet förutsätter att läsaren är väl orienterad inom teknikerna XML och XSD och best practices kring tillämpning av dessa tekniker.

2.1 Övriga dokumentFöljande tabell summerar samtliga dokument som utgör standarden MISLIFE:

Dokument-ID Format Beskrivning

mislife-1.7.0-oversikt Microsoft Word (.docx)Adobe PDF (.pdf)

Detta dokument. En introduktion till och en teknisk översikt av standarden som KAN användas för att erhålla en övergripande förståelse för standardens uppbyggnad och innehåll.

mislife-1.7.0-specifikation Microsoft Word (.docx)Adobe PDF (.pdf)

En normativ specifikation som formellt beskriver standardens regler, och som tillämpande parter SKALL utgå från vid implementation.

mislife-1.7.0-mappning Microsoft Word (.docx)Adobe PDF (.pdf)

En beskrivning av hur information i den äldre strukturen KAN mappas till motsvarande information i den nyare strukturen.

mislife-1.7.0-legacy XML Schema Definition (.xsd) En XSD-fil som SKALL användas för schema-validering av den äldre strukturen i en MISLIFE-fil. Den KAN även användas som okulär referens och som mall vid konstruktion av programkod.

mislife-1.7.0-main XML Schema Definition (.xsd) En XSD-fil som SKALL användas för schema-validering av den nyare strukturen i en MISLIFE-fil. Den KAN även användas som okulär referens och som mall vid konstruktion av programkod.

mislife-1.7.0-simple XML Schema Definition (.xsd) En förenklad och mindre strikt XSD-fil som KAN användas istället för [mislife-1.7.0-main] för validering på plattformar som inte stödjer vissa av de mer avancerade XSD-konstruktioner som tillämpas i [mislife-1.7.0-main]. Den SKALL EJ användas som okulär referens eller som mall vid konstruktion av programkod.

mislife-1.6.2-manual Adobe PDF (.pdf) Användarmanual för äldre versioner (1.6.2 och tidigare) av standarden. Används fortfarande som beskrivning och specifikation av den äldre strukturen.

mislife-1.7.0-oversikt Sidan 4 av 20

91

92939495

9697

98

99

2.2 Konventioner och notation

2.2.1 NyckelordNyckelorden BÖR, KAN, SKALL och SKALL INTE har i detta dokument följande betydelser:

Nyckelord Betydelse

BÖR Det texten syftar till rekommenderas men är inte ett krav för att uppfylla specifikationen.KAN Det texten syftar till är tillåtet men är inte ett krav för att uppfylla specifikationen.SKALL Det texten syftar till är ett krav för att uppfylla specifikationen.SKALL INTE Det texten syftar till är otillåtet enligt specifikationen.

Dessa nyckelord skrivs alltid med versaler när de har normativ betydelse.

2.2.2 XPath-notationFör att referera till element och attribut relativt en viss plats i strukturen används sökvägar med XPath-notation (se http://www.w3.org/TR/xpath för mer information). T.ex. i en beskrivning av elementet <Forsakring> används sökvägen Parter/Fullmakt@Typ för att referera till attributet Typ på underelementet <Fullmakt> i underelementet <Parter>.

2.2.3 Namespace-prefixI alla XML-fragment som används som exempel i detta dokument används alltid namespace-prefixet ml: som prefix för standardens namespace. I verkliga MISLIFE-filer står det givetvis avsändaren fritt att använda vilket namespace-prefix som helst, eller att använda standardens namespace som default namespace.

2.2.4 FormatteringarNedanstående tabell summerar de olika formatteringar som används i dokumentet:

Formattering BetydelseXML Används då XML-innehåll (elementnamn, typnamn, attributnamn, hela XML-

fragment etc) skrivs ut i dokumentet.Term Används då en ny term introduceras i texten.TBD Används för noteringar om att något är ofärdigt eller behöver kompletteras i

dokumentet..[Dokument-ID] Används vid referenser till andra dokument i standarden.http://www.sfm.se Används då klickbara hyperlänkar skrivs ut i dokumentet.

2.3 DefinitionerTerm Betydelse

Anslutning TBDAvsändare TBDAvtal TBDDefinition TBDFörsäkring TBDImplementation TBDMISLIFE-fil TBDMoment TBDMomentgrupp TBD


100

101102

103

104105106107108

109110111112

113114

115

http://www.sfm.se/

http://www.w3.org/TR/xpath

Mottagare TBDNamespace TBDNIL TBDNormativ TBDParter TBDProdukt TBDReferera TBDRotelement TBDSchema-valideringValidering

TBD

Specifikation TBDStandard TBDStruktur TBDTeckning TBDTillämpning TBDTillämpningsspecifik TBDTyp TBDXML TBDXML-elementElement

TBD

XML-fil TBDXML-fragment TBDXML-innehåll TBDXML-strukturer TBDXML-vokabulär TBDXSD TBDXSD-fil TBD

3 MISLIFE som informationsstandardMISLIFE är en standard som specificerar en XML-vokabulär för utbyte av pensions- och livförsäkringsrelaterad information mellan organisationer i försäkringsbranschen. Standarden beskriver en överenskommelse mellan ett antal berörda organisationer om ett sätt att representera denna information i XML-filer för överföring mellan organisationernas system.

3.1 TillämpningsneutralDen informationsstruktur som definieras av MISLIFE är inte anpassad för någon viss informationsutväxling mellan några givna parter, eller för någon specifik tillämpning. Strukturens utformning och nomenklatur utgår från själva informationen i dess renaste form och dess betydelse i sig själv, snarare än dess tillämpning eller dess avsedda användning hos någon viss mottagare.

Däremot finns det mekanismer i standarden för att kunna representera tillämpningsspecifik information i MISLIFE-filer. Med tillämpningsspecifik information avses sådan information som två parter överenskommer att utbyta i sin tillämpning, men som inte är generell nog att rättfärdiga en plats i själva standarden. Se avsnitt nedan för mer information om tillämpningsspecifik utökning.


116

117118119120

121

122123124125

126127128129

3.2 Ej tvingandeMISLIFE ska primärt syfta till att tillhandahålla ett hjälpmedel och ett ramverk för informationsleverans, inte vara ett tvingande regelverk för implementerande parter. Det mesta i strukturen utgörs därför av valfria element, och det är upp till implementerande parter att komma överens om vad som ska skickas och vad som ska utelämnas i en viss tillämpning. Vissa valfria element kan däremot ha obligatoriska underelement i sådana fall där det ena rent strukturellt hänger ihop med det andra.

3.3 AvgränsningInformation som avsändaren av en MISLIFE-fil inte är ägare till ligger utanför standardens omfattning. Ett exempel är adressuppgifter för personer och organisationer; dessa kan härledas med hjälp av person- resp. organisationsnummer från andra register vilka ligger helt utanför avsändarens domän. Personers och organisationers namn har emellertid medtagits i strukturen eftersom dessa väsentligen kan underlätta identifikation av personer resp. organisationer.

Standarden anges hur pensions- och livförsäkringsrelaterad information ska representeras i en MISLIFE-fil samt hur en mottagare ska tolka MISLIFE-filens innehåll. Standarden anger emellertid inte hur en sådan fil ska transporteras från avsändare till mottagare; detta ligger helt utanför standarden MISLIFE och är upp till tillämpande parter att komma överens om.

4 MISLIFE som XML-vokabulärMISLIFE som standard specificerar en XML-vokabulär. Denna vokabulär utgörs av ett antal definierade XML-strukturer som med en definierad semantisk betydelse kan användas för att representera pensions- och livförsäkringsrelaterad information. Dessa XML-strukturer kan användas för deklaration av ett antal XML-element som tillsammans utgör innehållet i en MISLIFE-fil (en XML-formaterad fil baserad på standardens XML-vokabulär).

Vokabulären beskrivs normativt dels med hjälp av en specifikation i dokumentform och dels med hjälp av ett antal XSD-filer. Dessa XSD-filer kan användas för att maskinellt verifiera att en MISLIFE-fil konformerar till standarden genom schema-validering.

4.1 NamespaceAlla XML-strukturer som definieras av MISLIFE hör till ett och samma target namespace. Standardens versionsnummer bakas in i detta namespace för att underlätta versionshantering och minska risken för förväxling och valideringsmässiga konflikter mellan MISLIFE-filer som konformerar till olika versioner av standarden.

Alla element i en MISLIFE-fil ska vara namespace-kvalificerade. Detta för att underlätta för tillämpningar då innehåll från olika namespaces mixas i samma dokument.

Namespace för MISLIFE-1.7.0 är http://schemas.sfm.se/mislife-1.7.0.

MISLIFE-1.7.0 introducerar ett antal förändringar i formatet jämfört med MISLIFE-1.6.2 och tidigare:

1. Namnet schemas används som host för att indikera dels att det handlar om ett schema och dels att detta namespace inte mappar mot en fysisk plats, utan bara utgör en logisk container baserat på ägandeskap av domänen sfm.se. Detta är en vedertagen best practice inom XML-tillämpning.


130

131132133134135

136

137138139140141

142143144145

146

147148149150151

152153154

155

156157158159

160161

162

163

164165166

http://schemas.sfm.se/mislife-1.7.0

2. Skiljetecken har introducerats mellan standardnamnet och versionsnumret.3. Skiljetecken har introducerats mellan versionsnumrets led, för att säkerställa korrekt hantering av

situationen då något led i versionsnumret når 10 eller högre. Utan skiljetecken skulle det innebära tvetydighet samt felaktigt resultat av textuell komparation mellan två versionsnummer.

4.2 Äldre och nyare strukturMISLIFE-1.7.0 introducerar en helt ny struktur jämfört med tidigare versioner (MISLIFE-1.6.2 och tidigare). Den nyare strukturen har följande fördelar jämfört med den äldre:

Stöd för ett antal informationsstrukturer som saknas i den äldra strukturen, t.ex. statlig och/eller kommunala kollektivavtalad tjänstepension.

Bättre valideringsbarhet av MISLIFE-filer, dels för att strukturen som sådan är mer valideringsbar och dels för stor möda lagts vid att så detaljerat som möjligt definiera innehållsregler i XSD-filerna för den nya strukturen.

Rikare och mer konventionsenlig tillämpning av XML som teknik. Bättre mänsklig läsbarhet genom beskrivande element- och attributnamn, utskrivna begrepp istället

för förkortningar och en rikare strukturerad XML som på ett mer intuitivt sätt förmedlar informationens struktur.

Enklare maskinell produktion och konsumtion, dels genom ökad användning av inbyggda datatyper och konstruktioner och dels genom att den nya strukturen är mer navigerbar med t.ex. XPath.

Den nyare strukturen överlappar delvis den äldre innehållsmässigt och är tänkt att på sikt helt ersätta den äldre. Den nyare strukturen är dock fortfarande under uppbyggnad och kan ännu inte representera alla informationsstrukturer som finns i den gamla. Därför har den äldre strukturen tillsvidare bibehållits i sin helhet och lever parallellt med den nya. Det står kommunicerande parter fritt att använda den gamla eller den nya strukturen, eller för all del en kombination av de båda, i sina tillämpningar. Information enligt både den äldre och den nyare strukturen kan samexistera i samma MISLIFE-fil.

Fördelarna med den nyare strukturen kommer troligtvis att bli fler i takt med att den kompletteras och förses med stöd för t.ex. fler momenttyper. Förhoppningen är därför att tillämpande organisationer succcessivt ska övergå till den nya strukturen över tid.

Alla MISLIFE-filer som redan konformerar med MISLIFE-1.6.2 konformerar även med MISLIFE-1.7.0, och följaktligen kommer en MISLIFE-fil som validerar framgångsrikt mot XSD-filen för MISLIFE-1.6.2 även att validera framgångsrikt mot XSD-filerna för MISLIFE-1.7.0; den enda förändring som krävs är byte av XML-namespace. Detta förblir sant så länge den äldre strukturen bibehålls i standarden.

4.3 SpråkI den nyare strukturen används uteslutande svenska termer och begrepp. Det primära tillämpningsområdet för MISLIFE som standard får anses vara inom Sverige. Att använda engelska begrepp skulle inte bara ta mycket tid och energi i anspråk för själva översättningen, utan även göra standarden mer svårbegriplig för majoriteten av alla som behöver befatta sig med den och de dokument som konformerar med den.

Däremot har AAO använts istället för ÅÄÖ i element- och attributnamn för att minska risken för problem med mjukvara som inte hanterar internationella tecken korrekt.

Det bör noteras att den äldre strukturen (MISLIFE-1.6.2 och tidigare) är en smula inkonsekvent på det här området; engelska elementnamn används visserligen, men pga. hur struktureren är uppbyggd utgörs dessa enbart av relativt generella begrepp, medan de flesta branschspecifika begrepp istället representeras som bokstavsförkortningar som utgår från svenska begrepp.


167168169170

171

172173

174175176177178179180181182183184

185186187188189190

191192193

194195196197

198

199200201202

203204

205206207208

Tydliga beskrivande namn och utskrivna begrepp istället för förkortningar används i möjligaste mån för att underlätta mänsklig läsbarhet av informationen. Detta medför i många fall ökad filstorlek, vilket dock får anses ha underordnad betydelse idag.

4.4 Best practicesEtablerade XML-konventioner och best practices används i så stor utsträckning som möjligt i den nyare strukturen. Detta innefattar aspekter som t.ex. bruk av element vs. attribut, bruk av grupperande element, namespace-kvalificering, och mekanismer för tillämpningsspecifik utökning.

Befintliga typer och konstruktioner som definieras i standarderna för XML och XSD används i så stor utsträckning som möjligt, istället för att ”återuppfinna hjulet”. Detta främjar förenklad implementation eftersom mjukvara i regel har inbyggt stöd för att mappa dessa inbyggda typer till typer i resp. utvecklingsplattform.

Ett exempel på detta är användningen av XML-typen duration. Varaktighet anges med denna datatyp, begränsad till enbart år och månad. Detta ger flexibilitet åt avsändaren att antingen ange varaktighet som år, eller som månader, eller som en kombination av de två. Oavsett vilket som används får mottagaren ut det som en normaliserad varaktighet på andra sidan, åtminstone om man använder etablerade XML-parsers och validatorer. "P2Y", "P1Y12M" och "P24M" är med andra ord helt ekvivalenta. Detta berör angivelser av ålder, tjänstetid och uttagstid i den nya strukturen.

4.5 XSD-filer och schema-valideringDe XSD-filer som normativt beskriver XML-vokabulären MISLIFE kan användas dels som okulär referens och dels för schema-validering av MISLIFE-filer. För att förenkla underhåll och förbättra översiktligheten har XSD-definitionerna delats upp i två filer:

1. [mislife-1.7.0-legacy] innehåller allt som hör till den äldre strukturen (MISLIFE-1.6.2 och tidigare) förutom rotelementet <MISLIFE>.

2. [mislife-1.7.0-main] innehåller rotelementet <MISLIFE> och allt som hör till den nyare strukturen (MISLIFE-1.7.0 och senare).

MISLIFE-filer valideras mot [mislife-1.7.0-main]. Denna XSD-fil innehåller en inklusion av [mislife-1.7.0-legacy]. Vid schema-validering krävs normalt bara att båda XSD-filerna finns tillgängliga för valideringsprocessern på samma sökväg för att inklusionen ska fungera. Om så är fallet valideras både äldre och nyare innehåll i MISLIFE-filen mot resp. struktur i XSD-filerna.

Nedanstående diagram illustrerar relationen mellan XSD-filerna vid valideringen:


209210211

212

213214215

216217218219

220221222223224225

226

227228229

230231232233

234235236237

238

[mislife-1.7.0-legacy]

Äldre struktur

[mislife-1.7.0-main]

Nyare struktur

Äldre struktur

[inkluderas]

MISLIFE-fil

[valideras]

4.5.1 Förenklad variantUtöver detta har även en förenklad variant av [mislife-1.7.0-main] tagits fram. Denna har ID [mislife-1.7.0- simple] och kan användas för schema-validering av MISLIFE-filer på tekniska plattformar som saknar fullständigt stöd för vissa av de avancerade XML-konstruktioner som tillämpas i den striktare XSD-filen [mislife-1.7.0-main]. Exempelvis finns ett känt fel i Microsoft .NET Framework 3.5 SP1 och tidigare som gör att schema-validering mot den striktare XSD-filen inte fungerar i vissa fall.

Observera dock att schema-validering mot den förenklade varianten [mislife-1.7.0- simple] inte är lika strikt som mot huvudvarianten. Vissa strukturella fel som kontrolleras av huvudvarianten går oupptäckta igenom en schema-validering mot den förenklade varianten.

Den förenklade XSD-filen ska dock inte användas som okulär referens eller som mall vid konstruktion av programkod för att läsa eller skriva MISLIFE-filer.

4.6 VersionshanteringTBD

4.7 Tillämpningsspecifik utökningFör att underlätta tillämpningsspecifik utökning av standarden och utväxling av tillämpningsspecifik information har i den nyare strukturen införts ett element vid namn <Tillampningsspecifikt> som återkommer på ett antal utvalda ställen i strukturen.

Detta elements innehåll <xsd:any> vilket gör att implementerande parter kan lägga vilket innehåll som helst i detta element och fortfarande validera MISLIFE-filen mot XSD-filerna för MISLIFE så länge innehållet utgörs av giltig XML och tillhör ett annat namespace än standardens. Det är upp till parterna i en informationsutväxling att komma överens om vilken tillämpningsspecifik information som ska skickas i dessa element.

Principiellt är detta att likställa med att parterna tar fram ett eget sekundärt filformat och utväxlar detta parallellt med MISLIFE-filerna; rent praktiskt är det dock mycket fördelaktigt att kunna placera denna information i sitt sammanhang kopplat till den ordinarie strukturen i den övriga MISLIFE-filen.

Elementen <Tillampningsspecifikt> kan även användas för preliminära tillägg i standarden. Teknikgruppen kan då utfärda rekommendationer om att en viss information bör representeras på ett visst sätt i ett av dessa element, i väntan på att en ny version av standarden kommer där denna information ges en ordentlig plats i den ordinarie strukturen.


239

240241242243244245

246247248

249250

251

252

253

254255256

257258259260

261262263

264265266267

4.7.1 Validering av tillämpningsspecifikt innehållNär en MISLIFE-fil valideras enbart mot XSD-filerna för MISLIFE sker ingen validering av tillämpningsspecifik information, förutom att innehållet måste vara giltig XML och tillhöra ett annat namespace än standardens. Tillämpande parter bör därför vidta åtgärder för att även det tillämpningsspecifika innehållet ska schema-valideras.

4.7.1.1 Alternativ 1: Använd endast officiella XSD-filerParterna validerar MISLIFE-filerna enbart mot XSD-filerna för MISLIFE. Ingen strukturell validering sker av innehållet i <Tillampningsspecifikt> utöver att det är giltig XML och tillhör ett annat namespace än standardens.

Fördelar Nackdelar

Endast en XSD behövs för validering Ingen schema-validering sker av tillämpningsspecifikt innehåll

Nedanstående XML-fragment illustrerar hur denna metod kan användas i en MISLIFE-fil:

<ml:Tillampningsspecifikt xmlns:ml=”http://schemas.sfm.se/mislife-1.7.0”><ns:Avgangsoption xmlns:ns=”http://schemas.bolaget.se/mislife/utokning”>

PE<ns:Avgangsoption>

</ml:Tillampningsspecifikt>

4.7.1.2 Alternativ 2: Kopiera och modifiera officiell XSDParterna skapar en anpassad tillämpningsspecifik variant av XSD-filerna för MISLIFE, och validerar MISLIFE-filerna mot denna. De tillämpande parterna tar helt sonika de officiella XSD-filerna, tar bort <xsd:any> under <Tillampningsspecifikt> och lägger istället in definitioner för den struktur parterna kommit överens om att skicka.

Fördelar Nackdelar

Endast en XSD och ett namespace behövs för validering

Även tillämpningsspecifikt innehåll valideras

Inte strikt korrekt eftersom de tillämpningsspecifika definitionerna ligger i ett namespace som de officiellt inte tillhör

MISLIFE-filen validerar inte längre mot de officiella XSD-filerna

Arbetet måste göras på nytt för varje ny officiell version av XSD-filerna som utkommer

Nedanstående anpassade XSD-fragment illustrerar denna metod:

<xs:element name="Tillampningsspecifikt"> <xs:complexType>

<xs:sequence><xs:element name="Avgangsoption" minOccurs="0" maxOccurs="1">

<xs:simpleType><xs:restriction base="xs:token">

<xs:enumeration value="PE" /><xs:enumeration value="SPE" />

</xs:restriction></xs:simpleType>

</xs:element></xs:sequence>

</xs:complexType></xs:element>


268269270271272

273274275276

277

278279280281282

283284285286287

288

289290291292293294295296297298299300301302


<ml:Tillampningsspecifikt xmlns:ml=”http://schemas.sfm.se/mislife-1.7.0”><ml:Avgangsoption>

PE</ml:Avgangsoption>

</ml:Tillampningsspecifikt>

4.7.1.3 Alternativ 3: Kombinera officiell XSD med tillämpningsspecifik XSDParterna skapar en helt separat tillämpningsspecifik XSD-fil med ett eget target namespace som bara innehåller definitioner för det tillämpningspecifika innehållet, och validerar MISLIFE-filerna mot både de officiella XSD-filerna för MISLIFE samt den tillämpningsspecifika XSD-filen.

Denna metod rekommenderas.

Fördelar Nackdelar

Officiella och tillämpningsspecifika definitioner ligger i olika namespaces

Även tillämpningsspecifikt innehåll valideras MISLIFE-filer validerar även framgångsrikt

mot enbart de officiella XSD-filerna. Den tillämpningsspecifika XSD-filen behöver

inte modifieras vid varje ny version av de officiella XSD-filerna.

Både de officiella XSD-filerna för MISLIFE samt den tillämpningsspecifika XSD-filen måste vara tillgängliga för validatorn vid valideringen.

Nedanstående tillämpningsspecifika XSD-fragment illustrerar denna metod:

<xs:schema targetNamespace="http://schemas.bolaget.se/mislife/utokning" xmlns:xs="http://www.w3.org/2001/XMLSchema">

<xs:element name="Avgangsoption"><xs:simpleType>

<xs:restriction base="xs:token"><xs:enumeration value="PE" /><xs:enumeration value="SPE" />

</xs:restriction></xs:simpleType>

</xs:element></xs:schema>


<ml:Tillampningsspecifikt><ns:Avgangsoption xmlns:ns="http://schemas.bolaget.se/mislife/utokning">

PE</ns:Avgangsoption>

</ns:Tillampningsspecifikt>

4.8 Allmänna tillämpningsregler

4.8.1 Utelämnat element vs NIL vs nollDet finns ett antal tänkbara sätt att utelämna en viss uppgift i en MISLIFE-fil. För att inte riskera misstolkning (maskinell eller manuell) av informationen måste avsändare och mottagare ha samma syn på vad de olika sätten att utelämna en uppgift har för semantisk betydelse.

Det finns tre sätt att utelämna en uppgift i den nyare strukturen:


303

304305306307308

309310311312

313

314

315316317318319320321322323324325

326

327328329330331

332

333334335336

337

Metod Beskrivning Används när

Utelämnat Ett element eller attribut utelämnas helt

a) MISLIFE-filen inte säger något om uppgiften eller dess existens i avsändarens system, antingen för att parterna kommit överens om att uppgiften inte ska skickas, för att avsändaren saknar möjlighet att leverera uppgiften, eller för att dokumentet konstruerats utifrån en äldre version av standarden där denna uppgift inte fanns.

b) uppgiften inte är strukturellt tillämplig; t.ex. utelämnas elementet ml:OvergangsbestammelsePa03 när ml:Anslutning@AvtalNamn inte har värdet ”Pa03”.

c) uppgiften har ett default-värde i XSD-filen och detta värde ska gälla för uppgiften; t.ex. kan attributet ml:Belopp@Valuta utelämnas om värdet ”SEK” avses. Konstruktionen används enbart för attribut, inte för element.

d) uppgiftens värde anges på en mer övergripande nivå i MISLIFE-filen; t.ex. utelämnas attributet ml:Forman/ml:Belopp@Datum om ml:Anslutning@Informationstidpunkt ska gälla som övergripande värde istället. Konstruktionen används enbart för attribut, inte för element.

NIL Ett element skickas utan innehåll men med attributet xsd:nil=”true”

e) uppgiften inte har något värde; t.ex. anges <ml:OvergangsbestammelsePa03 xsd:nil=”true” /> om avsändaren normalt levererar denna uppgift och uppgiften är strukturellt tillämplig, men den försäkrade inte omfattattas av någon övergångsbestämmelse inom PA03.

f) uppgiften saknas eller är dess värde är okänt av avsändaren; t.ex. anges <ml:Forsakringsgivare xsd:nil=”true” /> under <ml:TidigareForsakring> om tidigare försäkringsgivare är okänd.

Noll Ett element eller attribut anges med nollvärde (t.ex. talet 0 eller tom sträng beroende på typ)

g) uppgiften är strukturellt tillämpbar, dess värde är känt av avsändaren och värdet är noll; t.ex. anges <ml:OvrigLon>0</ml:OvrigLon> om andelen övrig lön är 0 SEK för den aktuella löneuppgiften.

NIL kan ses som en extra specificeringsgrad av utelämnat värde. I de fall där NIL är tillämpbart kan avsändaren om nödvändigt välja att istället utelämna uppgiften. Mottagaren får då emellertid mindre information om uppgiften ifråga, och tvingas förhålla sig till den enligt fall A ovan, dvs. som att dokumentet inte säger något alls om uppgiften.

I de fall då strukturen tillåter mer än en av ovanstående metoder anges det som regel uttryckligen i motsvarande XSD-fil samt i standardens dokumentation vilken metod som lämpligen används för vilken semantisk betydelse.

4.8.2 TidsangivelserAlla tidsangivelser i MISLIFE-filer uttrycks i UTC-form, utan angivelse av tidzonskomponent.

5 Översikt av strukturenEtt MISLIFE-dokument består normalt av rotelementet <MISLIFE> som i sin tur innehåller:


338339340341

342343344

345346

347

348

1. Innehåll enligt den äldre strukturen (MISLIFE-1.6.2 och tidigare). I detta ingår metadata och transportinformation för dokumentet, såsom avsändare och mottagare. Se avsnitt ovan för mer information om äldre och nyare struktur.

2. Innehåll enligt den nyare strukturen (MISLIFE-1.7.0 och senare). Detta består av:a. Ett antal personspecifika teckningar (anslutningar och försäkringar). Se avsnitt nedan för mer

information.b. Ett antal generella definitioner (avtal och produkter). Se avsnitt nedan för mer information. En

teckning kan referera till sin generella definition om denna också ingår i dokumentet.c. Övergripande tillämpningsspecifikt innehåll (kompletterande information som inte täcks av

specifikationen men som avsändare och mottagare överenskommit att hantera).

Följande diagram illustrerar den övergripande strukturen i en MISLIFE-fil:

5.1.1 Alternativt rotelementEn MISLIFE-fil för utväxling mellan två parter har normalt elementet <MISLIFE> som rotelement. En MISLIFE-fil kan emellertid även styckas upp och lagras internt i tillämpande organisationers system med något av följande globala element som rotelement och fortfarande schema-valideras:

<Anslutning> <Forsakring> <Avtal> <Produkt> <Momentgrupp> <Moment> <Tillampningsspecifikt>

6 Generella typerMISLIFE definierar ett antal generella återanvändbara typer som används som typdefinitioner för diverse element i olika delar av strukturen.


MIS

LIFE

[Äldre struktur]

Anslutningar

Försäkringar

Avtal

Produkter

Tillämpningsspecifikt

[refererar]

[refererar]

349350351352353354355356357358

359

360

361362363364

365366367368369370371

372

373374

6.1 IdentitetEn identitet i MISLIFE kan vara antingen en person (fysisk person) eller en organisation (juridisk person). Dessa representeras av typerna IdentitetAbstractType och dess två deriverade typer PersonType och OrganisationType. Nedanstående diagram illustrerar relationen mellan dessa typer:

På de ställen i strukturen där element ska representera en identitet används ibland den abstrakta bastypen IdentitetAbstractType (där identiteten kan vara antingen en person eller en organisation beroende på vad avsändaren anger) och ibland någon av de deriverade typerna (där standarden stipulerar att elementet ska vara det ena eller det andra).

Eftersom bastypen IdentitetAbstractType är abstrakt kan den aldrig användas som typ för ett element i en MISLIFE-fil; någon av de deriverade typerna PersonType och OrganisationType måste användas. IdentitetAbstractType används bara som generalisering och innehåller endast det gemensamma underelementet <Tillampningsspecifikt>.

6.1.1 PersonDen deriverade typen PersonType används för att representera en fysisk person. Nedanstående diagram illustrerar hur typen är definierad:


Identitet

AbstractType

Person

Type

Organisation

Type

375

376377378

379

380381382383

384385386387

388389390

391

392

Nedanstående tabell förklarar typens innehåll:

Element/attribut Förklaring

Tillampningsspecifikt Kompletterande uppgifter som avsändare och mottagare överenskommit att hantera.

Personnummer Personens svenska personnummer på formen ”yyyymmdd-nnnn”.Namn Personens fullständiga namn.Fornamn Personens förnamn.Efternamn Personens efternamn.Fodelsedatum Personens födelsedatum.

Observera att avsändaren här kan ange antingen ett fullständigt namn i ett och samma element, eller för- och efternamn separerade i enskilda element, beroende på vad avsändaren har för möjligheter.

Nedanstående XML-fragment är ett exempel på användning av PersonType:

<ml:Forsakringstagare xsi:type="ml:PersonType"><ml:Personnummer>19780223-4567</ml:Personnummer><ml:Fornamn>Bertil</ml:Fornamn><ml:Efternamn>Svensson</ml:Efternamn>

</ml:Forsakringstagare>

6.1.2 OrganisationDen deriverade typen OrganisationType används för att representera en organisation (juridisk person). Nedanstående diagram illustrerar hur typen är definierad:

Nedanstående tabell förklarar typens innehåll:

Element/attribut Förklaring

Tillampningsspecifikt Kompletterande uppgifter som avsändare och mottagare överenskommit att hantera.

Organisationsnummer Organisationens svenska organisationsnummer på formen ”nnnnnn-nnnn”.Namn Organisationens registrerade namn inklusive bolagsform.

Nedanstående XML-fragment är ett exempel på användning av OrganisationType:

<ml:Forsakringstagare xsi:type="ml:OrganisationType"><ml:Organisationsnummer>560101-1234</ml:Organisationsnummer><ml:Namn>Fiffel & Båg AB</ml:Namn>

</ml:Forsakringstagare>

6.2 BeloppTBD


393

394395

396

397398399400401

402403404

405

406

407

408409410411

412

413

6.2.1 Absolut beloppTBD

6.2.2 IndexbeloppTBD

6.2.3 FörmånTBD

6.3 VaraktighetTBD

6.3.1 ÅlderTBD

6.3.2 TjänstetidTBD

6.4 AvgifterTBD

6.4.1 AvgiftTBD

6.5 PremierTBD

6.5.1 PremieTBD

6.6 InnehavTBD


414415

416417

418419

420

421

422423

424425

426

427

428429

430

431

432433

434

435

7 Informationsenheter

7.1 TeckningarTBD

7.1.1 AnslutningTBD

7.1.2 FörsäkringTBD

7.2 DefinitionerTBD

7.2.1 AvtalTBD

7.2.2 ProduktTBD


Enhet

AbstractType

Teckning

AbstractType

Anslutning

Element

Forsakring

Element

Definition

AbstractType

Avtal

Element

Produkt

Element

identifierar ett identifierar ett

436

437

438

439

440

441

442443

444445

446

447

448449

450451

8 Moment

8.1 MomentgrupperTBD

8.2 Förmånsbestämd ålderspensionTBD

8.3 Premiebestämd ålderspensionTBD

8.4 EfterlevandepensionTBD

8.5 PremiebefrielseTBD

8.6 Förtids-/invaliditetskapitalTBD


Moment

AbstractType

Förmånsbestämd ålderspension

Type

Premiebestämd ålderspension

Type

Efterlevandepension

Type

Premiebefrielse

Type

Förtids-/invalidetetskapital

Type

Olycksfallsförsäkring

Type

Sjukförsäkring

Type

Sjukvårdsförsäkring

Type

452

453

454

455

456

457

458

459

460

461

462

463

464

465

8.7 OlycksfallsförsäkringTBD

8.8 SjukförsäkringTBD

8.9 SjukvårdsförsäkringTBD


466

467

468

469

470

471

MISLIFE: Teknisk översikt · Web viewMicrosoft Word (.docx) Adobe PDF (.pdf) En beskrivning av hur...

Documents

Transcript of MISLIFE: Teknisk översikt · Web viewMicrosoft Word (.docx) Adobe PDF (.pdf) En beskrivning av hur...