Vakuutusyhtiön tapaturmailmoitus Versio: 0.2 Muokattu: 23.6.2008
2(22) SISÄLLYS 1 Tarkoitus...3 1.1 Rajaus...3 1.2 Dokumentaatio...3 2 Tietojen esitystavat...3 2.1 Numeerinen tieto...3 2.2 Päivämäärät ja kellonajat...3 2.3 Totuusarvot...4 3 Sanoman rakenne...4 3.1 Otsikkotiedot (headerstype)...5 3.1.1 Vastaanottavan organisaation tiedot (DestinationOrganisationType)... 5 3.1.2 Lähettävän organisaation tiedot (SenderOrganisationType)...6 3.1.3 Välityspalvelun metatiedoto (ProxyInfo)... 6 3.2 Tapaturmailmoituksen tiedot (MessageType)... 6 3.2.1 Organisaatiotiedot (organisationtype)... 7 3.2.2 Henkilötiedot (InjuredPersonType)...8 3.2.3 Tapaturmatiedot (AccidentType)...9 3.2.4 Vammantiedot (InjuryType)...12 3.2.4.1 Tilastointitiedot (statisticstype)...12 3.2.4.2 Lisätiedot (AdditionalInformationType)... 13 3.2.5 Työsuhdetiedot (EmploymentType)... 13 3.2.6 Toisen työnantajan tiedot...15 3.2.7 Kuolemantapaus (FatalityType)...15 3.2.8 Silminnäkijän tiedot (eyewitnesstype)...16 3.2.9 Tapaturman aiheuttajan tiedot (AccidentCauserType)...17 3.2.10 Palkkatiedot (salarytype)...17 3.2.11 Sairausajanpalkka...19 3.2.12 Palkkiot ja maksusuoritukset...20 3.2.13 Liikenneonnettomuustiedot (traficaccidenttype)...21 3.2.14 Asiakaskohtaiset tiedot (CustomDataType)...22 4 Vastaussanoma...22 4.1 Poikkeuskäsittely...22 Muutokset: 23.6.2008 Tarkennuksia 24.4.2008 Lisätty päämiehen yhteyshenkilön tiedot sanomakuvaukseen
3(22) 1 Tarkoitus Tässä dokumentissa kuvataan liittymärajapinta, joka välittää -välityspalveluun toimitetun vakuutusyhtiölle toimitettavan tapaturmailmoituksen eteenpäin sanomassa määritellylle vakuutusyhtiölle. Vastauksena lähettävälle osapuolelle palautetaan kuittaus onnistuneesta tai epäonnistuneesta siirrosta. Välitettäväksi lähetetty sanoma voidaan välittää ainoastaan yhdelle vastaanottajalle kerralla. Mikäli sanoman käsittelyssä tapahtui virhe tai sanoma on puutteellinen, lähettäjälle palautetaan standardi virhesanoma. Virhesanoman sisältö ja rakenne on kuvattu omaan dokumenttiin. 1.1 Rajaus Tässä dokumentissa kuvattua XML-skeemakuvausta käytetään sekä viestin vastaanotossa välityspalveluun että sen edelleen välityksessä varsinaiselle sanoman vastaanottajalle. 1.2 Dokumentaatio Rajapintadokumentaatio muodostuu seuraavista osista ja dokumenteista: Tämä dokumentti kuvaa sanoman sisältämien elementtien sisällön Rajapinnan XML-skeemakuvaus Esimerkkisanoma 2 Tietojen esitystavat 2.1 Numeerinen tieto Numeerisen tiedon tietotyyppinä rajapinnassa on integer, short tai decimal. XML-skeemassa ei rajata numeerisen tiedon pituutta. Desimaalierottimena käytetään aina XML skeeman mukaisesti pistettä. 2.2 Päivämäärät ja kellonajat Kaikki päivämäärät määritellään sanomassa formaatissa: VVVV-KK-PP, esim. 2007-12-24 Kaikki kellonajat ilman päivämäärää määritellään sanomassa formaatissa: hh:mm:ss, esim. 09:30:00
4(22) Kellonajalla varustettu päivämäärä määritellään formaatissa: VVVV-KK- PPThh:mm:ss, esim. 2007-12-24T09:30:00 2.3 Totuusarvot Totuusarvoinen tieto esitetään boolean-muodossa. Rajapinnassa sallitut arvot ovat näinollen ainoastaan true ja false. 3 Sanoman rakenne Tapaturmailmoituksen sanomarakenne jakaantuu juuritasolla kahteen alielementtiin: headers ja message-tasoihin (kuvat 1 ja 2). Kuva 1. Kuva 2.
5(22) 3.1 Otsikkotiedot (headerstype) Elementin sisällä määritellään kaikki sanoman otsaketiedot (kuva 3). Kaikki otsaketiedot ovat rakenteeltaan samanlaiset jokaisessa välityspalvelun sanomatyypissä. Kuva 3. messagetype P Sanoman tyyppi: - vaaratilanneilmoitus - turvallisuushavainto - tapaturmailmoitus - taajuusilmoitus Tyyppi kirjataan sanomaan selväkielisenä merkkijonona. destinationorganisation P Päätason elementti, jonka alla määritellään kaikki sanoman vastaanottavan organisaation tiedot. senderorganisation P Päätason elementti, jonka alla määritellään kaikki sanoman lähettävän organisaation tiedot. proxyinfo Välityspalvelun omia asetuksia ja metatietoja, jotka välityspalvelu itse täyttää. Elementtiä ei saa itse tuottaa sanomaan. 3.1.1 Vastaanottavan organisaation tiedot (DestinationOrganisationType) Elementillä kuvataan sanoman vastaanottavan organisaation tiedot (kuva 3).
6(22) name P Sanoman vastaanottavan organisaation nimi organisationcode P Sanoman vastaanottavan organisaation koodi. Koodina käytetään yrityksen y-tunnusta. Y-tunnus tuodaan muodossa 1234567-8 tai 12345678. 3.1.2 Lähettävän organisaation tiedot (SenderOrganisationType) Elementillä kuvataan sanoman lähettävän organisaation tiedot (kuva 3). name P Sanoman vastaanottavan organisaation nimi organisationcode P Sanoman vastaanottavan organisaation koodi. Koodina käytetään yrityksen y-tunnusta. Y-tunnus tuodaan muodossa 1234567-8 tai 12345678. 3.1.3 Välityspalvelun metatiedoto (ProxyInfo) Elementillä kuvataan sanomavälityspalvelun omia metatietoja ja asetuksia, jotka välityspalvelu itse tuottaa sanomaan (kuva 3). Elementtiä ja sen sisältöä ei saa itse tuottaa sanomaan. Tietoja käytetään mm. lokitapahtumien kirjaukseen. messagereceivedtime messagesendtime Päivämäärä ja kellonaika, jolloin sanoma vastaanotettiin välityspalveluun. Päivämäärä ja kellonaika, jolloin sanoma lähetettiin välityspalvelusta sanoman vastaanottajalle. 3.2 Tapaturmailmoituksen tiedot (MessageType) Elementti sisältää kaikki tapaturmailmoituksen tiedot (kuva 4) mukaanlukien organisaation ja henkilön tiedot. Elementti jakaantuu rakenteellisesti useampaan eri alielementtiin. Alielementit on kuvattu tarkemmin kukin omassa kappaleessaan myöhemmin tässä dokumentissa.
7(22) Kuva 4. 3.2.1 Organisaatiotiedot (organisationtype) Elementillä määritellään ilmoittajan organisaation tiedot (kuva 5). Elementti liittyy aina message-elementtiin. Kuva 5. Name P Organisaation nimi OrganisationCode P Organisaation koodi. Koodina käytetään yrityksen y-tunnusta. Y-tunnus tuodaan muodossa 1234567-8 tai 12345678. Address PostalCode Organisaation katu- tai postilokero-osoite. Organisaation postinumero
8(22) PostOffice CountryCode PhoneNumber Fax Email BusinessAreaName Organisaation postitoimipaikka Maakoodi FI = suomi Organisaation puhelinnumero Organisaation faksinumero Organisaation sähköpostiosoite Organisaation liiketoiminta-alue BankAccount P Pankkiyhteystiedot BankName P Pankin nimi Department CorporationName InsuranceCompanyName InsuranceNumber Osasto Konsernitunnus Vakuutusyhtiön nimi Vakuutusnumero 3.2.2 Henkilötiedot (InjuredPersonType) Elementillä määritellään henkilötiedot, jolle tapaturma tapahtui (kuva 6). Elementti liittyy aina message-elementtiin. Kuva 6. lastname P Henkilön sukunimi firstname P Henkilön etunimi
9(22) IndentityNumber P Henkilötunnus Address P Henkilön katuosoite PostCode P Henkilön postinumero PostOffice P Henkilön postitoimipaikka HomePhone Language Nationality Profession BankAccount Bank Henkilön kotipuhelinnumero Henkilön kieli FI = suomi SE = ruotsi EN = englanti Henkilön kansalaisuus FI = suomi SE = ruotsi EN = englanti Henkilön ammatti Henkilön pankkiyhteystiedot (tilinumero) Pankin nimi IsPersonPartner Onko henkilö yrityksen osakas. Sallitut arvot true / false IsPersonOnlyPartner OwnedPercentageWithFamil ymember PersonLivesWithEmployer personrelatedtoemployer Onko henkilö ainoastaan yrityksen osakas? Sallitut arvot true / false. Perheen omistama omistusosuus. Henkilö asuu työnantajan kanssa samassa taloudessa. Sallitut arvot true / false. Onko henkilö sukua työnantajalle Sallitut arvot: true / false. 3.2.3 Tapaturmatiedot (AccidentType) Elementillä määritellään tapaturman tiedot (kuva 7). Elementti liittyy aina messageelementtiin.
10(22) Kuva 7. ReferenceId P Tapaturman yksilöivä tunniste Type P Tapaturman tyyppi Sallitut arvot: tapaturma tai ammattitauti EventDate P Tapahtumapäivä EventTime P Tapahtumakellonaika EventLocation P Tapahtumapaikka Sallitut arvot: 01 = Työpaikalla tai työpaikkaan kuuluvalla alueella 02 = Työpaikan ulkopuolella EventLocationDetail P Tapahtumapaikan tarkennus. Sallitut arvot Mikäli EventLocation -kenttään on valittu arvo 01, tulee käyttää seuraavia tietoja: 01 = Työssä 02 = Ei työtehtävissä 03 = Kahvi- tai ruokatauolla tai mikäli EventLocation -kenttään on valittu arvo 02, tulee käyttää seuraavia tietoja: 04 = Työtehtävissä 05 = Kahvi- tai ruokatauolla 06 = Matkalla työstä asunnolle 07 = Matkalla asunnosta työhön
11(22) OccuderOther 08 = Vapaa-aikana 09 = Muulla matkalla, millä? EventCity P Tapahtumakunta EventAddress EventAtWorkOrBreak Kuvaus tapahtumapaikasta, jos paikka oli jokin muu Tapahtumaosoite Tapahtuiko tapaturma työssä vai tauolla WorkStartTime P Työvuoron alkamiskellonaika WorkEndTime P Työvuoron päättymiskellonaika OtherTravel ReportedToEmployer P Ilmoitettu työnantajalle Sallitut arvot: true / false ReportedtoEmployerDate P Päivä jolloin ilmoitettu työnantajalle WorkEndedAfterInjury WorkEndedAfterinjuryDate WorkEndedAfterinjuryTime Työ päättyi Sallitut arvot: true / false Työ päättyi pvm Työ päättyi klo MedicalTreatmentStarted P Hoito alkoi Sallitut arvot: 01 = heti 02 = myöhemmin MedicalTreatmentStartedDat e DisabilityDuration P Työkyvyttömyysaika NursingInstitution NursingInstitutionName HasReturnedToWork ReturnDate AdditionaInformationPersonN ame AdditionaInformationPersonA ddress AdditionaInformationPersonP hone AdditionaInformationPersone mail description Hoidon alkamispäivä. Syötetään päivämäärä mikäli hoito alkoi myöhemmin Hoitopaikka Sallitut arvot: 01 = sairaala 02 = terveyskeskus 03 = yksityinen sairaala Hoitopaikan nimi Onko työntekijä palannut takaisin töihin Sallitut arvot: true/false Töihin paluupäivä Lisätietoja antavan henkilön nimi Lisätietoja antavan henkilön osoite Lisätietoja antavan henkilön puhelinnumero Lisätietoja antavan henkilön sähköpostiosoite Lisätietoja tapaturmasta
12(22) 3.2.4 Vammantiedot (InjuryType) Elementillä määritellään tapaturmasta aiheutuneet vammatiedot (kuva 8). Elementti liittyy aina message-elementtiin. Tiedot perustuvat ESAW-koodiston tietoihin ja kuvauksiin. Kuva 8. TypeOfInjuryCode P Vammanlaatu (Esaw-koodi) TypeOfInjuryCodeDescriptio n Vammanlaadun selväkielinen kuvaus (fi) PartsOfBodyCode P Ruumiinosat (Esaw-koodi) PartOfBodyCodeDescription Ruumiinosan selväkielinen kuvaus (fi) LeftOrRightSide P Kehon vasen vai oikea puoli. Sallitut arvot: - left (vasen) - right (oikea) - both (molemmat). 3.2.4.1 Tilastointitiedot (statisticstype) Elementillä määritellään tapaturmailmoituksen tilastointitiedot (kuva 9). Elementti liittyy aina message-elementtiin. Kuva 9
13(22) WorkingProcessCode P Työtehtävä (Esaw-koodi) WorkingProcessCodeDescrip tion Työtehtävän selväkielinen kuvaus (fi) SpecificPhysicalActivityCode P Työsuoritus (Esaw-koodi) SpecificPhysicalActivityCode Description Työsuorituksen selväkielinen kuvaus (fi) DeviationCode P Poikkeama (Esaw-koodi) DeviationCodeDescription Poikkeaman selväkielinen kuvaus (fi) contactmodeofinjurycode P Vahingoittumistapa (Esaw-koodi) ContactModeOfInjuryCodeD escription Vahingoittumistavan selväkielinen kuvaus (fi) MaterialAgentCode P Aiheuttaja (Esaw-koodi) materialagentcodedescriptio n Aiheuttajan selväkielinen kuvaus (fi) 3.2.4.2 Lisätiedot (AdditionalInformationType) Elementillä määritellään vaaratilanteen viranomaistiedot (kuva 10). Elementti liittyy aina message-elementtiin. Kuva 10 PersonName Lisätietoja antavan henkilön nimi PersonAddress Lisätietoja antavan henkilön osoite PersonPhone Lisätietoja antavan henkilön puhelinnumero PoliceInvestigationInitiated Poliisitutkinta alkanut policestation Poliisilaitoksen nimi 3.2.5 Työsuhdetiedot (EmploymentType) Elementillä kuvataan henkiön ensisijaiset työsuhdetiedot nykyisen työnantajan kanssa (kuva 11). Elementti liittyy aina message-elementtiin.
14(22) StartDate Kuva 11. PermamentOrShortTimeEmp loyment WeeklyWorkHours ShortTimeEmploymentEndD ate PrimaryOrSecondaryEmploy ment PersonStudentOrPensioner P Työsuhde alkoi yrityksessä Työsuhteen luonne Sallitut arvot 01 = Toistaiseksi 02 = Määräaikainen 03 = Työharjoittelu Viikkotuntien lukumäärä Määräaikaisen työsuhteen päättymispäivä Toimenlaatu: Päätoimi / sivutoimi Sallitut arvot: 01 = päätoimi 02 = sivutoimi Muu asema StudentInstitute StudentFutureProfession IsPartTime PartTimeHoursOfDay PartTimeDaysOfWeek PartTimeReason 01 = Harjoittelija 02 = Opiskelija 03 = Eläkeläinen Oppilaitoksen nimi Osa-aikainen Sallitut arvot true / false Osa-aikaisen työsuhteen työaika päivässä Osa-aikaisen työsuhteen työaika viikossa Osa-aikaisuuden syy
15(22) 3.2.6 Toisen työnantajan tiedot Elementillä kuvataan henkilön mahdollisen toissijaisen työnantajan tiedot (kuva 12). Elementti liittyy aina message-elementtiin. Kuva 12 Name Työnantajan nimi Address Katuosoite PostalCode Postinumero PostOffice Postitoimipaikka IsPersonEntrepreneur Onko henkilö yrittäjä. Sallitut arvot true / false enterprisedescription Yrityskuvaus 3.2.7 Kuolemantapaus (FatalityType) Elementillä kuvataan kuolemaan johtaneen tapaturman tiedot (kuva 13). Elementti liittyy aina message-elementtiin.
16(22) FatalityDate Relatives RelationShip Kuva 13 DeathEstateManagerName DeathEstateManagerAddres s DeathEstateManagerPostalC ode DeathEstateManagerPostOffi ce DeathEstateManagerPhone Tapahtumapäivä Lähiomaiset Kuolinpesän hoitajan nimi Kuolinpesän hoitajan osoite Kuolinpesän hoitajan osoitteen postinumero Kuolinpesän hoitajan osoitteen postitoimipaikka Kuolinpesän hoitajan puhelinnumero 3.2.8 Silminnäkijän tiedot (eyewitnesstype) Elementissä kuvataan silminnäkijän tiedot (kuva 14). Elementti liittyy aina messageelementtiin. Kuva 14 Name Silminnäkijän nimi Address Silminnäkijän osoite PostalCode Silminnäkijän osoitteen postinumero PostOffice Silminnäkijän osoitteen postitoimipaikka
17(22) 3.2.9 Tapaturman aiheuttajan tiedot (AccidentCauserType) Elementillä kuvataan tapaturman aiheuttajan tiedot (kuva 15). Elementti liittyy aina message-elementtiin. Kuva 15 Name Aiheuttajan nimi Address Aiheuttajan osoite PostalCode Aiheuttajan osoitteen postinumero PostOffice Aiheuttajan osoitteen postitoimipaikka 3.2.10 Palkkatiedot (salarytype) Elementillä kuvataan henkilön palkkatiedot (kuva 16). Elementti liittyy aina messageelementtiin.
18(22) TaxationCity Kuva 16 TaxBasicRate TaxAdditionRate TaxYearIncomeCeiling MonthlyTaxrateForStep1 MonthlyTaxIncomeCeilingFor Step1 MonthlyTaxrateForStep2 MonthlyTaxIncomeCeilingFor Step2 MonthlyTaxrateForStep3 monthlytaxincomeceilingfor Step3 SalaryBasis NumberOfWorkDays NumberOfWorkHours MonthlySalaryAmount AdditionalSalaryForMonth Henkikirjoituskunta Verotuksen perusprosentti Verotuksen lisäverotusprosentti Rajatulo (euroissa), johon saakka perusprosenttia sovelletaan vuodessa Palkan määräytymisperuste Työpäivien lukumäärä Työtuntien lukumäärä Kuukausipalkka Lisät kuukausipalkkaan keskimäärin
19(22) AdditionalSalaryBasis Muut työnantajan maksusuoritukset PaidAsDecreasedSalary Period1StartDate Palkan maksuperusteen 1. aikavälin alkamispäivä Period1EndDate Palkan maksuperusteen 1. aikavälin päättymispäivä Period1Salary Maksettu palkka (euroa) 1. aikaväliltä Period2StartDate Palkan maksuperusteen 2. aikavälin alkamispäivä Period2EndDate Palkan maksuperusteen 3. aikavälin päättymispäivä Period2Salary Maksettu palkka (euroa) 2. aikaväliltä Period3StartDate Palkan maksuperusteen 3. aikavälin alkamispäivä Period3EndDate Palkan maksuperusteen 3. aikavälin päättymispäivä Period3Salary Maksettu palkka (euroa) 3. aikaväliltä UnpaidAbsence1StartDate 1. Palkattomat poissaolon alkamispäivä UnpaidAbsence1EndDate 1. Palkattomat poissaolon päättymispäivä UnpaidAbsence1Reason 1. Palkattomat poissaolon syy / selitys UnpaidAbsence2StartDate 2. Palkattomat poissaolon alkamispäivä UnpaidAbsence2EndDate 2. Palkattomat poissaolon päättymispäivä unpaidabsence2reason 2. Palkattomat poissaolon syy / selitys 3.2.11 Sairausajanpalkka Elementillä kuvataan sairausajan palkan peruste (kuva 16). Elementti liittyy aina message-elementtiin. SalaryPaid Kuva 16 Period1StartDate Sairausajan palkkakuvaus 1. jakson alkamispäivä Ilmoitetaan maksetun sairausajan palkan määrä neljän viikon ajalta tapaturmasta lukien, ei kuitenkaan tapaturmapäivältä alkaa
20(22) Period1EndDate Period2StartDate Period2EndDate Period1Salary Period2Salary PaymentObligationEndDate SalaryBasis 1. jakson päättymispäivä Ilmoitetaan maksetun sairausajan palkan määrä neljän viikon ajalta tapaturmasta lukien, ei kuitenkaan tapaturmapäivältä 2. jakson alkamispäivä Ilmoitetaan maksetun sairausajan palkan määrä neljän viikon ajalta tapaturmasta lukien, ei kuitenkaan tapaturmapäivältä alkaa 2. jakson päättymispäivä Ilmoitetaan maksetun sairausajan palkan määrä neljän viikon ajalta tapaturmasta lukien, ei kuitenkaan tapaturmapäivältä 1. jakson palkka 2. jakson palkka Sairausajan maksuvelvollisuuden päättymispäivä Sairausajan palkan määräytymisperuste 3.2.12 Palkkiot ja maksusuoritukset Elementillä kuvataan palkkiot ja maksusuoritukset (kuva 17). Elementti liittyy aina message-elementtiin. Kuva 17 Reimbursements MedicalTreatmentReimburse ment TravelExpenceReimburseme nt OtherExpencenceReimburse ment MedicalInsuranceDailyBenefi trequested Muut suoritukset kuin sairausajan palkka Sairaanhoitokulut Matkakulut Muut kulut Onko haettu sairasvakuutuksen päivärahaa
21(22) localsosialinsuranceinstitutio noffice KELAn paikallistoimiston nimi 3.2.13 Liikenneonnettomuustiedot (traficaccidenttype) Elementillä kuvataan liikenneonnettomuuden tiedot (kuva 18). Elementti liittyy aina message-elementtiin. Kuva 18. InjuredRegistrationNumber InjuredInsurer OtherRegistrationNumber OtherInsurer Participation Vahingoittuneen käyttämän ajoneuvon rekisteritunnus Vahingoittuneen osapuolen vakuutusyhtiö Toisen osapuolen ajoneuvon rekisteritunnus Toisen osapuolen vakuutusyhtiö Osallisuus: 01 = Matkustajana 02 = Kuljettajana Allekirjoitustiedot Elementillä kuvataan allekirjoitustiedot (kuva 19). Elementti liittyy aina messageelementtiin. Kuva 19
22(22) Date Location EmployerRepresentant EmployerRepresentantPhon e employerrepresentantemail Allekirjoituspäivä Allekirjoituskunta Työnantajan edustajan nimi Työnantajan edustajan puhelin Työnantajan edustajan sähköposti 3.2.14 Asiakaskohtaiset tiedot (CustomDataType) Elementillä määritellään asiakaskohtaiset vaaratilanne tms. Tiedot. (kuva 4). Esim. tietoja, joille ei ole sanomassa varattu omaa elementtiä. Elementti liittyy aina message-elementtiin. Tiedot määritellään sanomaan avain-arvo-pareina ja näitä voi olla sanomassa n-kpl. Key Value Tiedon avain Tiedon varsinainen arvo 4 Vastaussanoma Vastaussanoma on kuvattu omaan dokumenttiinsa. 4.1 Poikkeuskäsittely Mikäli sanoman käsittelyssä tapahtui jokin virhe, sanoman lähettäjälle palautetaan virhesanoma. Virhesanoman sisältö ja rakenne on kuvattu omaan dokumenttiinsa.