ersio 1.02 Tietojen jakelu Skeemat Etuustietoilmoitukset Kansallisen tulorekisterin perustamishanke
Tietojen jakelu - Skeemat - Etuustietoilmoitukset 2 (51) ersiohistoria ersio Päivämäärä Kuvaus 1.00 26.9.2018 Uusi dokumentti. 1.01 21.1.2019 Lisätty tietoryhmään Tulolajin yleistiedot (TransactionBasic) seuraavat tiedot: Oma-aloitteinen palautus (UnpromptedRefund) Maksun oikaisu (PaymentReallocation) Ei vaikuta verotukseen (NoTaxEffect) Muutettu tietoryhmän ja tietojen nimiä seuraavasti: Takaisinperinnän lisätiedot (RecoveryData) => Takaisinmaksun lisätiedot (RecoveryData) Takaisinperintäpäivä (RecoveryDate) => Takaisinmaksupäivä (RecoveryDate) Takaisinperittyyn määrään kohdistuva ennakonpidätys (Withhold) => Takaisinmaksuun kohdistuva ennakonpidätys (Withhold) Takaisinperittyyn määrään kohdistuva lähdevero (TaxAtSource) => Takaisinmaksuun kohdistuva lähdevero (TaxAtSource) Muutettu tietojen nimiä seuraavasti: Maksajan tunnisteet (PayerIds) -tietoryhmä: Tunnisteen tyyppi (Type) => Etuuden maksajan tunnisteen tyyppi (Type) Maksajan aliorganisaatiot (SubOrgs) -tietoryhmä: Aliorganisaation tunnisteen tyyppi (Type) => Etuuden maksajan aliorganisaation tunnisteen tyyppi Tulonsaajan tunnisteet (IncomeEarnerIds) -tietoryhmä: Tunnisteen tyyppi (Type) => Etuuden saajan tunnisteen tyyppi (Type) Tulolajin yleistiedot (TransactionBasic) -tietoryhmä: eronalaisuus (TaxTreatment) => Etuuden veronalaisuus (TaxTreatment) Korjattu tekstiä kappaleessa Skeema: Aikaisempi teksti: 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. Korjattu muotoon: Tiedot jaetaan tulorekisteristä sisällöltään samanlaisina, kuin ne on toimitettu tulorekisteriin. Jakelussa huomioidaan tiedon käyttäjän tiedonsaantiprofiili. 1.02 8.3.2019 Lisätty tietoryhmä Regressin lisätiedot (RecourseData).
Tietojen jakelu - Skeemat - Etuustietoilmoitukset 3 (51) SISÄLLYS 1 Yleistä... 5 1.1 Skeema... 5 1.2 Merkistö... 5 1.3 Päivämäärät ja kellonajat... 6 1.4 Dokumentin lukuohje... 6 2 Etuustietoilmoitukset (BenefitReportsFromIR)... 8 2.1 Aineistotilauksen tiedot (Subscription)... 10 2.2 Poiminnan tiedot (Query)... 12 2.3 Poiminnan yhteenvetotiedot (Summary)... 13 2.4 Sanomatason virheet (MessageErrors)... 14 2.5 Aineistotason virheet (DeliveryErrors)... 15 2.6 Ilmoitusten tiedot (Reports)... 16 2.7 Aineiston tiedot (DeliveryData)... 17 2.8 Aineiston yhteyshenkilöt (ContactPersons)... 18 2.9 Maksajan tiedot (Payer)... 19 2.10 Maksajan tunnisteet (PayerIds)... 20 2.11 Maksajan perustiedot (PayerBasic)... 21 2.12 Maksajan osoite (Address)... 22 2.13 Maksajan aliorganisaatiot (SubOrgs)... 23 2.14 Maksajan muut tiedot (PayerOther)... 24 2.15 Palvelun tiedot (ReportData)... 25 2.16 Tulonsaajan tiedot (IncomeEarner)... 27 2.17 Tulonsaajan tunnisteet (IncomeEarnerIds)... 28 2.18 Tulonsaajan perustiedot (IncomeEarnerBasic)... 29 2.19 Tulonsaajan osoite (Address)... 30 2.20 Kansainväliset tilanteet (InternationalData)... 31 2.21 Tulolajit (Transactions)... 32 2.22 Tulolajin yleistiedot (TransactionBasic)... 34 2.23 Ansaintakausi (EarningPeriod)... 36 2.24 Etuuden yksikkö (BenefitUnit)... 37 2.25 Tulolajin lisätiedot (TransactionOther)... 38 2.26 Takaisinmaksun lisätiedot (RecoveryData)... 39 2.27 Regressin lisätiedot (RecourseData)... 40
Tietojen jakelu - Skeemat - Etuustietoilmoitukset 4 (51) 2.28 akuutuksen tiedot (Insurance)... 41 2.29 akuutuksenottajan tunnisteet (InsurancePolicyHolderIds)... 42 2.30 akuutuksenottajan perustiedot (InsurancePolicyHolderBasic)... 43 2.31 akuutuksenottajan osoite (Address)... 44 2.32 ähennykset (Deductions)... 45 2.33 Alkuperäisen etuuden ansaintakausi (OrigBenefitEarningPeriod)... 46 2.34 Sijaissaajan tiedot (IncomeBeneficiary)... 47 2.35 Sijaissaajan tunnisteet (IncomeBeneficiaryIds)... 48 2.36 Sijaissaajan perustiedot (IncomeBeneficiaryBasic)... 49 2.37 Sijaissaajan osoite (Address)... 50 2.38 Tilitysjakso (RemittancePeriod)... 51
Tietojen jakelu - Skeemat - Etuustietoilmoitukset 5 (51) 1 YLEISTÄ 1.1 Skeema Etuustietoilmoitukset toimitetaan tulorekisteristä skeemalla BenefitReportsFromIR. Skeeman nimiavaruudet ovat seuraavat: Tiedoston nimi Prefix Namespace xmlns:xs http://www.w3.org/2001/xmlschema BenefitReportsFromIR.xsd xmlns:brfir http://www.tulorekisteri.fi/2017/1/benefitreportsfromir BenefitReportsFromIRTypes.xsd xmlns:brfirt http://www.tulorekisteri.fi/2017/1/benefitreportsfromirtypes StatusMessageTypes.xsd xmlns:smt http://www.tulorekisteri.fi/2017/1/statusmessagetypes IRCommonTypes.xsd xmlns:irct http://www.tulorekisteri.fi/2017/1/ircommontypes xmldsig-core-schema.xsd xmlns:ds http://www.w3.org/2000/09/xmldsig# Tiedot jaetaan tulorekisteristä sisällöltään samanlaisina, kuin ne on toimitettu tulorekisteriin. Jakelussa huomioidaan tiedon käyttäjän tiedonsaantiprofiili. 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 ' 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 -. Aineiston omistajan aineistoviite (DeliveryId)
Tietojen jakelu - Skeemat - Etuustietoilmoitukset 6 (51) 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 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. Elementti on aina mukana siinä tapauksessa, että sen emoelementti on mukana.
Tietojen jakelu - Skeemat - Etuustietoilmoitukset 7 (51) Joissakin elementeissä sanomilla käytetään rajoitetun arvoavaruuden arvoja eli koodeja. Koodien arvoavaruus eli mahdolliset arvot on kuvattu dokumenteissa Koodistot ja Etuudet - Koodistot - Tulolajit. Tässä dokumentissa viitataan koodistoissa esiteltyihin arvoihin nimellä koodisto.
Tietojen jakelu - Skeemat - Etuustietoilmoitukset 8 (51) 2 ETUUSTIETOILMOITUKSET (BENEFITREPORTSFROMIR) Tulorekisteristä jaettavan etuustietoilmoituksia sisältävän aineiston yleisrakenne on seuraava: Tietoryhmän nimi Tyyppi /P Aineistotilauksen tiedot (Subscription) brfirt:subscription P Poiminnan tiedot (Query) brfirt:query Poiminnan yhteenvetotiedot (Summary) brfirt:summary P Sanomatason virheet (MessageErrors) smt:messageerrors Aineistotason virheet (DeliveryErrors) smt:deliveryerrors Ilmoitusten tiedot (Reports) brfirt:reports Ilmoituksen tiedot (Report) brfirt:report P Aineiston tiedot (DeliveryData) brfirt:deliverydata P Aineiston yhteyshenkilöt (ContactPersons) brfirt:contactpersons Maksajan tiedot (Payer) brfirt:payer Maksajan tunnisteet (PayerIds) brfirt:payerids Maksajan perustiedot (PayerBasic) brfirt:payerbasic Maksajan osoite (Address) brfirt:address Maksajan aliorganisaatiot (SubOrgs) brfirt:suborgs Maksajan muut tiedot (PayerOther) brfirt:payerother Palvelun tiedot (ReportData) brfirt:reportdata P Tulonsaajan tiedot (IncomeEarner) brfirt:incomeearner Tulonsaajan tunnisteet (IncomeEarnerIds) brfirt:incomeearnerids Tulonsaajan perustiedot (IncomeEarnerBasic) brfirt:incomeearnerbasic Tulonsaajan osoite (Address) brfirt:address Kansainväliset tilanteet (InternationalData) brfirt:internationaldata Tulolajit (Transactions) brfirt:transactions Tulolajin tiedot (Transaction) brfirt:transaction P Tulolajin yleistiedot (TransactionBasic) brfirt:transactionbasic Ansaintakausi (EarningPeriod) brfirt:earningperiod Etuuden yksikkö (BenefitUnit) brfirt:benefitunit Tulolajin lisätiedot (TransactionOther) brfirt:transactionother Takaisinmaksun lisätiedot (RecoveryData) brfirt:recoverydata akuutuksen tiedot (Insurance) brfirt:insurance ähennykset (Deductions) brfirt:deductions Allekirjoitus (Signature) xsig:signaturetype P
Tietojen jakelu - Skeemat - Etuustietoilmoitukset 9 (51) Tiedon nimi Tyyppi Sallitut arvot /P Käsittelysääntö Aineistotilauksen tiedot (Subscription) brfirt:subscription P Tietoryhmässä toimitetaan aineistotilaukseen tai palvelupyyntöön liittyviä tietoja. Poiminnan tiedot (Query) brfirt: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) brfirt: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) brfirt:reports Etuustietoilmoitukset Allekirjoitus (Signature) xsig:signaturetype P Tietoryhmässä toimitetaan aineiston sähköinen allekirjoitus.
Tietojen jakelu - Skeemat - Etuustietoilmoitukset 10 (51) 2.1 Aineistotilauksen tiedot (Subscription) Tiedon nimi Tyyppi Sallitut arvot /P Käsittelysääntö Aineistotilauksen tiedot (Subscription) brfirt: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 WSpalvelukutsun vastaussanomalla.
Tietojen jakelu - Skeemat - Etuustietoilmoitukset 11 (51) 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 - Etuustietoilmoitukset 12 (51) 2.2 Poiminnan tiedot (Query) Tiedon nimi Tyyppi Sallitut arvot /P Käsittelysääntö Poiminnan tiedot (Query) brfirt: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 (loppuhetki pois lukien).
Tietojen jakelu - Skeemat - Etuustietoilmoitukset 13 (51) 2.3 Poiminnan yhteenvetotiedot (Summary) Tiedon nimi Tyyppi Sallitut arvot /P Käsittelysääntö Poiminnan yhteenvetotiedot (Summary) brfirt:summary P Tietoryhmässä toimitetaan poimintaan liittyvää summatietoa. Poimittujen kohteiden lukumäärä (NrOfReports) xs:int P Poimittujen etuustietoilmoitusten lukumäärä.
Tietojen jakelu - Skeemat - Etuustietoilmoitukset 14 (51) 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 - Etuustietoilmoitukset 15 (51) 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 - Etuustietoilmoitukset 16 (51) 2.6 Ilmoitusten tiedot (Reports) Tiedon nimi Tyyppi Sallitut arvot /P Käsittelysääntö Ilmoitusten tiedot (Reports) brfirt:reports Tietoryhmässä palautetaan aineistoon poimitut etuustietoilmoitukset. Ilmoituksen tiedot (Report) brfirt:report P Ilmoituksia voi olla useita. Aineiston tiedot (DeliveryData) brfirt:deliverydata P Palvelun tiedot (ReportData) brfirt:reportdata P Tulonsaajan tiedot (IncomeEarner) brfirt:incomeearner Tulolajit (Transactions) brfirt:transactions Tietoryhmään kuuluvat vapaaehtoiseksi merkityt tietoryhmät tai tiedot
Tietojen jakelu - Skeemat - Etuustietoilmoitukset 17 (51) 2.7 Aineiston tiedot (DeliveryData) Tiedon nimi Tyyppi Sallitut arvot /P Käsittelysääntö Aineiston tiedot (DeliveryData) brfirt:deliverydata P Tietoryhmään kuuluvat vapaaehtoiseksi merkityt tietoryhmät tai tiedot 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) Suorituksen maksupäivä tai muu ilmoituspäivä (PaymentDate) xs:int xs:date koodisto: DeliveryToIRChannelCode Aineiston yhteyshenkilöt (ContactPersons) brfirt:contactpersons Maksajan tiedot (Payer) brfirt:payer P
Tietojen jakelu - Skeemat - Etuustietoilmoitukset 18 (51) 2.8 Aineiston yhteyshenkilöt (ContactPersons) Tiedon nimi Tyyppi Sallitut arvot /P Käsittelysääntö Aineiston yhteyshenkilöt (ContactPersons) brfirt:contactpersons Tietoryhmään kuuluvat vapaaehtoiseksi merkityt tietoryhmät tai tiedot Aineiston yhteyshenkilö (ContactPerson) brfirt: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 - Etuustietoilmoitukset 19 (51) 2.9 Maksajan tiedot (Payer) Tiedon nimi Tyyppi Sallitut arvot /P Käsittelysääntö Maksajan tiedot (Payer) brfirt:payer Tietoryhmään kuuluvat vapaaehtoiseksi merkityt tietoryhmät tai tiedot Maksajan tunnisteet (PayerIds) brfirt:payerids Maksajan perustiedot (PayerBasic) brfirt:payerbasic Maksajan osoite (Address) brfirt:address Maksajan aliorganisaatiot (SubOrgs) brfirt:suborgs Maksajan muut tiedot (PayerOther) brfirt:payerother
Tietojen jakelu - Skeemat - Etuustietoilmoitukset 20 (51) 2.10 Maksajan tunnisteet (PayerIds) Tiedon nimi Tyyppi Sallitut arvot /P Käsittelysääntö Maksajan tunnisteet (PayerIds) brfirt:payerids Tietoryhmään kuuluvat vapaaehtoiseksi merkityt tietoryhmät tai tiedot Maksajan tunniste (Id) brfirt:id P Maksajalla voi olla useita tunnisteita. Etuuden maksajan tunnisteen tyyppi (Type) xs:int koodisto: BenefitPayerIdType 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 - Etuustietoilmoitukset 21 (51) 2.11 Maksajan perustiedot (PayerBasic) Tiedon nimi Tyyppi Sallitut arvot /P Käsittelysääntö Maksajan perustiedot (PayerBasic) brfirt:payerbasic Tietoryhmään kuuluvat vapaaehtoiseksi merkityt tietoryhmät tai tiedot Yrityksen nimi (CompanyName) irct:string200 P
Tietojen jakelu - Skeemat - Etuustietoilmoitukset 22 (51) 2.12 Maksajan osoite (Address) Tiedon nimi Tyyppi Sallitut arvot /P Käsittelysääntö Maksajan osoite (Address) brfirt:address Tietoryhmään kuuluvat vapaaehtoiseksi merkityt tietoryhmät tai tiedot 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 - Etuustietoilmoitukset 23 (51) 2.13 Maksajan aliorganisaatiot (SubOrgs) Tiedon nimi Tyyppi Sallitut arvot /P Käsittelysääntö Maksajan aliorganisaatiot (SubOrgs) brfirt:suborgs Tietoryhmään kuuluvat vapaaehtoiseksi merkityt tietoryhmät tai tiedot Maksajan aliorganisaatio (SubOrg) brfirt:suborg P Maksajalla voi olla useita aliorganisaatioita. Etuuden maksajan aliorganisaation tunnisteen tyyppi (Type) xs:int koodisto: BenefitPayerSubOrgType Aliorganisaation tunniste (Code) irct:string20
Tietojen jakelu - Skeemat - Etuustietoilmoitukset 24 (51) 2.14 Maksajan muut tiedot (PayerOther) Tiedon nimi Tyyppi Sallitut arvot /P Käsittelysääntö Maksajan muut tiedot (PayerOther) brfirt:payerother Tietoryhmään kuuluvat vapaaehtoiseksi merkityt tietoryhmät tai tiedot Maksajan tyypit (PayerTypes) brfirt:payertypes P Maksajalla voi olla useita maksajan tyyppejä. Etuuden maksajan tyyppi (PayerType) xs:int koodisto: BenefitPayerType P
Tietojen jakelu - Skeemat - Etuustietoilmoitukset 25 (51) 2.15 Palvelun tiedot (ReportData) Tiedon nimi Tyyppi Sallitut arvot /P Käsittelysääntö Palvelun tiedot (ReportData) brfirt:reportdata P Tietoryhmään kuuluvat vapaaehtoiseksi merkityt tietoryhmät tai tiedot 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) Tulorekisterin ilmoitusviite alkuperäisellä mitätöidyllä ilmoituksella (OrigIRReportId) xs:datetime P Päivä ja kellonaika, jolloin ilmoituksen ensimmäinen versio on vastaanotettu tulorekisteriin. xs:datetime P Päivä ja kellonaika, jolloin ilmoitusversio on tallennettu tulorekisteriin. irct:guid Tulorekisterin ilmoitusviite alkuperäisellä mitätöidyllä ilmoituksella on sen ketjussa ensimmäisen ilmoituksen tulorekisterin ilmoitusviite, jonka on mitätöimällä korjattu (alkuperäiseen ilmoitukseen on voinut kohdistua useita
Tietojen jakelu - Skeemat - Etuustietoilmoitukset 26 (51) Maksajan ilmoitusviite alkuperäisellä mitätöidyllä ilmoituksella (OrigReportId) korjauksia, jotka ovat edellyttäneet ilmoituksen mitätöimistä ja uuden ilmoituksen lisäämistä). irct:string40 Maksajan ilmoitusviite alkuperäisellä mitätöidyllä ilmoituksella on sen ketjussa ensimmäisen ilmoituksen tulorekisterin ilmoitusviite, jonka on mitätöimällä korjattu (alkuperäiseen ilmoitukseen on voinut kohdistua useita korjauksia, jotka ovat edellyttäneet ilmoituksen mitätöimistä ja uuden ilmoituksen lisäämistä).
Tietojen jakelu - Skeemat - Etuustietoilmoitukset 27 (51) 2.16 Tulonsaajan tiedot (IncomeEarner) Tiedon nimi Tyyppi Sallitut arvot /P Käsittelysääntö Tulonsaajan tiedot (IncomeEarner) brfirt:incomeearner Tietoryhmään kuuluvat vapaaehtoiseksi merkityt tietoryhmät tai tiedot Tulonsaajan tietoihin voi sisältyä turvakiellon alaisia tietoja (SensitiveInfoIncluded) irct:true true Elementin arvo on true, jos tulonsaaja on turvakiellossa ja tietoryhmässä Tulonsaajan osoite (Address) jaetaan ilmoituksen tietoja. Tietoa ei jaeta, jos tietoryhmää Tulonsaajan osoite (Address) ei jaeta. Tulonsaajan tunnisteet (IncomeEarnerIds) brfirt:incomeearnerids Tulonsaajan perustiedot (IncomeEarnerBasic) brfirt:incomeearnerbasi c Tulonsaajan osoite (Address) brfirt:address Kansainväliset tilanteet (InternationalData) brfirt:internationaldata
Tietojen jakelu - Skeemat - Etuustietoilmoitukset 28 (51) 2.17 Tulonsaajan tunnisteet (IncomeEarnerIds) Tiedon nimi Tyyppi Sallitut arvot /P Käsittelysääntö Tulonsaajan tunnisteet (IncomeEarnerIds) brfirt:incomeearnerids Tietoryhmään kuuluvat vapaaehtoiseksi merkityt tietoryhmät tai tiedot Tulonsaajan tunniste (Id) brfirt:id P Tulonsaajalla voi olla useita tunnisteita. Etuuden saajan tunnisteen tyyppi (Type) xs:int koodisto: BenefitIncomeEarnerIdTy pe 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 - Etuustietoilmoitukset 29 (51) 2.18 Tulonsaajan perustiedot (IncomeEarnerBasic) Tiedon nimi Tyyppi Sallitut arvot /P Käsittelysääntö Tulonsaajan perustiedot (IncomeEarnerBasic) Tulonsaajalla ei ole asiakastunnistetta (MissingId) brfirt:incomeearnerbasi c irct:true true Yrityksen nimi (CompanyName) irct:string200 Sukunimi (LastName) irct:string200 Etunimi (FirstName) irct:string100 Syntymäaika (BirthDate) xs:date Sukupuoli (Gender) xs:int koodisto: Gender Tietoryhmään kuuluvat vapaaehtoiseksi merkityt tietoryhmät tai tiedot
Tietojen jakelu - Skeemat - Etuustietoilmoitukset 30 (51) 2.19 Tulonsaajan osoite (Address) Tiedon nimi Tyyppi Sallitut arvot /P Käsittelysääntö Tulonsaajan osoite (Address) brfirt:address Tietoryhmään kuuluvat vapaaehtoiseksi merkityt tietoryhmät tai tiedot 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 - Etuustietoilmoitukset 31 (51) 2.20 Kansainväliset tilanteet (InternationalData) Tiedon nimi Tyyppi Sallitut arvot /P Käsittelysääntö Kansainväliset tilanteet (InternationalData) brfirt:internationaldata Tietoryhmään kuuluvat vapaaehtoiseksi merkityt tietoryhmät tai tiedot Rajoitetusti verovelvollinen (NonResident) irct:true true Asuinvaltion maakoodi (NonResidentCountryCode) irct:string2 ISO3166-maakoodiston mukainen 2-kirjaiminen koodi. Jos maa on tuntematon, arvo on 99. Asuinvaltion nimi (NonResidentCountryName) irct:string70 Ennakonpidätyksen alainen tulo (SubToWithhold) irct:true true
Tietojen jakelu - Skeemat - Etuustietoilmoitukset 32 (51) 2.21 Tulolajit (Transactions) Tiedon nimi Tyyppi Sallitut arvot /P Käsittelysääntö Tulolajit (Transactions) brfirt:transactions Tietoryhmään kuuluvat vapaaehtoiseksi merkityt tietoryhmät tai tiedot Tulolajin tiedot (Transaction) brfirt:transaction P Tulolajeja voi olla useita. Tulolajin yleistiedot (TransactionBasic) brfirt:transactionbasic Ansaintakausi (EarningPeriod) brfirt:earningperiod Etuuden yksikkö (BenefitUnit) brfirt:benefitunit Tulolajin lisätiedot (TransactionOther) brfirt:transactionother Takaisinmaksun lisätiedot (RecoveryData) brfirt:recoverydata Regressin lisätiedot (RecourseData) brtirt:recoursedata akuutuksen tiedot (Insurance) brfirt:insurance
Tietojen jakelu - Skeemat - Etuustietoilmoitukset 33 (51) ähennykset (Deductions) brfirt:deductions
Tietojen jakelu - Skeemat - Etuustietoilmoitukset 34 (51) 2.22 Tulolajin yleistiedot (TransactionBasic) Tiedon nimi Tyyppi Sallitut arvot /P Käsittelysääntö Tulolajin yleistiedot (TransactionBasic) brfirt:transactionbasic Tietoryhmään kuuluvat vapaaehtoiseksi merkityt tietoryhmät tai tiedot Tulolajin koodi (TransactionCode) xs:int koodisto: BenefitTransactionCode Määrä (Amount) irct:decimal2 Etuuden veronalaisuus (TaxTreatment) xs:int koodisto: BenefitTaxTreatment Kertakorvaus (OneOff) irct:true true
Tietojen jakelu - Skeemat - Etuustietoilmoitukset 35 (51) Perusteeton etu (UnjustEnrichment) irct:true true Takaisinperintä (Recovery) irct:true true Oma-aloitteinen palautus (UnpromptedRefund) irct:true true iivästyskorotus (DelayIncrease) irct:true true Regressi (Recourse) irct:true true Maksun oikaisu (PaymentReallocation) irct:true true Ei vaikuta verotukseen (NoTaxEffect) irct:true true
Tietojen jakelu - Skeemat - Etuustietoilmoitukset 36 (51) 2.23 Ansaintakausi (EarningPeriod) Tiedon nimi Tyyppi Sallitut arvot /P Käsittelysääntö Ansaintakausi (EarningPeriod) brfirt:earningperiod Tietoryhmään kuuluvat vapaaehtoiseksi merkityt tietoryhmät tai tiedot Alkupäivä (StartDate) xs:date Loppupäivä (EndDate) xs:date
Tietojen jakelu - Skeemat - Etuustietoilmoitukset 37 (51) 2.24 Etuuden yksikkö (BenefitUnit) Tiedon nimi Tyyppi Sallitut arvot /P Käsittelysääntö Etuuden yksikkö (BenefitUnit) brfirt:benefitunit Tietoryhmään kuuluvat vapaaehtoiseksi merkityt tietoryhmät tai tiedot Yksikkö (UnitCode) xs:int koodisto: BenefitUnitCode Yksiköiden määrä (UnitAmount) irct:decimal2
Tietojen jakelu - Skeemat - Etuustietoilmoitukset 38 (51) 2.25 Tulolajin lisätiedot (TransactionOther) Tiedon nimi Tyyppi Sallitut arvot /P Käsittelysääntö Tulolajin lisätiedot (TransactionOther) brfirt:transactionother Tietoryhmään kuuluvat vapaaehtoiseksi merkityt tietoryhmät tai tiedot Rajoitetusti verovelvolliselle maksetun eläkkeen peruste (NonresidentPensionBasis) xs:int koodisto: NonresidentPensionBas is P
Tietojen jakelu - Skeemat - Etuustietoilmoitukset 39 (51) 2.26 Takaisinmaksun lisätiedot (RecoveryData) Tiedon nimi Tyyppi Sallitut arvot /P Käsittelysääntö Takaisinmaksun lisätiedot (RecoveryData) brfirt:recoverydata Tietoryhmään kuuluvat vapaaehtoiseksi merkityt tietoryhmät tai tiedot Takaisinmaksupäivä (RecoveryDate) xs:date Takaisinmaksuun kohdistuva ennakonpidätys (Withhold) Takaisinmaksuun kohdistuva lähdevero (TaxAtSource) Alkuperäinen ansaintakausi (OrigEarningPeriod) Suorituksen maksupäivä tai muu ilmoituspäivä (PaymentDate) irct:decimal2 irct:decimal2 brfirt:origearningperiod xs:date Alkupäivä (StartDate) xs:date Loppupäivä (EndDate) xs:date
Tietojen jakelu - Skeemat - Etuustietoilmoitukset 40 (51) 2.27 Regressin lisätiedot (RecourseData) Tiedon nimi Tyyppi Sallitut arvot /P Käsittelysääntö Regressin lisätiedot (RecourseData) brtirt:recoursedata Tietoryhmään kuuluvat vapaaehtoiseksi merkityt tietoryhmät tai tiedot Regressi verottomasta tulosta, maksupäivä (RecoursePaymentDate) xs:date P
Tietojen jakelu - Skeemat - Etuustietoilmoitukset 41 (51) 2.28 akuutuksen tiedot (Insurance) Tiedon nimi Tyyppi Sallitut arvot /P Käsittelysääntö akuutuksen tiedot (Insurance) brfirt:insurance Tietoryhmään kuuluvat vapaaehtoiseksi merkityt tietoryhmät tai tiedot akuutuksen numero tai muu tunnus (InsuranceNo) akuutuksenottajan tiedot (InsurancePolicyHolder) akuutuksenottajan tietoihin voi sisältyä turvakiellon alaisia tietoja (SensitiveInfoIncluded) akuutuksenottajan tunnisteet (InsurancePolicyHolderIds) akuutuksenottajan perustiedot (InsurancePolicyHolderBasic) irct:string20 brfirt:insurancepolicyh older irct:true true Elementin arvo on true, jos vakuutuksenottaja on turvakiellossa ja tietoryhmässä akuutuksenottajan osoite (Address) jaetaan ilmoituksen tietoja. Tietoa ei jaeta, jos tietoryhmää akuutuksenottajan osoite (Address) ei jaeta. brfirt:insurancepolicyh olderids brfirt:insurancepolicyh olderbasic akuutuksenottajan osoite (Address) brfirt:address
Tietojen jakelu - Skeemat - Etuustietoilmoitukset 42 (51) 2.29 akuutuksenottajan tunnisteet (InsurancePolicyHolderIds) Tiedon nimi Tyyppi Sallitut arvot /P Käsittelysääntö akuutuksenottajan tunnisteet (InsurancePolicyHolderIds) brfirt:insurancepolicyh olderids Tietoryhmään kuuluvat vapaaehtoiseksi merkityt tietoryhmät tai tiedot akuutuksenottajan tunniste (Id) brfirt:id P akuutuksenottajalla 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, annetaan arvo 99. Maan nimi (CountryName) irct:string70
Tietojen jakelu - Skeemat - Etuustietoilmoitukset 43 (51) 2.30 akuutuksenottajan perustiedot (InsurancePolicyHolderBasic) Tiedon nimi Tyyppi Sallitut arvot /P Käsittelysääntö akuutuksenottajan perustiedot (InsurancePolicyHolderBasic) akuutuksenottajalla ei ole asiakastunnistetta (MissingId) brfirt:insurancepolicyh olderbasic irct:true true Yrityksen nimi (CompanyName) irct:string200 Sukunimi (LastName) irct:string200 Etunimi (FirstName) irct:string100 Syntymäaika (BirthDate) xs:date Sukupuoli (Gender) xs:int koodisto: Gender Tietoryhmään kuuluvat vapaaehtoiseksi merkityt tietoryhmät tai tiedot
Tietojen jakelu - Skeemat - Etuustietoilmoitukset 44 (51) 2.31 akuutuksenottajan osoite (Address) Tiedon nimi Tyyppi Sallitut arvot /P Käsittelysääntö akuutuksenottajan osoite (Address) brfirt:address Tietoryhmään kuuluvat vapaaehtoiseksi merkityt tietoryhmät tai tiedot 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, annetaan arvo 99. Maan nimi (CountryName) irct:string70
Tietojen jakelu - Skeemat - Etuustietoilmoitukset 45 (51) 2.32 ähennykset (Deductions) Tiedon nimi Tyyppi Sallitut arvot /P Käsittelysääntö ähennykset (Deductions) brfirt:deductions Tietoryhmään kuuluvat vapaaehtoiseksi merkityt tietoryhmät tai tiedot ähennyksen tiedot (Deduction) brfirt:deduction P ähennyksiä voi olla useita. ähennyksen tulolajin koodi (DeductionTransactionCode) xs:int koodisto: BenefitTransactionCode ähennyksen tyyppi (DeductionType) xs:int koodisto: DeductionType ähennyksen määrä (Amount) irct:decimal2 Alkuperäisen etuuden ansaintakausi (OrigBenefitEarningPeriod) Sijaissaajan tiedot (IncomeBeneficiary) brfirt:origbenefitearnin gperiod brfirt:incomebeneficiar y Tilitysjakso (RemittancePeriod) brfirt:remittanceperiod
Tietojen jakelu - Skeemat - Etuustietoilmoitukset 46 (51) 2.33 Alkuperäisen etuuden ansaintakausi (OrigBenefitEarningPeriod) Tiedon nimi Tyyppi Sallitut arvot /P Käsittelysääntö Alkuperäisen etuuden ansaintakausi (OrigBenefitEarningPeriod) Suorituksen maksupäivä tai muu ilmoituspäivä (PaymentDate) brfirt:origbenefitearnin gperiod xs:date Alkupäivä (StartDate) xs:date Loppupäivä (EndDate) xs:date Tietoryhmään kuuluvat vapaaehtoiseksi merkityt tietoryhmät tai tiedot
Tietojen jakelu - Skeemat - Etuustietoilmoitukset 47 (51) 2.34 Sijaissaajan tiedot (IncomeBeneficiary) Tiedon nimi Tyyppi Sallitut arvot /P Käsittelysääntö Sijaissaajan tiedot (IncomeBeneficiary) Sijaissaajan tietoihin voi sisältyä turvakiellon alaisia tietoja (SensitiveInfoIncluded) Sijaissaajan tunnisteet (IncomeBeneficiaryIds) Sijaissaajan perustiedot (IncomeBeneficiaryBasic) brfirt:incomebeneficiar y Tietoryhmään kuuluvat vapaaehtoiseksi merkityt tietoryhmät tai tiedot irct:true true Elementin arvo on true, jos sijaissaaja on turvakiellossa ja tietoryhmässä Sijaissaajan osoite (Address) jaetaan ilmoituksen tietoja. Tietoa ei jaeta, jos tietoryhmää Sijaissaajan osoite (Address) ei jaeta. brfirt:incomebeneficiar yids brfirt:incomebeneficiar ybasic Sijaissaajan osoite (Address) brfirt:address
Tietojen jakelu - Skeemat - Etuustietoilmoitukset 48 (51) 2.35 Sijaissaajan tunnisteet (IncomeBeneficiaryIds) Tiedon nimi Tyyppi Sallitut arvot /P Käsittelysääntö Sijaissaajan tunnisteet (IncomeBeneficiaryIds) brfirt:incomebeneficiar yids Tietoryhmään kuuluvat vapaaehtoiseksi merkityt tietoryhmät tai tiedot Sijaissaajan tunniste (Id) brfirt:id P Sijaissaajalla 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, annetaan arvo 99. Maan nimi (CountryName) irct:string70
Tietojen jakelu - Skeemat - Etuustietoilmoitukset 49 (51) 2.36 Sijaissaajan perustiedot (IncomeBeneficiaryBasic) Tiedon nimi Tyyppi Sallitut arvot /P Käsittelysääntö Sijaissaajan perustiedot (IncomeBeneficiaryBasic) Sijaissaajalla ei ole asiakastunnistetta (MissingId) brfirt:incomebeneficiar ybasic irct:true true Yrityksen nimi (CompanyName) irct:string200 Sukunimi (LastName) irct:string200 Etunimi (FirstName) irct:string100 Syntymäaika (BirthDate) xs:date Sukupuoli (Gender) xs:int koodisto: Gender Sijaissaajan tyyppi (IncomeBeneficiaryType) xs:int koodisto: IncomeBeneficiaryType Tietoryhmään kuuluvat vapaaehtoiseksi merkityt tietoryhmät tai tiedot
Tietojen jakelu - Skeemat - Etuustietoilmoitukset 50 (51) 2.37 Sijaissaajan osoite (Address) Tiedon nimi Tyyppi Sallitut arvot /P Käsittelysääntö Sijaissaajan osoite (Address) brfirt:address Tietoryhmään kuuluvat vapaaehtoiseksi merkityt tietoryhmät tai tiedot 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, annetaan arvo 99. Maan nimi (CountryName) irct:string70
Tietojen jakelu - Skeemat - Etuustietoilmoitukset 51 (51) 2.38 Tilitysjakso (RemittancePeriod) Tiedon nimi Tyyppi Sallitut arvot /P Käsittelysääntö Tilitysjakso (RemittancePeriod) brfirt:remittanceperiod Tietoryhmään kuuluvat vapaaehtoiseksi merkityt tietoryhmät tai tiedot Alkupäivä (StartDate) xs:date Loppupäivä (EndDate) xs:date