1 (27) Lutttietraprtinti Knekielisen tietjenvälityksen kuvaus Versi 1.8 ()
2 (27) Versi Päivämäärä Vimassal Muutkset 1.8 - Skeemaversin 1.8 päivitysten mukaiset muutkset - Muutsraprtintiin liittyvät viittaukset pistettu (lähetystyyppi CHANGE, tapahtumatyyppi DELETE), kappaleet 4.3, 5, 5.1, 5.7.2 ja 6 1.7 14.8.2018 - Skeemaversin 1.7 päivitysten mukaiset muutkset 1.6 13.7.2018 - Skeemaversin 1.6 päivitysten mukaiset muutkset - Muutettu DCS2-palveluntarjajan nimi Psti Messaging Oy:ksi 1.5 16.3.2018 - Skeemaversin 1.5 päivitysten mukaiset muutkset - Lisätty DCS2-palvelun web-site tutantraprtintia varten 1.4 31.1.2018 - Skeemaversin 1.4 päivitysten mukaiset muutkset 1.3 28.12.2017 - Skeemaversin 1.3 päivitysten mukaiset muutkset - Krjattu kappaleen 5.1.1 Osapuliraprttitiedst taulukn vaatimukset Yrityksen pääknttrin tunnisteelle, Välittömän emyhtiön tunnisteelle ja Perimmäisen emyhtiön tunnisteelle - Täsmennetty kappaleen 5.3.2 Palautetiedstjen skeema saa Sumen Pankin surittamien tarkistusten palautteesta 1.2 29.9.2017 Tämä n hjeen lunnsversi, jlla ei vi raprtida Sumen Pankkiin. - Skeemaversin 1.2 päivitysten mukaiset muutkset - Lisätty kappaleeseen 1 Jhdant si DCS2- raprtinnista - Lisätty kappaleeseen 5.3 XML-skeema ja sen versi tieta palauteraprttien skeemista - Täsmennetty kappaleissa 5.6.1 ja 5.6.2 raprtijalle käytettävää tunnusta, kun raprtija ei le sumalainen - Tarkennettu kappaleessa 5.7 lleita tarkistussääntöjä uusissa kappaleissa 5.7.1 Tiednkeruupalvelun surittamat tarkastukset ja 5.7.2 Sumen Pankin surittamat muut tekniset tarkistukset
3 (27) 1.1 24.5.2017 Tämä n hjeen lunnsversi, jlla ei vi raprtida Sumen Pankkiin. 1.0 31.1.2017 Tämä n hjeen lunnsversi, jlla ei vi raprtida Sumen Pankkiin. - Lisätty tiet sumi.fi tunnistus- ja valtuutuspalvelusta kappaleeseen 6 Tietjen timittaminen Sumen Pankille - Täsmennetty kappaletta 8 Palauteraprtit - Skeemaversin 1.1 päivitysten mukaiset muutkset. - Krjattu kappaleen 5.1.2 kuukausilutttietraprtin tietueiden avaintunnisteiden kuvaukset. - Täsmennetty ei svellettavissa levien tietattribuuttien ja tyhjien arvjen raprtintia kappaleessa 5.2 Raprtitavat arvt ja tarkkuus - Täsmennetty kappaletta 5.4 Suurten raprttitiedstjen pilkkminen. - Muutettu aikaleiman (EXTRACTEDTIME) mudstamistapaa kappaleessa 5.6 Tiedstjen nimeäminen. - Lisätty uusia tarkistussääntöjä kappaleessa 5.7 Tarkistussäännöt. - Yleisesti pieniä täsmennyksiä aiemman versin kieliasuun.
4 (27) Sisällysluettel 1 Jhdant... 5 2 Lutttietraprtinnin yhteisökäsitteet... 6 3 Raprtintivelvllisuus... 6 4 Lutttietraprtin rakenne... 7 4.1 Merkistö... 7 4.2 Timitustiedst... 7 4.3 Kuriraprtti... 8 5 Osapuli- ja lutttietraprttitiedstt... 10 5.1 Raprttitiedstjen perusrakenne... 10 5.1.1 Osapuliraprttitiedst... 11 5.1.2 Kuukausiluttraprttitiedst... 13 5.1.3 Neljännesvusiluttraprttitiedst... 14 5.2 Raprtitavat arvt ja tarkkuus... 15 5.3 XML-skeema ja sen versi... 15 5.3.1 Timitus- ja raprttitiedstjen skeema... 15 5.3.2 Palautetiedstjen skeema... 16 5.3.2.1 Tiednkeruupalvelun surittamien tarkistusten palautetiedstjen skeema... 16 5.3.2.2 Sumen Pankin surittamien tarkistusten palautetiedstjen skeema... 17 5.4 Suurten raprttitiedstjen pilkkminen... 17 5.5 Raprttitiedstjen pakkaaminen... 19 5.6 Tiedstjen nimeäminen... 19 5.6.1 Timitustiedstn nimi... 19 5.6.2 Kuriraprtin nimi... 20 5.6.3 Raprttitiedstjen nimet... 20 5.7 Tekniset tarkistussäännöt... 21 5.7.1 Tiednkeruupalvelun surittamat tarkastukset (virhekdi suluissa)... 22 5.7.1.1 Timitustiedstn khdistuvat tarkastukset... 22 5.7.1.2 Kuriraprttiin khdistuvat tarkastukset... 22 5.7.1.3 Raprttitiedstihin khdistuvat tarkastukset... 23 5.7.2 Sumen Pankin surittamat muut tekniset tarkistukset... 23 6 Tietjen timittaminen Sumen Pankille...24 7 Raprtintitavat...26 7.1 Timittaminen tiedstlatauksena...26 7.2 SFTP-tiedstsiirt...26 8 Palauteraprtit... 27 8.1 Tiednkeruupalvelun surittamien tarkistusten palaute... 27 8.2 Sumen Pankin surittamien tarkistusten palaute... 27
5 (27) 1 Jhdant Lutttietraprtinti perustuu Eurpan keskuspankin (EKP) asetukseen (EU) 2016/867 yksityiskhtaisten lutt- ja luttriskitietjen keruusta (EKP/2016/13). Sumen Pankille raprtitavia lutttietja n täydennetty kansallisilla vaatimuksilla, jita Sumen Pankki tarvitsee tehtäviensä hitamista varten. EKP:n asetus (EKP/2016/13) velvittaa Sumen Pankin keräämään lutttiedt ktimaisilta luttlaitksilta ja luttlaitsten ulkmaisilta sivuknttreilta, jtka vat ktimaisia tietja antavassa jäsenvaltissa riippumatta siitä, vatk ne Eurpan parlamentin ja neuvstn direktiivin (2013/36/EU) 1 mukaisesti valvttuja laitksia. Sumen Pankin tiednhankintavaltuudet perustuvat Eurpan uninin asetukseen Eurpan keskuspankin valtuuksista kerätä tilasttietja (EY N: 2533/98, muutettu 2015/373) ja lakiin Sumen Pankista (214/1998, 26 ja 28 ) 2. Asetus (EKP/2016/13) kskee kaikkia rahaliitn alueella sijaitsevia luttlaitksia. EKP vi asetuksen (EY) N: 2533/98 artiklan 7 khdan 1 mukaisesti määrätä seuraamuksia tiednantajille, jtka eivät nudata asetuksissa tai päätöksissä asetettuja tilastintiin liittyviä tietjenantvaatimuksia. Sumessa lutttietraprtinnin mukaisia tietja vat velvllisia raprtimaan ne ktimaiset luttlaitkset ja ulkmaisten luttlaitsten Sumessa timivat sivuknttrit, jille Sumen Pankki n raprtintivelvllisuudesta erikseen ilmittanut. Raprtintivelvllisuuden alkamisesta ja raprtintihelptuksen päättymisestä ilmitetaan raprtintivelvlliselle viimeistään 18 kuukautta ennen raprtinnin alkamista. Raprtintivelvllisten tiednantvelvllisuudet tarkistetaan vusittain rahalaitsten 1 Eurpan parlamentin ja neuvstn direktiivi 2013/36/EU, annettu 26.6.2013, ikeudesta harjittaa luttlaitstimintaa ja luttlaitsten ja sijituspalveluyritysten vakavaraisuusvalvnnasta, direktiivin 2002/87/EY muuttamisesta sekä direktiivien 2006/48/EY ja 2006/49/EY kumamisesta (EUVL L 176, 27.6.2013). 2 Tilastintiin liittyvät Eurpan keskuspankin (EKP) asetukset vat luettavissa internetistä sitteesta https://www.sumenpankki.fi/fi/tilastt/raprtintihjeet/
6 (27) 2 Lutttietraprtinnin yhteisökäsitteet 3 Raprtintivelvllisuus tasetilastasetuksen (EKP/2013/33, muutettu EKP/2014/51) mukaisen lainankannan perusteella. Lutttietraprtinnin knekielisen tietjenvälityksen kuvausta svelletaan lutttietraprtinnin (AC, AnaCredit) tietjen tuttamiseen ja timittamiseen Sumen Pankille 31.3.2018 alkaen sapulitietjen ja 30.9.2018 alkaen lutttietjen salta. Sumen Pankki vastaanttaa raprtitavat tiedt Psti Messaging Oy:n ylläpitämän tiednkeruupalvelun (DCS2 - Data Cllectin Service 2) kautta. Lutttietraprtintia kskeva EKP:n asetus (EKP/2016/13) ja sisältövaatimukset sekä muuta raprtintiin liittyvää materiaalia n saatavilla Sumen Pankin internetsivuilla sitteesta https://www.sumenpankki.fi/fi/tilastt/raprtintihjeet/lutttietkan ta/ Raprtintivelvllinen n asetuksessa (EKP/2016/13) mainittu tiednantaja. Tiednantajana timiva luttlaits n velvllinen timittamaan sille määritetyt sapuli- ja lutttiedt Sumen Pankille. Tarkasteltava timija n tas, jlla raprtintivelvllisen tulee timittaa lutttiedt Sumen Pankille. Raprtintivelvllinen n aina itse tarkasteltava timija. Tämän lisäksi tarkasteltava timija vi lla myös raprtintivelvllisen sivuliike, jnka tietja raprtintivelvllisen n timitettava Sumen Pankille ilmitettujen tiednantvelvllisuuksien mukaisesti. Raprtijaksi kutsutaan tässä dkumentissa sitä taha, jka timittaa raprtin Sumen Pankille. Raprtija vi lla jk raprtintivelvllinen luttlaits itse tai erillinen tekninen tiedn timittaja. Sumen Pankille timitettujen lutttietjen ikeellisuudesta ja raprtintivelvllisuuden täyttymisestä vastaa raprtintivelvllinen luttlaits. Ohjeet lutttietraprtinnin raprtijaksi löytyvät testiraprtintipalvelun etusivulta sitteessa
7 (27). ja tutantraprtintipalvelun etusivulta sitteessa 4 Lutttietraprtin rakenne 4.1 Merkistö 4.2 Timitustiedst Lutttietraprtinti tteutetaan UTF-8-merkistöllä XMLkuvauskielisillä tiedstilla. Sumen Pankkiin timitettavan tiedstn eli timitustiedstn n ltava pakattu zip-tiedstksi, jka sisältää kuriraprtin ja varsinaisen datan sisältävät raprttitiedstt. Timitustiedst vi sisältää usean tarkasteltavan timijan lutttietraprttitiedstt.
8 (27) 4.3 Kuriraprtti Jkainen timitustiedst sisältää aina kuriraprtin (Header). Kuriraprtti kuvaa raprtitavan kknaisuuden metatietineen. Kuriraprtti sisältää muun muassa tiedt raprtijasta, raprtintijakssta sekä timitustiedstn kuuluvista erillisistä lutttietraprttitiedstista. Kuriraprtti ei saa ylittää 500 megatavun kka.
9 (27) Kuriraprtin alussa määritellään aina skeematiedst- ja muut nimiavaruusmääritykset. Kuriraprttiin n lisäksi sisällytettävä heisessa taulukssa esitellyt paklliset metatiedt: Elementin/attribuutin nimi SchemaVersin (attribute) SBMSSN_TYP (Submissin type - attribute) DATA_PRVDR_ID (Data prvider's identifier -element) DATA_PRVDR_NM (Data prvider's name - element) DT_RFRNC (Reference Perid -element) DT_FL_CRTN_DT_TM (File creatin date and time - element) TEST (Test element) EMAIL (Cntact e-mail address - element) RPRTD_FLS (Reprted files -element) RPRTD_FL (Reprted File -element) Käyttö Käytetyn skeeman versinumer Tapahtumatyyppi-attribuutin sallitut arvt: FULL Viitepäivämäärään khdistuva lähetys tai revisiinti, jka sisältää kaikki viitepäivämäärään khdistuvat tiedt Raprtijan yksilöivä kirjaimista ja numerista kstuva enintään 60 merkkiä pitkä tunniste Raprtijan nimi, enintään 255 merkkiä pitkä tunniste Viitepäivämäärä Raprtin luntipäivä ja luntiaika Mikäli raprttitiedst n testilähetys saa kenttä arvn true. Mikäli raprttitiedst n tutantlähetys saa kenttä arvn false. Yhteyshenkilön sähköpstisite, enintään 254 merkkiä pitkä merkkijn Timitustiedstn kuuluvat tiedstt, RPRTD_FLS kstuu RPRTD_FL elementeistä Yksittäisen raprttitiedstn nimi
10 (27) Esimerkki: 5 Osapuli- ja lutttietraprttitiedstt 5.1 Raprttitiedstjen perusrakenne Kuriraprtin tiedstn nimeäminen n kuvattu luvussa 5.6 Lutttietraprtinti kstuu klmesta kknaisuudesta: sapulitiedt, kuukausilutttiedt ja neljännesvusilutttiedt. Nämä raprtidaan erillisissä XML-kuvauskielisissä raprttitiedstissa, jista kullekin n mat skeematiedstnsa. Viitepäivämäärään khdistuva raprttitiedstjen kknaisuus sisältää aina täydellisen tilannekuvan lutttietraprtinnin tiedista. Mikäli viitepäivämäärän tietihin tulee muutksia edellä mainitun raprtin lähettämisen jälkeen, raprtija raprti kaikki viitepäivämäärän tiedt uudelleen. Osapulitiedt timitetaan ennen tai viimeistään samassa timitustiedstssa kuin sapuliin liittyvät kuukausi- ja neljännesvusilutttiedt. Raprttitiedstjen nimeäminen n kuvattu luvussa 5.6 Osapuli- ja lutttietraprttitiedstjen alussa määritellään aina skeematiedst- ja muut nimiavaruusmääritykset. Jkaisen näistä tiedstista tulee sisältää seuraavassa taulukssa luetellut perustiedt.
11 (27) Nämä tiedt yksilöivät raprttitiedstn ja saavat esiintyä siinä vain kerran. Elementin/attribuutin nimi Käyttö Pakllinen BatchRecrd SchemaVersin (attribute) DT_FL_CRTN_DT_TM (File creatin date and time element) Käytetyn skeeman versinumer (attribuutti) Raprttitiedstn luntipäivä ja luntiaika (s:datetime) X X ReprtingAgentRecrd SBMSSN_TYP (Submissin type - attribute) RPRTNG_AGNT_ID (Reprting agent identifier -element) TEST (Test -element) COMMENT (Cmment -element) DT_RFRNC (Reference Perid - element) Tapahtumatyyypi-attribuutin sallitut arvt: FULL Viitepäivämäärään khdistuva lähetys tai revisiinti, jka sisältää kaikki viitepäivämäärään khdistuvat tiedt Tiednantajan yksilöivä kirjaimista ja numerista kstuva enintään 60 merkkiä pitkä tunniste Mikäli raprttitiedst n testilähetys saa kenttä arvn true. Mikäli raprttitiedst n tutantlähetys saa kenttä arvn false. Vapaamutinen enintään 255 merkkiä pitkä kmmentti Viitepäivämäärän tunniste (YYYY- MM-DD) X X X X 5.1.1 Osapuliraprttitiedst Tiednantaja timittaa kaikkien sen raprtintivelvllisuuden alle kuuluvien tarkasteltavien timijiden sapulitiedt samassa sapuliraprttitiedstssa. Kukin sapuli vidaan siten raprtida samassa timituserässä vain kerran. Osapulen pakllisina tietina raprtitavat attribuutit vaihtelevat sapulen sijaintimaan ja rlin mukaan. Osapulen eri sijaintimaiden ja rlien pakllisina raprtitavat tiedt n kuvattu tarkemmin dkumentissa (BF AnaCredit requirements v2.6).
12 (27) Mikäli attribuuttia ei le määritelty sapulelle paklliseksi, n attribuutin raprtinti kuitenkin sallittua. Seuraavassa n kuvattu kaksi esimerkkiä raprtintivaatimuksista sumalaisille sapulille, jiden rli n velallinen. Sumalaisille velallisille, jille n myönnetty vähintään yksi lutt 1.9.2018 jälkeen, raprtitavien raprtintiattribuuttien pakllisuus (), kun raprtitavalla velallisella n jk 1) Y-tunnus tai 2) ei le kansallista Y-tunnusta tai LEI-tunnusta Elementin/attribuutin nimi Actin (attribute) CNTRPRTY_ID Cunterparty identifier LEI Legal Entity Identifier (LEI) ENTTY_ID_TYP Identifier type DSCRPTN_OTHR_ID Descriptin f Other identifier type ENTTY_NTNL_ID Natinal identifier INTRNTNL_ORG_ID Internatinal rganisatin identifier RIAD RIAD cde HD_OFFC_UNDRT_ID Head ffice undertaking ID IMMDT_PRNT_UNDRT_ID Immediate parent undertaking ID ULTMT_PRNT_UNDRT_ID Ultimate parent undertaking ID NM_ENTTY Name STRT Street CTY City/twn/village Käyttö 1) 2) Timint-attribuutin sallitut arvt: Replace - lisätään/muutetaan tietja Delete pistetaan tietja Tietjen muuttaminen ja pistaminen vaativat tietueen pakllisten tietjen raprtinnin. Osapulen yksilöivä tiednantajan käyttämä sisäinen tunnus ISO 17442 standardin mukainen kirjaimista ja numerista kstuva tunnus Tunnuksen tyyppi Kansallisen tunnuksen tekstimutinen kuvaus sillin, kun ENTTY_ID_TYP = Other identifier Kansallinen tunnus Kansainvälisen järjestön tunnus RIAD-kdi Yrityksen pääknttrin tunniste Välittömän emyrityksen tunniste Perimmäisen emyrityksen tunniste Nimi, krkeintaan 255 merkkiä pitkä Osite: katu, krkeintaan 255 merkkiä pitkä Osite: kaupunki/kunta/taajama, krkeintaan 255 merkkiä pitkä
13 (27) PSTL_CD Pstal cde CNTRY Cuntry LGL_FRM Legal frm INSTTTNL_SCTR Institutinal sectr ECNMC_ACTVTY Ecnmic activity LGL_PRCDNG_STTS Status f legal prceedings DT_INTTN_LGL_PRCDNGS Date f initiatin f legal prceeding ENTRPRS_SZ Enterprise size DT_ENTRPRS_SZ Date f enterprise size NMBR_EMPLYS Number f emplyees BLNC_SHT_TTL Balance sheet ttal ANNL_TRNVR Annual turnver ACCNTNG_FRMWRK_SL Accunting standard Osite: pstinumer, krkeintaan 255 merkkiä pitkä Osite: maa, krkeintaan 255 merkkiä pitkä Oikeudellinen mut Institutinaalinen sektri Timiala Oikeudellinen tilanne Oikeudellisen tilanteen muutksen vireillepanpäivämäärä Yrityksen kk Yrityksen kn päivämäärä Työntekijöiden lukumäärä Taseen lppusumma Vutuinen liikevaiht Kirjanpitstandardi 5.1.2 Kuukausiluttraprttitiedst Yksittäinen kuukausiluttraprttitiedst vi sisältää tietja ainastaan yhdestä tarkasteltavasta timijasta. Mikäli tiednantaja n velvllinen timittamaan tiedt useammasta kuin yhdestä tarkasteltavasta timijasta, tulee kukin tarkasteltava timija raprtida massa kuukausiluttraprttitiedstssa. Kuukausiluttraprttitiedst sisältää luvussa 5.1 kuvatut raprtin paklliset perustiedt, tiedt tarkasteltavaan timijaan liittyvistä lainainstrumenteista, lainainstrumentteihin liittyvistä sujauksista, lainan sapulten rleista ja situmuksista sekä sapulten riskitiedista. Kuukausilutttiedt raprtidaan kuudessa tietueessa. Tietueen paklliset raprtitavat tunnukset mudstavat tietueen yksilöivän avaintunnisteen. Tietue saa esiintyä timitustiedstssa samalla avaintunnisteen arvlla ainastaan kerran.
14 (27) 5.1.3 Neljännesvusiluttraprttitiedst Kuukausiluttraprtin tiedt kstuvat seuraavista tietueista: 1. Instrumentin perustiedt (InstrumentInfrmatinRecrds), jssa avaintunnisteena n spimustunnuksen ja siihen liittyvän instrumentin tunnuksen yhdistelmä (CNTRCT_ID, INSTRMNT_ID). 2. Instrumentin sapulet (CunterpartyInstrumentRecrds), jssa avaintunniste mudstuu spimustunnuksen, siihen liittyvän instrumentin tunnuksen sekä instrumentin sapulen tunnuksen ja rlin yhdistelmästä (CNTRCT_ID, INSTRMNT_ID, CNTRPRTY_ID, ENTTY_RL). 3. Sujauksen (PrtectinRecrds) perustiedt -tietueessa avaintunniste n sujauksen tunnus (PRTCTN_ID). 4. Instrumentin ja sujausten suhdetta (InstrumentPrtectinRecrds) raprtitaessa avaintunnisteena n spimuksen, instrumentin ja sujauksen tunnusten yhdistelmä (CNTRCT_ID, INSTRMNT_ID, PRTCTN_ID). 5. Sujauksen antajat (PrtectinPrviderRecrds) raprtidaan tietueessa, jssa avaintunnisteena n sujauksen tunnuksen ja sujauksen antaneen sapulen tunnuksen yhdistelmä (PRTCTN_ID, CNTRPRTY_ID). 6. Osapulen riski- ja maksukyvyttömyystiedissa (CunterPartyRiskAndDefaultRecrds) n avaintunnisteena sapulen tunnus (CNTRPRTY_ID). Yksityiskhtaiset kuvaukset raprtitavista tiedista löytyvät skeemasta AC_LanDataTypes1.8.sd. Yksittäinen neljännesvusiluttraprttitiedst vi sisältää tietja ainastaan yhdestä tarkasteltavasta timijasta. Mikäli tiednantaja n velvllinen timittamaan tiedt useammasta kuin yhdestä tarkasteltavasta timijasta, tulee kukin tarkasteltava timija raprtida massa neljännesvusiluttraprttitiedstssa. Neljännesvusiluttraprttitiedst sisältää luvussa 5.1 kuvatut raprtin paklliset perustiedt sekä tiedt tarkasteltavaan timijaan liittyvistä instrumenteista. Sama spimustunnuksen ja instrumenttitunnuksen
15 (27) 5.2 Raprtitavat arvt ja tarkkuus 5.3 XML-skeema ja sen versi 5.3.1 Timitus- ja raprttitiedstjen skeema (CNTRCT_ID, INSTRMNT_ID) yhdistelmä vi esiintyä raprtissa vain kerran. Määrityksissä kuvataan sluun liittyvä tiettyyppi, raja-arv sekä sisältövaatimukset, kuten käytetty kdilista ja vaadittu mut. Kussakin slussa raprtitavan arvn tarkkuus ilmenee skeematiedstista tai ecelmutisesta kuvauksesta (AC XSD Elements v1.8.ls). Mikäli raprtitava tietattribuutti ei le svellettavissa raprtitavalle khteelle tai se n raprtintihelptusten alainen (eikä tieta raprtida vapaaehtisesti), tulee kyseinen ml-elementti jättää kknaan raprtimatta. Tyhjien ml-elementtien raprtinti ei le sallittua. Pikkeuksena ei svellettavissa leviin arvihin vat kdilistaphjaiset tietattribuutit, jissa n eritelty Ei svellettavissa -arv. Tällöin kyseisessä tietattribuutissa tulee raprtida kdilistan mukainen arv. Kappaleessa n kuvattu timitus- ja raprttitiedstjen sekä palautetiedstjen skeemat. Jkaiseen XML-tiedstn tulee sisältyä käytetyn skeeman versinumer. Versin 1.8 AC-skeema kstuu kahdestatista erillisestä XSD-tiedststa. Näistä yhdeksän XSD-tiedsta kuvaa Sumen Pankille raprtitavien timitus- ja raprttitiedstjen skeeman: AC_Cdelists1.8.sd AC_CmmnDataTypes1.8.sd AC_CunterpartyBatchRecrd1.8.sd AC_CunterpartyDataTypes1.8.sd AC_DataTypes1.8.sd AC_Header1.8.sd AC_LanDataTypes1.8.sd AC_MnthlyBatchRecrd1.8.sd
16 (27) AC_QuarterlyBatchRecrd1.8.sd 5.3.2 Palautetiedstjen skeema Palautteet raprtiduista tiedista annetaan kahdessa sassa: tiednkeruupalvelun surittamien tarkistusten ja Sumen Pankin surittamien tarkistusten perusteella. Lisätieta palauteraprteista löytyy kappaleesta 8 Palauteraprtit. 5.3.2.1 Tiednkeruupalvelun surittamien tarkistusten palautetiedstjen skeema Klme XSD-tiedsta kuvaavat tiednkeruupalvelun surittamien tarkistusten perusteella timitettavan palautetiedstn skeeman:
17 (27) AC_DCS_FDBK1.8.sd AC_FDBK_CmmnDataTypes1.8.sd AC_CmmnDataTypes1.8.sd 5.3.2.2 Sumen Pankin surittamien tarkistusten palautetiedstjen skeema Klme XSD-tiedsta kuvaavat Sumen Pankin surittamien tarkistusten perusteella timitettavan palautetiedstn skeeman: AC_BOF_FDBK1.8.sd AC_FDBK_CmmnDataTypes1.8.sd AC_CmmnDataTypes1.8.sd 5.4 Suurten raprttitiedstjen pilkkminen Lähtökhta n, että tiednantajan taslla raprtitavat sapulitiedt raprtidaan yhdessä sapuliraprttitiedstssa ja tarkasteltavan timijan taslla raprtitavat lutttiedt raprtidaan kahdessa raprttitiedstssa (kuukausilutt- ja neljännesvusiluttraprttitiedstt). Yksittäisessä raprttitiedstssa levien tisteisten lapsielementtien (tietueiden) yhteenlaskettu lukumäärä saa lla krkeintaan 100 000 kpl. Lisäksi raprttitiedst ei saa ylittää 500 megatavun kka. Laskennassa humin tettavien lapsielementtien ja niiden äitielementtien nimet selviävät tiedstkhtaisesti seuraavasta tauluksta: Tiedsttyyppi Äitielementin nimi Lapsielementin eli tietueen nimi Osapulitiedt CunterpartyReference Recrds CunterpartyReference Recrd Rahitusmarkkina- ja tilastsast Kuukausilutttiedt InstrumentInfrmatin Recrds CunterpartyInstrument Recrds PrtectinRecrds InstrumentPrtectin Recrds PrtectinPrvider Recrds InstrumentInfrmatin Recrd CunterpartyInstrument Recrd PrtectinRecrd InstrumentPrtectin Recrd PrtectinPrvider Recrd
18 (27) Rahitusmarkkina- ja tilastsast Neljännesvusilutttiedt CunterpartyRiskAnd DefaultRecrds AccuntingRecrds CunterpartyRiskAnd DefaultRecrd AccuntingRecrd Mikäli samassa XML-raprttitiedstssa tisteisia lapsielementtejä n kaikista äitielementeistä yhteensä enemmän kuin 100 000 kpl, raprtinnissa tulee käyttää useampaa raprttitiedsta, jtta edellä määritelty raja-arv ei ylity. Pilkttujen raprttitiedstjen nimeäminen kuvataan tarkemmin kappaleessa 5.6 Tiedstjen nimeäminen. On lemassa vaihtehtisia tapja pilkka tisteiset elementit eri raprttitiedstihin, jttei raja-arv ylittyisi. Esimerkiksi, js kuukausitiedt sisältävä lutttietraprttitiedst pitää sisällään 60 000 PrtectinPrviderRecrd-elementtiä ja 50 000 PrtectinRecrd-elementtiä, n elementtien yhteismäärä yhteensä 110 000, ja sillin tiedst tulee pilkka useampaan tiedstn. Tässä esimerkkinä kaksi mahdllista vaihtehtista pilkkmistapaa, jtka eivät le ainita mahdllisia: 1) PrtectinPrviderRecrd-elementit vat massa tiedstssa, ja PrtectinRecrd-elementit tisessa tiedstssa. 2) Vaihtehtisesti PrtectinPrviderRecrd-elementit sekä 40 000 PrtectinRecrd-elementtiä sijitetaan ensimmäiseen tiedstn ja lput 10 000 PrtectinRecrd-elementtiä tiseen. Pilkkmisessa n humattava, että samat tarkistussäännöt, jtka kskevat yksittäistä raprttitiedsta, kskevat myös niiden pilkttujen tiedstjen kknaisuutta, jtka liittyvät jk yksittäisen tarkasteltavan timijan kuukausi- tai neljännesvusilutttietihin tai tiednantajan sapulitietihin. Raprtitavia tietja ei tule kuitenkaan pilkka siten, että esimerkiksi kukin lutt siihen liittyvine tietueineen raprtidaan massa raprttitiedstssaan. Lähtökhta pilkttujen raprttitiedstjen tapauksessa n, ettei tiednantajan taslla sapuliraprttitiedstjen tai
19 (27) 5.5 Raprttitiedstjen pakkaaminen 5.6 Tiedstjen nimeäminen 5.6.1 Timitustiedstn nimi tarkasteltavan timijan taslla kuukausi- tai neljännesvusiluttraprttitiedstjen keskimääräinen tietueiden määrä per raprttitiedst saisi alittaa 20 000 tietueen määrää. Timitustiedstn XML-tiedstt pakataan yhteen zip-pakettiin, jka sisältää yhden kuriraprtin ja n- kappaletta raprttitiedstja. Zip-tiedstt tulee pakata seuraavasti: Pakkauksen tas: nrmaali Pakkausmenetelmä: deflate Timitustiedstn ja kuriraprtin aikaleiman (EXTRACTEDTIME) eli piminnan ajanhetken tulee lla keskenään samja. Näiden edellä mainittujen aikaleimjen n ltava myös sama kuin myöhäisin timitustiedstn sisällä levien raprttitiedstjen tiedstnimissä levista (piminnan ajanhetken) aikaleimista. Timitustiedstn nimi n muta AC_[PERIOD] _[DATAPROVIDER]_[EXTRACTEDTIME].zip. Tässä [PERIOD] n muta vusi + M + kuukausi, esimerkiksi 2016M12. Peridin pituus n täsmälleen 7 merkkiä, kuukauden numern edessä käytetään tarvittaessa etunllaa. [DATAPROVIDER] n FI + raprtijan Y-tunnus ilman väliviivaa, kun kyseessä n sumalainen raprtija. Mikäli raprtija n ulkmainen y-tunnuksetn timija, määrittelee Sumen Pankki tiednantajalle erikseen käytettävän tunnuksen mudn. [EXTRACTEDTIME] eli piminnan ajanhetki n muta vusi + kuukausi + päivä + tunti + minuutti + sekunti (14 merkkiä, tarvittaessa etunllia käyttäen). Esimerkki: AC_2016M12_FI00000000_20170101120000.zip.
20 (27) 5.6.2 Kuriraprtin nimi Timitustiedstn (ZIP) sisällä kuriraprtin (Header) nimi n muta AC_[PERIOD]_Header_[DATAPROVIDER]_[EXTRACTEDTIME].ml. Tässä 5.6.3 Raprttitiedstjen nimet [PERIOD] n muta vusi + M + kuukausi, esimerkiksi 2016M12. Peridin pituus n täsmälleen 7 merkkiä, kuukauden numern edessä käytetään tarvittaessa etunllaa. [DATAPROVIDER] n FI + raprtijan Y-tunnus ilman väliviivaa, kun kyseessä n sumalainen raprtija. Mikäli raprtija n ulkmainen y-tunnuksetn timija, määrittelee Sumen Pankki tiednantajalle erikseen käytettävän tunnuksen mudn. [EXTRACTEDTIME] eli piminnan ajanhetki n muta vusi + kuukausi + päivä + tunti + minuutti + sekunti (14 merkkiä, tarvittaessa etunllia käyttäen). Esimerkki: AC_2016M12_Header_FI00000000_20170101120000.ml. Timitustiedstn (ZIP) sisällä raprtti- eli BatchRecrd-tiedstt vat jk tiednantajakhtaisia (Reprting Agent) tai tarkasteltava timija -khtaisia (Observed Agent). Osapuliraprttitiedstn nimi n muta AC_[PERIOD]_Cunterparty [REPAGENT]_[EXTRACTEDTIME]_[N].ml. Tässä [PERIOD] n muta vusi + kuukausi mudssa M+kk, esimerkiksi 2016M12. Peridin pituus n täsmälleen 7 merkkiä, kuukauden numern edessä käytetään tarvittaessa etunllaa. [REPAGENT] n FI+ tiednantajan Y-tunnus ilman väliviivaa [EXTRACTEDTIME] eli piminnan ajanhetki n muta vusi + kuukausi + päivä + tunti + minuutti + sekunti (14 merkkiä, tarvittaessa käyttäen etunllia) [N] n suurten raprttitiedstjen pilkkmisesta jhdettu jukseva numer (ks. tarkemmin kappale 5.4 Suurten raprttitiedstjen pilkkminen), pilktut tiedstt eravat ainastaan tämän juksevan numern salta. Pilkkmattmilla tiedstilla N=1.
21 (27) 5.7 Tekniset tarkistussäännöt Esimerkki: AC_2016M12_Cunterparty_FI00000000_20170101120000_1.ml. Lutttietraprttitiedstn (kuukausi- ja neljännesvusiraprttitiedstn) nimi n muta AC_[PERIOD]_ [X]_[OBSAGENT]_[EXTRACTEDTIME]_[N].ml. Tässä [PERIOD] n muta vusi + M + kuukausi, esimerkiksi 2016M12. Peridin pituus n täsmälleen 7 merkkiä, kuukauden numern edessä käytetään tarvittaessa etunllaa. [X] n jk MnthlyAC tai QuarterlyAC riippuen tiedstn sisällöstä. QuarterlyAC:n nimi vi kstua vain perideista M03, M06, M09, M12. [OBSAGENT] n FI + tarkasteltavan timijan Y-tunnus ilman väliviivaa, kun kyseessä n sumalainen tarkasteltava timija. Mikäli tarkasteltava timija n sumalaisen luttlaitksen ulkmailla timiva sivuliike, määrittelee Sumen Pankki tiednantajalle erikseen käytettävän tunnuksen mudn. [EXTRACTEDTIME] eli piminnan ajanhetki n muta vusi + kuukausi + päivä + tunti + minuutti + sekunti (14 merkkiä, tarvittaessa etunllia käyttäen). [N] n suurten raprttitiedstjen pilkkmisesta jhdettu jukseva numer alkaen numersta 1 (ks. tarkemmin kappale 5.4 Suurten raprttitiedstjen pilkkminen), pilktut tiedstt eravat ainastaan tämän juksevan numern salta. Pilkkmattmilla tiedstilla N=1. Esimerkkejä: AC_2016M12_MnthlyAC_FI00000000_20170101120000_1.ml. AC_2016M12_MnthlyAC_FI00000000_20170101120000_2.ml. AC_2016M12_QuarterlyAC_FI00000000_20170101120000_1.ml. Yksittäisessä timitustiedstssa samaan tarkasteltavaan timijaan khdistuvien pilkttujen raprttitiedstjen tiedstnimissä vain järjestysnumer saa erta, EXTRACTEDTIME-aikaleimjen tulee lla samja. Tässä kappaleessa kuvataan ensisijaisesti tekniset tarkistussäännöt.
22 (27) 5.7.1 Tiednkeruupalvelun surittamat tarkastukset (virhekdi suluissa) 5.7.1.1 Timitustiedstn khdistuvat tarkastukset 5.7.1.2 Kuriraprttiin khdistuvat tarkastukset Tiednkeruupalvelu surittaa teknisiä tarkistuksia timitustiedstlle (ZIP) ja sen sisältämälle kuriraprtille sekä raprttitiedstille ennen raprtin hyväksyntää ja siirtämistä eteenpäin Sumen Pankille. MUST Timitustiedstn nimi vastaa hjeistettua (101101). Timitustiedstn generintiaika vastaa hjeistettua (101102). Kuri- ja raprttitiedstissa käytettävän skeemaversin tulee lla Sumen Pankin määrittelemä tuettu skeemaversi raprtitavan peridin salta, ja sen tulee lla sama kaikilla kuri- ja raprttitiedstilla, jtka kuuluvat samaan timitustiedstn (101103). Timitustiedst n purettavissa (101201). Timitustiedstn ja kuriraprtin tiedstnimien tiedn timittajan tunnukset ja viitepäivämäärät vastaavat tisiaan (101314). Saman timitustiedstn periditiedt vastaavat tisiaan (101316). MUST Raprttitiedstn nimi vastaa hjeistettua (101313). Raprttitiedstn generintiaika vastaa hjeistettua (101310). Raprtitu vain 1 kuriraprtti samassa timitustiedstssa (101311). Kuriraprtin viitepäivämäärä tulee lla kuukauden viimeinen päivä (102130). Kuriraprtissa ilmitetut timitustiedstn kuuluvat raprttitiedstt vastaavat timitustiedstn sisältyviä raprttitiedstja (102131). Kuriraprtin skeemaversi n tuettu raprtintiperidilla (102132). Kuriraprtti n skeeman mukainen (102133).
23 (27) 5.7.1.3 Raprttitiedstihin khdistuvat tarkastukset MUST Mikään yksittäinen raprttitiedst ei saa ylittää 500 megatavun kka. Sääntö ei kske timitustiedsta (101317). Raprttitiedstn viitepäivämäärä n kuukauden viimeinen päivä (102240). Raprttitiedst n teknisesti luettava (102242). Raprttitiedstn skeemaversi n tuettu raprtintiperidilla (102243). Raprttitiedst n skeeman mukainen (102244). Raprttitiedsta ei saa lla määritelty testiaineistksi, mikäli kyseessä n tutantympäristössä tehtävä tiettimitus (103101). Neljännesvusiluttraprttitiedstn (QuarterlyAC) nimissä hyväksytään peridiksi M03, M06, M09 tai M12 (102244). Tiednantaja/Tarkasteltava timija kuuluu kyselyyn tarkasteluperidilla (105101). Neljännesvusiraprtija vi raprtida ainastaan perideilla M03, M06, M09 tai M12 (105201). 5.7.2 Sumen Pankin surittamat muut tekniset tarkistukset MUST Viitepäivämäärään khdistuva raprttitiedstjen kknaisuus sisältää aina täydellisen tilannekuvan lutttietraprtinnin tiedista. Mikäli raprttitiedsta täytyy pilkka, kaikki erilliset raprttitiedstt täytyy sisällyttää saman timituserän timitustiedstn. Raprttitiedstn yhteenlaskettu tietueiden määrä yksittäisessä raprttitiedstssa saa lla enintään 100 000 tietuetta. Tietueet vat elementtejä, jtka n kuvattu seuraavissa klmessa tarkistussäännössä. Osapuliraprttitiedstssa, tai siitä mudstetussa pilkttujen tiedstjen kknaisuudessa, tulee jkaisen CunterpartyReference Recrd-tietueen lla CNTRPTY_ID-avaimen mukaan yksilöitävissä.
24 (27) Tarkasteltavan timijan neljännesvusittaisessa raprtissa tai siitä mudstetussa pilkttujen tiedstjen kknaisuudessa, tulee jkaisen AccuntingRecrd-tietueen lla CNTRCT_ID-kentästä ja INSTRMNT_ID-kentästä mudstetun avaimen mukaan yksilöitävissä. Tarkasteltavan timijan kuukausittaisessa raprtissa, tai siitä mudstetussa pilkttujen tiedstjen kknaisuudessa, tulee jkaisen tietueen lla avaimen mukaan yksilöitävissä seuraavan taulukn mukaisesti. Tietueen nimi InstrumentInfrmatinRecrd CunterpartyInstrumentRecrd PrtectinRecrd InstrumentPrtectinRecrd PrtectinPrviderRecrd CunterpartyRiskAndDefaultRecrd Kentät, jtka mudstavat yksilöivän avaimen CNTRCT_ID INSTRMNT_ID CNTRCT_ID INSTRMNT_ID CNTRPRTY_ID ENTTY_RL PRTCTN_ID CNTRCT_ID INSTRMNT_ID PRTCTN_ID CNTRPRTY_ID PRTCTN_ID CNTRPRTY_ID 6 Tietjen timittaminen Sumen Pankille Sumen Pankki käyttää lutttietjen tiednvälitykseen Psti Messaging Oy:n ylläpitämää tiednkeruupalvelua. Raprtintivelvllinen vi asiida itse palvelussa tai valtuuttaa nimeämänsä raprtijan hitamaan tietjen timittamisen pulestaan. Aiemmista tiednkeruista piketen lutttietraprtinnista vastaavat ktimaiset yhteisöt tunnistautuvat vahvan sähköisen tunnistautumisen mukaisesti sumi.fi-tunnistus- ja valtuutuspalvelussa. Tarkemmat hjeet palveluun kirjautumisesta löytyvät testiraprtintipalvelun etusivulta sitteessa sitteessa. ja tutantraprtintipalvelun etusivulta
25 (27) Lutttietraprtintiin liittyvät tiedstt tulee mudstaa tämän dkumentin ja sen liitteiden tietuekuvausten mukaisesti. Liitteet: AC XSD v1.8.zip (skeematiedstt) AC XSD Elements v1.8.ls AC_2016M12_FI00000000_20170101120000.zip AC_2016M12_Header_FI00000000_20170101120000.ml AC_2016M12_Cunterparty_FI00000000_20170101120000_1.ml AC_2016M12_MnthlyAC_FI00000000_20170101120000_1.ml AC_2016M12_MnthlyAC_SE00000001_20170101120000_1.ml AC_2016M12_MnthlyAC_EE00000002_20170101120000_1.ml AC_2016M12_QuarterlyAC_FI00000000_20170101120000_1.ml AC_2016M12_QuarterlyAC_SE00000001_20170101120000_1.ml AC_2016M12_QuarterlyAC_EE00000002_20170101120000_1.ml AC Recrd Structure v1.8.ls Raprtija timittaa tiednkeruupalveluun lutttietraprttitiedstn. Tiednkeruupalvelu tarkistaa lähetetyn raprttitiedstn teknisen eheyden ja tietuemudn ikeellisuuden ja välittää eheäksi tdetun lutttietraprttitiedstn Sumen Pankille. Lutttietraprttitiedstssa tässä vaiheessa havaituista virheistä annetaan välitön autmaattinen palaute, jtta raprtija vi ryhtyä timenpiteisiin virheiden krjaamiseksi ja tiedstn lähettämiseksi uudelleen. Kuhunkin viitepäivämäärään khdistuva lähetys n kknaislähetys (tapahtumatyyppi SBMSSN_TYP n Full), jnka jälkeen vidaan lähettää uusi kknaislähetys (tapahtumatyyppi SBMSSN_TYP n Full). Uudessa kknaislähetyksessä pelkästään aiemmin raprtitujen tietjen muutkset eivät le mahdllisia, vaan uuden kknaislähetyksen tiedt jäävät sellaisinaan vimaan. Tiedstissa käytetään raprttien tietjen pimintahetken aikaleimaa sekä jissain tapauksissa järjestysnumera, jista päätellään tiedstjen keskinäinen aikajärjestys. Samannimisen tiedstn vi lähettää vain kerran. Uusi lähetys yksilöidään lähetyksen tietjen pimintahetken aikaleimalla. Pimintahetken aikaleima n ajanhetki, jllin tiedt n pimittu. Lähetykset tulee
26 (27) timittaa ajallisesti pimintahetken mukaisessa järjestyksessä DCS2- palveluun. Tisin sanen aikaisemman piminnan mukaan mudstettua lähetystä ei saa timittaa sen jälkeen, kun myöhäisemmän piminnan lähetys n timitettu. Myöhäisin viitepäivämäärään khdistuva kknaislähetys jää vimaan Mikäli tiedst n suuri, se tulee pilkka kappaleessa 5.4 kuvatun mukaisesti tiedstihin, jilla n eri järjestysnumer. 7 Raprtintitavat Raprtijalle n lutttietraprtintiin liittyvien tietjen raprtintia varten tarjlla kaksi raprtintitapaa: Tiedstn timittaminen tiedstlatauksena (https uplad) Sura, sujattu tietyhteys yrityksen ja tiednkeruupalvelun välillä (SFTP Secure File Transfer Prtcl). 7.1 Timittaminen tiedstlatauksena 7.2 SFTP-tiedstsiirt Raprtija timittaa valmiin timitustiedstn kirjautumalla tiednkeruupalveluun ja lähettämällä timitustiedstn palvelun kautta tiedstlatauksena (https uplad). Ohjeet palveluun kirjautumiseen löytyvät testiraprtintipalvelun etusivulta sitteessa. Tutantraprtintipalvelu sijaitsee sitteessa raprtija hakee tutantkäytön tunnukset., jnne SFTP (Secure File Transfer Prtcl) tarjaa suran, sujatun yhteyden lutttiedt sisältävien tiedstjen siirtn. Tämä tietjen siirttapa spii raprtijille, jtka timittavat isja raprttitiedstja tai haluavat autmatisida raprtintia. SFTP-tiednsiirta käytettäessä raprtija ja tiednkeruupalvelu mudstavat palvelun ja raprtijan välille SFTP-yhteyden, jta pitkin lutttietraprttitiedstn siirt suritetaan. Tiednkeruupalvelu antaa raprtijalle palvelun käyttöä varten ns. SFTP-tunnuksen (käyttäjätunnus ja salasana). SFTP-tunnuksen tilaamisen hjeet vat saatavilla
27 (27) rekisteröityneille käyttäjille testiraprtintipalvelussa ja tutantraprtintipalvelussa sitteessa. 8 Palauteraprtit Lutttietraprtintiin liittyy kahdenlaisia palauteraprtteja: tiednkeruupalvelun surittamien tarkistusten palaute Sumen Pankin surittamien tarkistusten palaute. Tässä kappaleessa n kuvattu tarkastusten sisältöä yleisellä taslla. 8.1 Tiednkeruupalvelun surittamien tarkistusten palaute Tiednkeruupalvelun surittamien teknisten tarkistusten lpputulema n jk timituserän hyväksyntä tai hylkäys, jista mlemmista palvelu mudstaa palauteraprtin palveluun raprtijan nudettavaksi. Hylätystä timituserästä löydetyistä virheistä mudstuu listaus ja myös se tallennetaan raprtijan nudettavaksi. Raprtintivelvllisuuden täyttämiseksi timituserä tulee lla hyväksytysti tarkastettu. 8.2 Sumen Pankin surittamien tarkistusten palaute Sumen Pankki surittaa hyväksytyille timituserille sekä teknisiä että raprtituun tietsisältöön liittyviä tarkistuksia. Sumen Pankin surittamat tarkistukset kuvataan erillisessä Lutttietraprtinnin sisältövalidinnit -dkumentissa. Tarkistusten perusteella timituserästä löydetyistä virheistä ja humautuksista mudstetaan listaus ja se timitetaan tiednkeruupalveluun raprtijan nudettavaksi.