Tietojen jakelu Skeemat Työnantajan erillisilmoitukset Kansallisen tulorekisterin perustamishanke

Samankaltaiset tiedostot
Tietojen jakelu Skeemat Työnantajan erillisilmoitukset Kansallisen tulorekisterin perustamishanke

Tietojen jakelu Skeemat Viestit Kansallisen tulorekisterin perustamishanke

Tietojen toimittaminen Skeemat Työnantajan erillisilmoitukset Kansallisen tulorekisterin perustamishanke

Tietojen jakelu Skeemat Viestit Kansallisen tulorekisterin perustamishanke

Tietojen toimittaminen Skeemat Vastaanottokuittaus Kansallisen tulorekisterin perustamishanke

Tietojen toimittaminen Skeemat Käsittelypalautteen kysely Kansallisen tulorekisterin perustamishanke

Tietojen toimittaminen Skeemat Työnantajan erillisilmoitukset Kansallisen tulorekisterin perustamishanke

Tietojen toimittaminen Skeemat Työnantajan erillisilmoitukset Kansallisen tulorekisterin perustamishanke

Tietojen toimittaminen Skeemat Työnantajan erillisilmoitukset 2020 Tulorekisteriyksikkö

Tietojen toimittaminen Skeemat Käsittelypalaute Kansallisen tulorekisterin perustamishanke

Tietojen jakelu Skeemat Palvelupyyntö Kansallisen tulorekisterin perustamishanke

Tietojen toimittaminen Skeemat Mitätöintitiedot Kansallisen tulorekisterin perustamishanke

Tietojen toimittaminen Skeemat Käsittelypalaute Kansallisen tulorekisterin perustamishanke

Tietojen toimittaminen Skeemat Vastaanottokuittaus Kansallisen tulorekisterin perustamishanke

Tietojen jakelu Skeemat Lokitiedot Kansallisen tulorekisterin perustamishanke

Tietojen jakelu Skeemat Etuustietoilmoitukset Kansallisen tulorekisterin perustamishanke

Tietojen toimittaminen Skeemat Mitätöintitiedot Kansallisen tulorekisterin perustamishanke

Tietojen toimittaminen Skeemat Käsittelypalautteen kysely Kansallisen tulorekisterin perustamishanke

Tietojen toimittaminen Skeemat Viestit Kansallisen tulorekisterin perustamishanke

Tietojen jakelu Skeemat Palvelupyyntö Kansallisen tulorekisterin perustamishanke

Tietojen toimittaminen Skeemat Viestit Kansallisen tulorekisterin perustamishanke

Tietojen jakelu Skeemat Maksajan palkkatietojen yhteenveto Kansallisen tulorekisterin perustamishanke

Tietojen toimittaminen Skeemat Aineistotilaukset Kansallisen tulorekisterin perustamishanke

Tietojen toimittaminen Skeemat Aineistotilaukset Kansallisen tulorekisterin perustamishanke

Tietojen jakelu Skeemat Palkkatietoilmoitukset 2020 Tulorekisteriyksikkö

Tietojen jakelu Skeemat Palkkatietoilmoitukset Kansallisen tulorekisterin perustamishanke

Tietojen jakelu Skeemat Palkkatietoilmoitukset Kansallisen tulorekisterin perustamishanke

Palkkatietoilmoitus Esimerkki 2 Tilapäinen työnantaja

Tietojen toimittaminen - Skeemat - Etuustietoilmoitukset Kansallisen tulorekisterin perustamishanke

Palkkatietoilmoitus Esimerkki 6 Vakuuttamisen poikkeustilanne 1, ulkomainen työnantaja

Palkkatietoilmoitus Esimerkki 9 Tulolajin vakuuttamistiedon tyyppi

Tietojen toimittaminen - Skeemat - Palkkatietoilmoitukset 2020 Tulorekisteriyksikkö

Palkkatietoilmoitus Esimerkki 18 Työkorvaus, tulonsaajana luonnollinen henkilö

Palkkatietoilmoitus Esimerkki 12 Perusteeton etu, liikasuoritus huomataan ennen ilmoituksen lähettämistä

Tietojen toimittaminen - Skeemat - Palkkatietoilmoitukset Kansallisen tulorekisterin perustamishanke

Palkkatietoilmoitus Esimerkki 4 Julkisyhteisö maksajana

Palkkatietoilmoitus Esimerkki 1 Sopimustyönantaja, perustapaus

Tietojen toimittaminen - Skeemat - Palkkatietoilmoitukset Kansallisen tulorekisterin perustamishanke

Palkkatietoilmoitus Esimerkki 11 Perusteeton etu, liikasuoritus ilmoitettu aiemmin muuna tulona

Palkkatietoilmoitus Esimerkki 8 Tulonsaaja rajoitetusti verovelvollinen

Palkkatietoilmoitus Esimerkki 10 Poissaolotiedot

Palkkatietoilmoitus Esimerkki 17 Kustannusten korvaukset

Palkkatietoilmoitus Esimerkki 13 Takaisinperintä, bruttoperintä

Palkkatietoilmoitus Esimerkki 7 Vakuuttamisen poikkeustilanne 2, iän perusteella (15 vuotta) Korvaava ilmoitus

Palkkatietoilmoitus Esimerkki 16 Takaisinperintä, summa peritään takaisin kerralla

Tietojen toimittaminen - Skeemat - Palkkatietoilmoitukset Kansallisen tulorekisterin perustamishanke

Etuustietoilmoitus Esimerkki 1 Ansionmenetyskorvaus (liikennevakuutus), siihen liittyvä palkansaajamaksujen vähennys ja ennakonpidätys

Aineistotilaus Esimerkki 1 Palkkatietoilmoitukset kaikki tulonsaajat, jatkuva tilaus

Tietojen toimittaminen - Skeemat - Palkkatietoilmoitukset Kansallisen tulorekisterin perustamishanke

Aineistotilaus Esimerkki 4 Palkkatietoilmoitukset useita maksajia 1, jatkuva tilaus

Varmennepalvelu Rajapintakuvaus Kansallisen tulorekisterin perustamishanke

Tekninen rajapinta Zip-tiedosto sovelluskehittäjälle Kansallisen tulorekisterin perustamishanke

Aineistotilaus Esimerkki 7 Palkkatietoilmoitukset useita aineistoja, kertatilaus

Aineistotilaus Esimerkki 5 Palkkatietoilmoitukset useita maksajia 2, kertatilaus

Tekninen rajapinta Zip-tiedosto sovelluskehittäjälle Kansallisen tulorekisterin perustamishanke

Työnantajan erillisilmoituksen soveltamisohje

Aineistotilaus Esimerkki 2 Palkkatietoilmoitukset useita tulonsaajia 1, jatkuva tilaus

Työnantajan erillisilmoituksen soveltamisohje

Työnantajan erillisilmoituksen soveltamisohje

Tekninen rajapinta Tietojen jakelu tulorekisteristä Kansallisen tulorekisterin perustamishanke

Tekninen rajapinta Tietojen jakelu tulorekisteristä Kansallisen tulorekisterin perustamishanke

Tekninen rajapinta Tietojen jakelu tulorekisteristä Kansallisen tulorekisterin perustamishanke

Varmennepalvelu Rajapintakuvaus Tulorekisteriyksikkö

Virhekoodi Selite ADV0010 Postinumero puuttuu ja se on pakollinen. ADV0020 Postitoimipaikka puuttuu ja se on pakollinen. ADV0050 Katuosoite ja PL

Tekninen rajapinta Tietojen toimittaminen tulorekisteriin Kansallisen tulorekisterin perustamishanke

Tekninen rajapinta Tietojen toimittaminen tulorekisteriin Kansallisen tulorekisterin perustamishanke

Tulorekisterin sidosryhmätestaukseen julkaistaan kehitysversio

OHJE TESTIAINEISTON ANONYMISOINNISTA

Ohjelmistokehitys Skype-klinikka

T2V2 Vaaratilanneilmoitussanomakuvaus

Tekninen rajapinta - Soveltamisohje Kansallisen tulorekisterin perustamishanke

Ohjelmistokehitys Skype-klinikka

T2V2 Turvallisuushavaintoilmoitussanomakuvaus

Tulotiedot - Laskentasääntöjä Kansallisen tulorekisterin perustamishanke

TOIMITUSSELOSTE PL 5 Tulorekisteri TULOREKISTERI

Palkkatietoilmoituksen tietosisällön soveltamisohje

Palkkatietoilmoituksen tietosisällön soveltamisohje

Julkishallinnon XML-skeemat v0.5 JHS-suositus

Muutokset suoran sanoma-asioinnin web servicepalvelun

Tulorekisteri - Verohallinnon ja ohjelmistotalojen yhteistyöpäivä

Palkkatietoilmoituksen tietosisällön soveltamisohje

Palkkatietoilmoituksen tietosisällön soveltamisohje

Veronumero.fi Tarkastaja rajapinta

Koodistot Kansallisen tulorekisterin perustamishanke

1.1 Palkkalajien ja tulorekisterin tulolajien kohdistus

Tärkeitä päiviä. vastaukset lähtee aikaisintaan

Tekninen rajapinta - Soveltamisohje Kansallisen tulorekisterin perustamishanke

Sosiaalihuollon asiakastiedon arkiston validointipalvelu. Käyttöohje

Tekninen rajapinta - Soveltamisohje Kansallisen tulorekisterin perustamishanke

Koodistot Kansallisen tulorekisterin perustamishanke

LAAJA PALKKATIETOILMOITUS

ASTERI PALKANMAKSU TULOREKISTERI

Etuustietoilmoituksen tietosisällön soveltamisohje

TULOREKISTERIN SIDOSRYHMÄTESTAUKSEN TOIMITUSSELOSTE Tulorekisterin sidosryhmätestaukseen julkaistaan uusi versio

Sosiaalihuollon asiakastiedon arkiston validointipalvelu

Maksuturva-palvelun käyttöönottolomakkeen rajapintakuvaus verkkokauppaohjelmistolle

Työnantajan erillisilmoitus (TULOR 6103) - Täyttöohje. Tulorekisteri

VUOSI-ILMOITUS KORKOTULON LÄHDEVERON ALAISET KOROT (VSKTVYSL)

T2V2 Vakuutusyhtiön tapaturmailmoitussanomakuvaus

VUOSI-ILMOITUS OSUUSKUNNAN YLIJÄÄMISTÄ YHTEENVETOTIEDOT (VSOKVYHT)

Transkriptio:

ersio 1.05 Tietojen jakelu Skeemat Työnantajan erillisilmoitukset Kansallisen tulorekisterin perustamishanke

Tietojen jakelu Skeemat Työnantajan erillisilmoitukset 2 (29) ersiohistoria ersio Päivämäärä Kuvaus 1.0 12.6.2017 Dokumentti julkaistu. 1.01 31.8.2017 Yleistä-osion kappale Aikaleimat on nimetty uudelleen => Päivämäärät ja kellonajat. Kappaleessa on tarkennettu päivämäärien ja kellonaikojen käsittelyä. 1.02 14.11.2017 Lisätty Aineiston tiedot -tietoryhmään elementti Aineiston toimituskanava. Lisätty Palvelun tiedot -tietoryhmään elementti Ilmoitusversion tallennushetki (ReceivedTimestamp). Lisätty sähköinen allekirjoitus: aineiston päätasolle tietoryhmä Allekirjoitus (Signature). Tietotyyppi xs:boolean muutettu tietotyypiksi irct:trueorfalse (IRCommonTypes.xsd). Tarkennettu Yleistä/Merkistö-osioon isojen ja pienten kirjainten tulkintasääntöjä. Lisätty tietoryhmä Maksajan muut tiedot (PayerOther) ja siihen tieto Maksajan tietoihin voi sisältyä turvakiellon alaisia tietoja (SensitiveInfoIncluded). Lisätty Yleistä/Skeema-osioon XML-allekirjoituksen skeeman nimiavaruus. Muutettu tietoryhmässä Työtapaturmavakuutus (AccidentInsurance) toimitettavan työtapaturmavakuutusyhtiön tunnisteen tietorakennetta siten, että tunnisteeksi voi antaa myös muun kuin suomalaisen Y-tunnuksen. 1.03 29.1.2018 Lisätty tietoryhmään Palvelun tiedot (ReportData) uusi tieto CreatedTimestamp. Päivitetty selitteet: Ilmoituksen ensimmäisen version vastaanottohetki (ReceivedTimestamp) Ilmoitusversion tallennushetki (CreatedTimestamp) 1.04 11.6.2018 Tarkennettu Merkistö-osioon viitetietojen sallittu merkistö. 1.05 26.9.2018 Tarkennettu kappaleeseen Päivämäärät ja kellonajat, että Suomen aikavyöhykkeessä annettu esimerkki koskee talviaikaa: Esimerkki Suomen aikavyöhykkeessä (talviaika, UTC+2)

Tietojen jakelu Skeemat Työnantajan erillisilmoitukset 3 (29) SISÄLLYS 1 Yleistä... 4 1.1 Skeema... 4 1.2 Merkistö... 4 1.3 Päivämäärät ja kellonajat... 5 1.4 Dokumentin lukuohje... 5 2 Työnantajan erillisilmoitukset (PayerSummaryReportsFromIR)... 7 2.1 Aineistotilauksen tiedot (Subscription)... 9 2.2 Poiminnan tiedot (Query)... 11 2.3 Poiminnan yhteenvetotiedot (Summary)... 12 2.4 Sanomatason virheet (MessageErrors)... 13 2.5 Aineistotason virheet (DeliveryErrors)... 14 2.6 Ilmoitusten tiedot (Reports)... 15 2.7 Aineiston tiedot (DeliveryData)... 16 2.8 Aineiston yhteyshenkilöt (ContactPersons)... 17 2.9 Maksajan tiedot (Payer)... 18 2.10 Maksajan tunnisteet (PayerIds)... 19 2.11 Maksajan perustiedot (PayerBasic)... 20 2.12 Maksajan osoite (Address)... 21 2.13 Maksajan aliorganisaatiot (SubOrgs)... 22 2.14 Työeläkevakuutukset (PensionInsurances)... 23 2.15 Työtapaturmavakuutukset (AccidentInsurances)... 24 2.16 Maksajan muut tiedot (PayerOther)... 26 2.17 Palvelun tiedot (ReportData)... 27 2.18 Kohdekausi (PaymentMonth)... 28 2.19 Tulolajit (Transactions)... 29

Tietojen jakelu Skeemat Työnantajan erillisilmoitukset 4 (29) 1 YLEISTÄ 1.1 Skeema Työnantajan erillisilmoitukset toimitetaan tulorekisteristä skeemalla PayerSummaryReportsFromIR. Skeeman nimiavaruudet ovat seuraavat: Tiedoston nimi Prefix Namespace xmlns:xs http://www.w3.org/2001/xmlschema PayerSummaryReportsFromIR.xsd xmlns:psrfir http://www.tulorekisteri.fi/2017/1/payersummaryreportsfromir PayerSummaryReportsFromIRTypes.xsd xmlns:psrfirt http://www.tulorekisteri.fi/2017/1/payersummaryreportsfromirtypes IRCommonTypes.xsd xmlns:irct http://www.tulorekisteri.fi/2017/1/ircommontypes StatusMessageTypes.xsd xmlns:smt http://www.tulorekisteri.fi/2017/1/statusmessagetypes xmldsig-core-schema.xsd xmlns:ds http://www.w3.org/2000/09/xmldsig# Sanomissa ei sallita tyhjiä elementtejä. Jos elementtiin ei tule arvoa, se jää sanomalta kokonaan pois. Myöskään tyhjiä merkkijonoja ei sallita, eli kaikkien arvojen pituus on vähintään 1. 1.2 Merkistö Tulorekisterin skeemoissa on käytössä XML:n oletusmerkistö UTF-8. Tiedostossa ei saa olla Byte Order Mark (BOM) merkkiä. Seuraavassa taulukossa on esitetty sanomissa esiintyvien erikoismerkkien muunnoksiin liittyvät vaatimukset. Merkki Kuvaus Esitysmuoto entiteettinä & et-merkki & muunnos on pakollinen < pienempi kuin < muunnos on pakollinen > suurempi kuin > muunnos ei ole pakollinen, mutta on hyvien käytäntöjen mukaista ' heittomerkki &apos; muunnos ei ole pakollinen, mutta on hyvien käytäntöjen mukaista " lainausmerkki " muunnos ei ole pakollinen, mutta on hyvien käytäntöjen mukaista -- tupla viiva Merkki ei saa esiintyä xml-tiedostossa /* kauttaviiva asterisk Merkki ei saa esiintyä xml-tiedostossa &# et-merkki risuaitamerkki Merkki ei saa esiintyä xml-tiedostossa iitetiedoissa on käytössä rajoitettu merkistö. Alla luetelluissa viitetiedoissa sallitut merkit ovat numerot 0-9, kirjaimet a-z ja A-Z sekä erikoismerkit _ ja -.

Tietojen jakelu Skeemat Työnantajan erillisilmoitukset 5 (29) Aineiston omistajan aineistoviite (DeliveryId) Maksajan ilmoitusviite (ReportId) Tilaajan päätilausviite (MainSubscriptionId) Tilaajan alitilausviite (SubscriptionId) Lähettäjän viestiviite (MessageId) Seuraavissa tiedoissa isot ja pienet kirjaimet ovat merkitseviä: Maakoodit kaikissa tietoryhmissä (esimerkiksi DE tulkitaan eri koodiksi kuin De ). Asiakastunnisteet kaikissa tietoryhmissä (esimerkiksi 150172-999H tulkitaan eri tunnisteeksi kuin 150172-999h ). 1.3 Päivämäärät ja kellonajat Päivämäärissä (tietotyyppi xs:date) ei saa olla mukana aikavyöhyketietoa. Esimerkki päivämäärästä: <StartDate>2017-05-11</StartDate> Kellonaikoja sisältävissä tietoelementeissä (tietotyypit xs:datetime ja xs:time) tulee olla mukana aikavyöhyke. Esimerkki Suomen aikavyöhykkeessä (talviaika, UTC+2): <Timestamp>2017-05-11T08:00:00+02:00</Timestamp> <Time>08:00:00+02:00</Time> Esimerkki UTC-ajassa (UTC+0): <Timestamp>2017-05-11T6:00:00Z</Timestamp> <Time>06:00:00Z</Time> 1.4 Dokumentin lukuohje Dokumentin kaavioissa olevien elementtien oikeassa alakulmassa oleva merkintä 0.. tarkoittaa, että elementti voi toistua useita kertoja ja se voi myös puuttua kokonaan. Merkintä 1.. tarkoittaa, että elementti voi toistua useita kertoja, mutta aina vähintään kerran. Pakolliset elementit on merkitty yhtenäisellä reunaviivalla ja vapaaehtoiset elementit katkonaisella reunaviivalla. Dokumentin taulukoissa elementtien pakollisuutta tai vapaaehtoisuutta on kuvattu seuraavilla merkinnöillä: /P Selite Elementti on aina vapaaehtoinen. apaaehtoiseksi merkityt tietoryhmät tai tiedot ovat mukana poimitussa aineistossa, jos ne sisältävät tietoa (tieto on annettu ilmoituksella tai se on tulorekisterin tuottama tieto) ja ne sisältyvät siihen tiedonluovutusprofiiliin, jolla aineisto poimitaan.

Tietojen jakelu Skeemat Työnantajan erillisilmoitukset 6 (29) P Elementti on aina mukana siinä tapauksessa, että sen emoelementti on mukana. Joissakin elementeissä sanomilla käytetään rajoitetun arvoavaruuden arvoja eli koodeja. Koodien arvoavaruus eli mahdolliset arvot on kuvattu dokumenteissa Koodistot ja Koodistot Tulolajit. Tässä dokumentissa viitataan koodistoissa esiteltyihin arvoihin nimellä koodisto.

Tietojen jakelu Skeemat Työnantajan erillisilmoitukset 7 (29) 2 TYÖNANTAJAN ERILLISILMOITUKSET (PAYERSUMMARYREPORTSFROMIR) Tulorekisteristä jaettavan työnantajan erillisilmoituksia sisältävän aineiston yleisrakenne on seuraava: Tietoryhmän nimi Tyyppi /P Aineistotilauksen tiedot (Subscription) psrfirt:subscription P Poiminnan tiedot (Query) psrfirt:query Poiminnan yhteenvetotiedot (Summary) psrfirt:summary P Sanomatason virheet (MessageErrors) smt:messageerrors Aineistotason virheet (DeliveryErrors) smt:deliveryerrors Ilmoitusten tiedot (Reports) psrfirt:reports Ilmoituksen tiedot (Report) psrfirt:report P Aineiston tiedot (DeliveryData) psrfirt:deliverydata P Aineiston yhteyshenkilöt (ContactPersons) psrfirt:contactpersons Maksajan tiedot (Payer) psrfirt:payer Maksajan tunnisteet (PayerIds) psrfirt:payerids Maksajan perustiedot (PayerBasic) psrfirt:payerbasic Maksajan osoite (Address) psrfirt:address Maksajan aliorganisaatiot (SubOrgs) psrfirt:suborgs Työeläkevakuutukset (PensionInsurances) psrfirt:pensioninsurances Työtapaturmavakuutukset (AccidentInsurances) psrfirt:accidentinsurances Maksajan muut tiedot (PayerOther) psrfirt:payerother Palvelun tiedot (ReportData) psrfirt:reportdata P Kohdekausi (PaymentMonth) psrfirt:paymentmonth P Tulolajit (Transactions) psrfirt:transactions Tulolajin tiedot (Transaction) psrfirt:transaction P Tulolajin yleistiedot (TransactionBasic) psrfirt:transactionbasic P Allekirjoitus (Signature) xsig:signaturetype P

Tietojen jakelu Skeemat Työnantajan erillisilmoitukset 8 (29) Tiedon nimi Tyyppi Sallitut arvot /P Käsittelysääntö Aineistotilauksen tiedot (Subscription) psrfirt:subscription P Tietoryhmässä toimitetaan aineistotilaukseen tai palvelupyyntöön liittyviä tietoja. Poiminnan tiedot (Query) psrfirt:query Tietoryhmässä toimitetaan poimintaan liittyviä tietoja. Tietoryhmä ei esiinny DataRequestToIR-skeeman mukaisen reaaliaikaisen WSpalvelukutsun vastaussanomalla, jos palvelukutsun käsittelyssä on tapahtunut sanomatason tai aineistotason virhe. Poiminnan yhteenvetotiedot (Summary) psrfirt:summary P Tietoryhmässä toimitetaan poimintaan liittyvää summatietoa. Sanomatason virheet (MessageErrors) smt:messageerrors Tietoryhmä voi esiintyä vain DataRequestToIR-skeeman mukaisen reaaliaikaisen WS-palvelukutsun vastaussanomalla. Aineistotason virheet (DeliveryErrors) smt:deliveryerrors Tietoryhmä voi esiintyä vain DataRequestToIR-skeeman mukaisen reaaliaikaisen WS-palvelukutsun vastaussanomalla. Ilmoitusten tiedot (Reports) psrfirt:reports Työnantajan erillisilmoitukset Allekirjoitus (Signature) xsig:signaturetype P Tietoryhmässä toimitetaan aineiston sähköinen allekirjoitus.

Tietojen jakelu Skeemat Työnantajan erillisilmoitukset 9 (29) 2.1 Aineistotilauksen tiedot (Subscription) Tiedon nimi Tyyppi Sallitut arvot /P Käsittelysääntö Aineistotilauksen tiedot (Subscription) psrfirt:subscription P Tietoryhmässä toimitetaan aineistotilaukseen tai palvelupyyntöön liittyviä tietoja. Aineiston tyyppi (QueryDataType) xs:int koodisto: QueryDataType P Aineistotilauksella tai palvelupyynnössä annettu tieto. Tiedonsaantiprofiili (QueryProfile) irct:string40 Aineistotilauksella tai palvelupyynnössä annettu tieto. Tuotantoympäristö (ProductionEnvironment) irct:trueorfalse koodisto: ProductionEnvironment Tulorekisterin päätilausviite (IRMainSubscriptionId) P Aineistotilauksella tai palvelupyynnössä annettu tieto. irct:guid Tulorekisterin päätilausviite sille päätilaukselle, jonka perusteella aineisto on poimittu. Tietoa ei toimiteta DataRequestToIR-skeeman mukaisen reaaliaikaisen WSpalvelukutsun vastaussanomalla. Tulorekisterin alitilausviite (IRSubscriptionId) irct:guid Tulorekisterin alitilausviite sille alitilaukselle, jonka perusteella aineisto on poimittu. Tietoa ei toimiteta DataRequestToIR-skeeman mukaisen reaaliaikaisen WSpalvelukutsun vastaussanomalla. Tilaajan päätilausviite (MainSubscriptionId) irct:string40 Tilaajan päätilausviite sille päätilaukselle, jonka perusteella aineisto on poimittu. Tietoa ei toimiteta DataRequestToIR-skeeman mukaisen reaaliaikaisen WS-

Tietojen jakelu Skeemat Työnantajan erillisilmoitukset 10 (29) palvelukutsun vastaussanomalla. Tilaajan alitilausviite (SubscriptionId) irct:string40 Tilaajan alitilausviite sille alitilaukselle, jonka perusteella aineisto on poimittu. Tietoa ei toimiteta DataRequestToIR-skeeman mukaisen reaaliaikaisen WSpalvelukutsun vastaussanomalla.

Tietojen jakelu Skeemat Työnantajan erillisilmoitukset 11 (29) 2.2 Poiminnan tiedot (Query) Tiedon nimi Tyyppi Sallitut arvot /P Käsittelysääntö Poiminnan tiedot (Query) psrfirt:query Tietoryhmässä toimitetaan poimintaan liittyviä tietoja. Tulorekisterin poimintaviite (IRQueryId) irct:guid P Tulorekisterin antama viite poimitulle aineistolle. iite yksilöi kaikki tulorekisteristä poimitut aineistot. Poimintahetki (QueryTimestamp) xs:datetime P Päivä ja kellonaika, jolloin aineisto on poimittu. Muutosten poimintavälin alkuhetki (QueryTimespanStart) Muutosten poimintavälin loppuhetki (QueryTimespanEnd) xs:datetime P Päivä ja kellonaika, josta lähtien muuttuneet tiedot aineistoon on poimittu. xs:datetime P Päivä ja kellonaika, johon asti muuttuneet tiedot aineistoon on poimittu.

Tietojen jakelu Skeemat Työnantajan erillisilmoitukset 12 (29) 2.3 Poiminnan yhteenvetotiedot (Summary) Tiedon nimi Tyyppi Sallitut arvot /P Käsittelysääntö Poiminnan yhteenvetotiedot (Summary) psrfirt:summary P Tietoryhmässä toimitetaan poimintaan liittyvää summatietoa. Poimittujen kohteiden lukumäärä (NrOfReports) xs:int P Poimittujen työnantajan erillisilmoitusten lukumäärä.

Tietojen jakelu Skeemat Työnantajan erillisilmoitukset 13 (29) 2.4 Sanomatason virheet (MessageErrors) Tiedon nimi Tyyppi Sallitut arvot /P Käsittelysääntö Sanomatason virheet (MessageErrors) smt:messageerrors Tietoryhmässä palautetaan tekniset ja auktorisointivirheet. irheen tiedot (ErrorInfo) smt:errorinfo P irheitä voi olla useita. irhekoodi (ErrorCode) irct:string20 P Elementissä palautetaan virheen koodi. Tietoryhmä voi esiintyä vain DataRequestToIR-skeeman mukaisen reaaliaikaisen WS-palvelukutsun vastaussanomalla. irhekoodin selite (ErrorMessage) irct:string500 P Elementissä palautetaan virhekoodin selite. irheen tarkenne (ErrorDetails) irct:string500 Elementissä palautetaan virheen kohdistus- ja yksilöintitiedot.

Tietojen jakelu Skeemat Työnantajan erillisilmoitukset 14 (29) 2.5 Aineistotason virheet (DeliveryErrors) Tiedon nimi Tyyppi Sallitut arvot /P Käsittelysääntö Aineistotason virheet (DeliveryErrors) smt:deliveryerrors Tietoryhmässä palautetaan aineistotason tietojen sisältöön liittyvät virheet. irheen tiedot (ErrorInfo) smt:errorinfo P irheitä voi olla useita. irhekoodi (ErrorCode) irct:string20 P Elementissä palautetaan virheen koodi. Tietoryhmä voi esiintyä vain DataRequestToIR-skeeman mukaisen reaaliaikaisen WS-palvelukutsun vastaussanomalla. irhekoodin selite (ErrorMessage) irct:string500 P Elementissä palautetaan virhekoodin selite. irheen tarkenne (ErrorDetails) irct:string500 Elementissä palautetaan virheen kohdistus- ja yksilöintitiedot.

Tietojen jakelu Skeemat Työnantajan erillisilmoitukset 15 (29) 2.6 Ilmoitusten tiedot (Reports) Tiedon nimi Tyyppi Sallitut arvot /P Käsittelysääntö Ilmoitusten tiedot (Reports) psrfirt:reports Tietoryhmään kuuluvat vapaaehtoiseksi merkityt tietoryhmät tai tiedot palautetaan, jos ne on annettu ilmoituksella ja ne sisältyvät siihen tiedonluovutusprofiilin, jolla aineisto poimitaan. Ilmoituksen tiedot (Report) psrfirt:report P Ilmoituksia voi olla useita. Aineiston tiedot (DeliveryData) psrfirt:deliverydata P Palvelun tiedot (ReportData) psrfirt:reportdata P Kohdekausi (PaymentMonth) psrfirt:paymentmonth P Tulolajit (Transactions) psrfirt:transactions

Tietojen jakelu Skeemat Työnantajan erillisilmoitukset 16 (29) 2.7 Aineiston tiedot (DeliveryData) Tiedon nimi Tyyppi Sallitut arvot /P Käsittelysääntö Aineiston tiedot (DeliveryData) psrfirt:deliverydata P Tietoryhmään kuuluvat vapaaehtoiseksi merkityt tietoryhmät tai tiedot palautetaan, jos ne on annettu ilmoituksella ja ne sisältyvät siihen tiedonluovutusprofiilin, jolla aineisto poimitaan. Aineiston muodostamishetki (Timestamp) xs:datetime P Tietolähde (Source) irct:string30 Aineiston omistajan (maksajan) aineistoviite (DeliveryId) irct:string40 Tulorekisterin aineistoviite (IRDeliveryId) irct:guid P Aineiston toimituskanava (DeliveryToIRChannelCode) xs:int koodisto: DeliveryToIRChannelCode Aineiston yhteyshenkilöt (ContactPersons) psrfirt:contactpersons Ilmoituspäivä (ReportDate) xs:date Maksajan tiedot (Payer) psrfirt:payer

Tietojen jakelu Skeemat Työnantajan erillisilmoitukset 17 (29) 2.8 Aineiston yhteyshenkilöt (ContactPersons) Tiedon nimi Tyyppi Sallitut arvot /P Käsittelysääntö Aineiston yhteyshenkilöt (ContactPersons) psrfirt:contactpersons Tietoryhmään kuuluvat vapaaehtoiseksi merkityt tietoryhmät tai tiedot palautetaan, jos ne on annettu ilmoituksella ja ne sisältyvät siihen tiedonluovutusprofiilin, jolla aineisto poimitaan. Aineiston yhteyshenkilö (ContactPerson) psrfirt:contactperson P Yhteyshenkilöitä voi olla useita. Nimi (Name) irct:string200 Puhelinnumero (Telephone) irct:string40 Sähköpostiosoite (Email) irct:string70 astuualue (ResponsibilityCode) xs:int koodisto: ResponsibilityCode

Tietojen jakelu Skeemat Työnantajan erillisilmoitukset 18 (29) 2.9 Maksajan tiedot (Payer) Tiedon nimi Tyyppi Sallitut arvot /P Käsittelysääntö Maksajan tiedot (Payer) psrfirt:payer Tietoryhmään kuuluvat vapaaehtoiseksi merkityt tietoryhmät tai tiedot palautetaan, jos ne on annettu ilmoituksella ja ne sisältyvät siihen tiedonluovutusprofiilin, jolla aineisto poimitaan. Maksajan tunnisteet (PayerIds) psrfirt:payerids Maksajan perustiedot (PayerBasic) psrfirt:payerbasic Maksajan osoite (Address) psrfirt:address Maksajan aliorganisaatiot (SubOrgs) psrfirt:suborgs Työeläkevakuutukset (PensionInsurances) Työtapaturmavakuutukset (AccidentInsurances) psrfirt:pensioninsuranc es psrfirt:accidentinsuranc es Maksajan muut tiedot (PayerOther) psrfirt:payerother

Tietojen jakelu Skeemat Työnantajan erillisilmoitukset 19 (29) 2.10 Maksajan tunnisteet (PayerIds) Tiedon nimi Tyyppi Sallitut arvot /P Käsittelysääntö Maksajan tunnisteet (PayerIds) psrfirt:payerids Tietoryhmään kuuluvat vapaaehtoiseksi merkityt tietoryhmät tai tiedot palautetaan, jos ne on annettu ilmoituksella ja ne sisältyvät siihen tiedonluovutusprofiilin, jolla aineisto poimitaan. Maksajan tunniste (Id) psrfirt:id P Maksajalla voi olla useita tunnisteita. Tunnisteen tyyppi (Type) xs:int koodisto: IdType Tunniste (Code) irct:string30 Maakoodi (CountryCode) irct:string2 ISO3166-maakoodiston mukainen 2-kirjaiminen koodi. Jos maa on tuntematon, arvo on 99. Maan nimi (CountryName) irct:string70

Tietojen jakelu Skeemat Työnantajan erillisilmoitukset 20 (29) 2.11 Maksajan perustiedot (PayerBasic) Tiedon nimi Tyyppi Sallitut arvot /P Käsittelysääntö Maksajan perustiedot (PayerBasic) psrfirt:payerbasic Tietoryhmään kuuluvat vapaaehtoiseksi merkityt tietoryhmät tai tiedot palautetaan, jos ne on annettu ilmoituksella ja ne sisältyvät siihen tiedonluovutusprofiilin, jolla aineisto poimitaan. Maksajalla ei ole asiakastunnistetta (MissingId) irct:true true Yrityksen nimi (CompanyName) irct:string200 Sukunimi (LastName) irct:string200 Etunimi (FirstName) irct:string100 Syntymäaika (BirthDate) xs:date Asiointikieli (Language) xs:int koodisto: Language

Tietojen jakelu Skeemat Työnantajan erillisilmoitukset 21 (29) 2.12 Maksajan osoite (Address) Tiedon nimi Tyyppi Sallitut arvot /P Käsittelysääntö Maksajan osoite (Address) psrfirt:address Tietoryhmään kuuluvat vapaaehtoiseksi merkityt tietoryhmät tai tiedot palautetaan, jos ne on annettu ilmoituksella ja ne sisältyvät siihen tiedonluovutusprofiilin, jolla aineisto poimitaan. c/o-tarkenne (Co) irct:string70 Katuosoite (Street) irct:string100 PL (POBox) irct:string10 Postinumero (PostalCode) irct:string20 Postitoimipaikka (PostOffice) irct:string200 Maakoodi (CountryCode) irct:string2 ISO3166-maakoodiston mukainen 2-kirjaiminen koodi. Jos maa on tuntematon, arvo on 99. Maan nimi (CountryName) irct:string70

Tietojen jakelu Skeemat Työnantajan erillisilmoitukset 22 (29) 2.13 Maksajan aliorganisaatiot (SubOrgs) Tiedon nimi Tyyppi Sallitut arvot /P Käsittelysääntö Maksajan aliorganisaatiot (SubOrgs) psrfirt:suborgs Tietoryhmään kuuluvat vapaaehtoiseksi merkityt tietoryhmät tai tiedot palautetaan, jos ne on annettu ilmoituksella ja ne sisältyvät siihen tiedonluovutusprofiilin, jolla aineisto poimitaan. Maksajan aliorganisaatio (SubOrg) psrfirt:suborg P Maksajalla voi olla useita aliorganisaatioita. Aliorganisaation tunnisteen tyyppi (Type) xs:int koodisto: SubOrgType Aliorganisaation tunniste (Code) irct:string20

Tietojen jakelu Skeemat Työnantajan erillisilmoitukset 23 (29) 2.14 Työeläkevakuutukset (PensionInsurances) Tiedon nimi Tyyppi Sallitut arvot /P Käsittelysääntö Työeläkevakuutukset (PensionInsurances) Työeläkevakuutus (PensionInsurance) Työeläkelaitoksen yhtiötunnus (PensionProvIdCode) psrfirt:pensioninsuranc es psrfirt:pensioninsuranc e xs:int koodisto: PensionProvIdCode Eläkejärjestelynumero (PensionPolicyNo) irct:pensionpolicyno Työeläkelaitosten eläkejärjestelynumerokoo disto P Tietoryhmään kuuluvat vapaaehtoiseksi merkityt tietoryhmät tai tiedot palautetaan, jos ne on annettu ilmoituksella ja ne sisältyvät siihen tiedonluovutusprofiilin, jolla aineisto poimitaan. Maksajalla voi olla useita työeläkevakuutuksia.

Tietojen jakelu Skeemat Työnantajan erillisilmoitukset 24 (29) 2.15 Työtapaturmavakuutukset (AccidentInsurances) Tiedon nimi Tyyppi Sallitut arvot /P Käsittelysääntö Työtapaturmavakuutukset (AccidentInsurances) Työtapaturmavakuutus (AccidentInsurance) Työtapaturmavakuutusyhtiön tunniste (AccInsProvId) psrfirt:accidentinsuranc es psrfirt:accidentinsuranc e psrfirt:id Tunnisteen tyyppi (Type) xs:int koodisto: IdType Tunniste (Code) irct:string30 Maakoodi (CountryCode) irct:string2 ISO3166-maakoodiston mukainen 2-kirjaiminen koodi. Jos maa on tuntematon, annetaan arvo 99. Maan nimi (CountryName) irct:string70 Työtapaturmavakuutuksen irct:string20 P Tietoryhmään kuuluvat vapaaehtoiseksi merkityt tietoryhmät tai tiedot palautetaan, jos ne on annettu ilmoituksella ja ne sisältyvät siihen tiedonluovutusprofiilin, jolla aineisto poimitaan. Maksajalla voi olla useita työtapaturmavakuutuksia.

vakuutusnumero (AccInsPolicyNo) Tietojen jakelu Skeemat Työnantajan erillisilmoitukset 25 (29)

Tietojen jakelu Skeemat Työnantajan erillisilmoitukset 26 (29) 2.16 Maksajan muut tiedot (PayerOther) Tiedon nimi Tyyppi Sallitut arvot /P Käsittelysääntö Maksajan muut tiedot (PayerOther) psrfirt:payerother Tietoryhmään kuuluvat vapaaehtoiseksi merkityt tietoryhmät tai tiedot palautetaan, jos ne on annettu ilmoituksella ja ne sisältyvät siihen tiedonluovutusprofiilin, jolla aineisto poimitaan. Maksajan tietoihin voi sisältyä turvakiellon alaisia tietoja (SensitiveInfoIncluded) irct:true true Elementin arvo on true, jos maksaja on turvakiellossa ja tietoryhmässä Maksajan osoite (Address) jaetaan ilmoituksen tietoja.

Tietojen jakelu Skeemat Työnantajan erillisilmoitukset 27 (29) 2.17 Palvelun tiedot (ReportData) Tiedon nimi Tyyppi Sallitut arvot /P Käsittelysääntö Palvelun tiedot (ReportData) psrfirt:reportdata P Tietoryhmään kuuluvat vapaaehtoiseksi merkityt tietoryhmät tai tiedot palautetaan, jos ne on annettu ilmoituksella ja ne sisältyvät siihen tiedonluovutusprofiilin, jolla aineisto poimitaan. Tulorekisterin ilmoitusviite (IRReportId) irct:guid P Maksajan ilmoitusviite (ReportId) irct:string40 Ilmoituksen tila (ReportStatus) xs:int koodisto: ReportStatus P Ilmoituksen versionumero (Reportersion) xs:int P Ilmoituksen ensimmäisen version vastaanottohetki (ReceivedTimestamp) Ilmoitusversion tallennushetki (CreatedTimestamp) xs:datetime P Päivä ja kellonaika, jolloin ilmoituksen ensimmäinen versio on vastaanotettu tulorekisteriin. xs:datetime Päivä ja kellonaika, jolloin ilmoitusversio on tallennettu tulorekisteriin.

Tietojen jakelu Skeemat Työnantajan erillisilmoitukset 28 (29) 2.18 Kohdekausi (PaymentMonth) Tiedon nimi Tyyppi Sallitut arvot /P Käsittelysääntö Kohdekausi (PaymentMonth) psrfirt:paymentmonth P Maksukuukausi (Month) irct:monthstype P Maksuvuosi (Year) xs:int P

Tietojen jakelu Skeemat Työnantajan erillisilmoitukset 29 (29) 2.19 Tulolajit (Transactions) Tiedon nimi Tyyppi Sallitut arvot /P Käsittelysääntö Tulolajit (Transactions) psrfirt:transactions Tietoryhmään kuuluvat vapaaehtoiseksi merkityt tietoryhmät tai tiedot palautetaan, jos ne on annettu ilmoituksella ja ne sisältyvät siihen tiedonluovutusprofiilin, jolla aineisto poimitaan. Tulolajin tiedot (Transaction) psrfirt:transaction P Tulolajeja voi olla useita. Tulolajin yleistiedot (TransactionBasic) psrfirt:transactionbasic P Tulolajin koodi (SummaryTransactionCode) xs:int koodisto: SummaryTransactionCod e Määrä (Amount) irct:decimal2