JEN TIEDONKERUU (MATI) TIETUEMUOTO Versio 1.0.7 Voimassa: 1.1.2014- Raportoitavan periodin alkupäivämäärä Julkaistu : 22.10.2014 Käytössä: tietuemuodonmukaiset tarkitukset ovat käytössä 1.1.2015 jälkeen DCS-palvelussa
2 (43) Versiohistoria Versio Päivämäärä Voimassaolo Muutokset 1.0 28.5.2014 1.1.2014- Ensimmäinen versio tietuemuodosta 1.0.1 04.06.2014 1.1.2014- Muutettu MCC-koodin validointia: Ei tarkisteta koodilistaa vasten, vaan ainoastaan muototarkistus (4 merkkinen koodi) Korjattu kirjoitusvirheitä 1.0.2 12.6.2014 1.1.2014- Korjattu virhe: kenttä 9 siirretty MIK1 tietueesta MIK2 tietueeseen 1.0.3 25.6.2014 1.1.2014- Korjattu virhe: ASLA-taulu, kenttä 5. Koodi E040 poistettu validoinnista, muutettu validointi mahdollistamaan nollan raportoinnin kentässä 5. Lisätty validoinnit MATI.ALL.R1 ja MATI.ALL.R2 1.0.4 13.8.2014 1.1.2014- Lisätty uusi tietue TILI maksulaitoksille ja/tai sähköisen rahan liikkeelle laskijoille (Luottolaitokset raportoivat tileihin liittyvät tiedot RATI itedonkeruussa). Uudet lisätyt tiedot: Maksutilien lukumäärä, Sähköisen rahan tilien lukumäärä, Liikkeeseen laskettujen sähköisen rahan tallenteiden arvo. Lisätty MAKA tietueelle kenttä Päätteen/laitteen tarjoava maksupalveluntarjoaja (arvo kotimainen/ulkomainen) kentäksi 6. Tämä muutti kenttien numerointia. Lisätty KIPA tietueelle uusi kenttä Maksun toimeksiantotapa, joka saa arvon S (sähköinen) tai P (paperinen). Tämä muutti kent-
tien numerointia. Vastaava jaottelu poistettu 12: Maksun koodilistalta. Validoinneissa korjattu virheitä, viimeistelty järjestystä, yhdistetty validointeja ja kirjoitettu käsittelysääntöjä auki lähes kaikissa MUUTOIN alkuisissa validoinneissa. Lisätty esimerkkejä. Korjattu kirjoitusvirheitä. 1.0.5 1.9.2014 1.1.2014- Poistettu edellisessä versiossa lisätty KIPA:n kenttä Maksun toimeksianto tapa ja muutettu KIPAn koodilistaa. Uusi validointi MATI.MIK1.R2 1.0.6 16.10.2014 1.1.2014- Validointi MATI.MAKA.07.001 korjattu 1.0.7 22.10.2014 1.1.2014 Validointi MATI.KIPA.5. ja MATI.KIPA.6. korjattu muuttuneet koodit
4 (43) SISÄLLYSLUETTELO 1 JOHDANTO... 6 2 TIETOJEN VÄLITTÄMINEN SUOMEN PANKKIIN... 7 2.1 DCS-palvelu... 7 2.2 Testaus... 8 2.3 Ongelmatilanteet... 8 3 RAPORTTITIEDOSTO... 9 3.1 Tiedoston nimeäminen... 9 3.2 Tiedoston rakenne... 10 3.3 Tiedoston validointi... 11 4 TIETUEKUVAUKSET... 12 4.1 Erätietue... 14 4.1.1 Tietueen kentät ja validoinnit... 14 4.1.2 Esimerkkejä... 16 4.2 Sisältötietue TILI... 17 4.2.1 Tietueen kentät... 17 4.2.2 Esimerkkejä... 18 4.3 Sisältötietue MATO... 19 4.3.1 Tietueen kentät... 19 4.3.2 Esimerkkejä... 20 4.4 Sisältötietue LAMP... 21 4.4.1 Tietueen kentät... 21 4.4.2 Esimerkkejä... 22 4.5 Sisältötietue MIK1... 23
5 (43) 4.5.1 Tietueen kentät... 23 4.5.2 Esimerkkejä... 25 4.6 Sisältötietue MIK2... 26 4.6.1 Tietueen kentät... 26 4.6.2 Esimerkkejä... 29 4.7 Sisältötietue MAKA... 30 4.7.1 Tietueen kentät... 30 4.7.2 Esimerkkejä... 33 4.8 Sisältötietue ASLA... 34 4.8.1 Tietueen kentät... 34 4.8.2 Esimerkkejä... 36 4.9 Sisältötietue KIPA... 37 4.9.1 Tietueen kentät... 37 4.9.2 Esimerkkejä... 38 4.10 Raporttitason validointisäännöt... 39 4.10.1 Yleiset... 39 4.10.2 TILI-tietue... 39 4.10.3 MATO tietueet... 40 4.10.4 LAMP tietueet... 40 4.10.5 MIK1 tietueet... 40 4.10.6 MIK2 tietueet... 41 4.10.7 MAKA tietueet... 41 4.10.8 ASLA tietueet... 42 4.10.9 KIPA tietueet... 42
6 (43) 1 JOHDANTO Tässä dokumentissa kuvataan maksuliiketilasto tiedonkeruun (MATI) tietuerakenteet ja validoinnit (tarkistukset). Sisällön ohjeistus on kuvattu dokumentissa Sisältöohje maksuliiketilaston raportointia varten. Suomen Pankki kerää maksupalveluntarjoajilta tilastotietoja, joita tarvitaan Euroopan keskuspankkijärjestelmän (EKPJ) tehtävien hoitamiseen, tilastovaatimusten täyttämiseen ja kansallisiin tarpeisiin. Tietuerakenteita ja tietojen välittämistä koskevissa asioissa voi ottaa yhteyttä Suomen Pankkiin osoitteen paystat@bof.fi kautta.
Tietojen välittäminen 7 (43) 2 TIETOJEN VÄLITTÄMINEN SUOMEN PANKKIIN MATI-raportti tulee toimittaa sähköisesti DCS-palvelun kautta Suomen Pankille vuosittain helmikuun loppuun mennessä. 2.1 DCS-palvelu Tietojen välittämiseen raportoijalta Suomen Pankille käytetään DCS-palvelua (Data Collection Service). DCS-palvelua ylläpitää palveluntarjoaja, eli DCS-operaattori. DCS-operaattorina toimii OpusCapita Oy. Ensimmäiseksi raportoijan (tai vaihtoehtoisesti tiedon toimittajan) tulee tilata käyttäjätunnus DCS-palveluun internetissä toimivan tunnustilauspalvelun avulla (https://sol.itella.net/ec/bof-tunnustilaus). Tunnustilauksen hyväksymisen jälkeen raportoijalle lähetetään postitse avainlukulista, jota tarvitaan sisäänkirjautuessa DCS-palveluun käyttäjätunnuksen ja salasanan lisäksi. Tiedonsiirtoa varten on olennaisinta, että raporttitiedosto muodostetaan tämän dokumentin esittämän tietuekuvauksen mukaisesti. DCS-palvelussa tiedosto validoidaan eli tiedoston sisällöstä tarkistetaan mm. tiedoston tekninen eheys, tietueiden kenttien muodot sekä sisällön oikeellisuus. Vain tarkistuksen läpäisseet raporttitiedostot välitetään eteenpäin Suomen Pankkiin. Tarkistukset tehdään tässä dokumentissa määritellyillä tavoilla. DCS-operaattorin kanssa toimiminen ohjeistetaan tarkemmin erikseen Suomen Pankin verkkosivuilla: http://www.suomenpankki.fi/fi/tilastot/raportointiohjeet/pages/maksuliiketilastot.aspx
Tietojen välittäminen 8 (43) 2.2 Testaus Raportointia voi testata merkitsemällä raportin aineiston testidataksi (ks. erätietueen kenttä 7 Tiedon ). Tiedon tyypin avulla valitaan, välitetäänkö testiaineisto Suomen Pankkiin vai tehdäänkö sille ainoastaan validointi. Tiedonkeruiden uudistusten yhteydessä testausohjeet annetaan erikseen. 2.3 Ongelmatilanteet DCS-operaattori tarjoaa osana DCS-palvelua OpusCapita Service Desk -palvelun, joka toimii 24 tuntia vuorokaudessa 7 päivänä viikossa (24/7). Service Deskiin voi olla yhteydessä puhelimitse 020 452 9348 tai sähköpostitse information.fi@opuscapita.com. Service Desk auttaa seuraavissa asioissa: - DCS-palvelun toimintaan liittyvät ongelmat - käyttäjätunnuksiin, salasanoihin ja avainlukulistoihin liittyvät asiat - tietoyhteysasiat (VPN-suojattu FTP tai SFTP) Raporttitiedoston sisällöllisissä ongelmissa ja muissa asioissa tulee olla yhteydessä Suomen Pankkiin sähköpostitse paystat@bof.fi.
Raporttitiedosto 9 (43) 3 RAPORTTITIEDOSTO Raporttitiedostot muodostetaan CSV (Comma Separated Value) tiedostona käyttäen erottimena puolipistettä. Tiedostossa käytettävän merkistön tulee olla ISO-Latin-1 (koodinimeltään ISO 8859-1). Luvuissa ei käytetä desimaaleja, vaan raportoidaan kokonaislukuja. Euromääräiset kentät raportoidaan euron tarkkuudella. Raporttitiedostoa tulee säilyttää 5 vuotta. 3.1 Tiedoston nimeäminen Tiedoston nimessä annetaan kyselyn yksilöivä tunnus "MATI", tieto siitä miltä ajanjaksolta tietoja raportoidaan ja raportoivan yhtiön Y-tunnus ilman väliviivaa kahdeksalla numerolla. Mikäli tiedon toimittaja lähettää uuden raportin korjatakseen lähettämiään tietoja, käytetään aina samaa tiedoston nimeä. MATI_<VVVV>_<Raportoijan Y-tunnus>.CSV. Esimerkki: Vuoden 2014 MATI raportti: MATI_2014_01234562.CSV
Raporttitiedosto 10 (43) 3.2 Tiedoston rakenne Tiedosto sisältää yhden erätietueen ja vaihtelevan lukumäärän sisältötietueita. Tiedoston ensimmäinen tietue on aina erätietue. Muiden tietueiden järjestyksellä ei ole merkitystä. Sisältötietueita on seitsemää eri ä. Taululla neljä on kaksi eri sisältötietuetta, muilla tauluilla yksi. Sisältötietueen pakollisiksi merkatut kentät ovat pakollisia, jos kyseinen sisältötietue löytyy raportista. Mikäli tiedosto sisältää usean yhtiön tietoja (esimerkiksi tytäryhtiön lukuja emoyhtiön lisäksi tai kokonaisen pankkiryhmän tiedot yhteensä), on tästä mainittava lisätieto -kentässä. Raportoitavat erät tunnistetaan rivin alussa ilmoitettavien tietuetunnusten perusteella. Seuraavissa taulukoissa on esitetty eri tietuetyypit, niiden tunnukset ja mitä tietuetunnusta käytetään kunkin taulun raportoimiseen. Tietue Tietuetunnus (ensimmäinen kenttä) Käyttö Rivien määrä Tekninen erätietue 000 Tiedoston aloittava tekninen tietue 1 Sisältötietue TILI Taulu1: Maksutilit 0 tai 1 Sisältötietue MATO Taulu 2: Maksukortit toiminnoittain 0 15 Sisältötietue LAMP Taulu 3: Päätelaitteet 0 N Sisältötietue MIK1 Taulu 4, osa 1: Maksuinstrumenttien käytön indikaattoreita 0 N Sisältötietue MIK2 Taulu 4, osa 2: Maksuinstrumenttien käytön indikaattoreita 0 N Sisältötietue MAKA Taulu 5: Maksupäätteiden käytön indikaattoreita 0 N Sisältötietue ASLA Taulu 6: Asiakassovellukset ja sähköinen laskutus 0 19 Sisältötietue KIPA Taulu 7: Kirjeenvaihtajapankkimaksut 0 N
Raporttitiedosto 11 (43) 3.3 Tiedoston validointi DCS operaattori validoi (tarkistaa) raporttitiedoston oikeellisuuden. Validointia suoritetaan niin tiedosto-, tietue- kuin kenttätasolla. Tässä dokumentissa esitetään raportoitaviin tietoihin liittyvät tekniset validointisäännöt, joiden toteutumisen DCSpalveluntarjoaja varmistaa. Hyväksytysti validoitu raporttitiedosto välitetään Suomen Pankille. Virheellistä raporttia ei välitetä Suomen Pankkiin, vaan DCS-palvelu antaa virheilmoituksen tiedon toimittajalle. Virheet on korjattava, ja koko raportti on lähetettävä uudelleen. Vastaavasti jos halutaan korjata jo lähetettyä raporttia, on koko raportti lähetettävä uudelleen DCS-palvelun kautta. Tämän lisäksi Suomen Pankki suorittaa DCS operaattorin välittämille teknisesti validoidulle raporteille sisällöllisiä tarkistuksia, ja voi tarvittaessa pyytää korjausraporttia).
Tietueiden yleiset säännöt 12 (43) 4 TIETUEKUVAUKSET Tietueisiin pätevät seuraavat yleiset säännöt: - Kentät erotetaan toisistaan puolipisteellä (Semicolon, ascii-merkki 59). Rivin viimeisen kentän jälkeen ei tule puolipistettä. - Tietueiden kentän sisältö ei saa sisältää lainausmerkkejä, CR- (Carriage Return) tai LF- (Line Feed) merkkejä. Tiedoston viimeiselle riville lisätään myös rivinvaihto (CR-LF merkkipari). - Tietueet erotetaan toisistaan rivinvaihdolla (CR-LF merkkiparilla). - Alfanumeeriset kentät rajataan lainausmerkeillä. Lainausmerkkejä ei lasketa mukaan kentän ilmoitettuun pituuteen. Muoto Number(x[,y]) Char(x) Varchar(x) Käyttö Ilmaisee numeerista tietoa. Kentän maksimipituus ilmoitetaan suluissa. Mahdollisten desimaalien määrä ilmoitetaan pilkulla erotettuna. Desimaalipilkkua ja sen jälkeisiä lukuja ei ole pakko raportoida mikäli pilkun jälkeiset luvut ovat nollia. Esim. Muoto Number(18,2) kertoo että kentässä voidaan antaa korkeintaan 18 merkkiä, joista 16 on kokonaisosaa ja 2 desimaaliosaa. Ilmaisee vakiomittaista alfanumeerista tietoa. Kentän pituus ilmoitetaan suluissa. Kentän arvon on oltava joko tyhjä tai ilmoitetun pituinen. Ilmaisee vaihtuvan mittaista alfanumeerista tietoa. Kentän maksimipituus ilmoitetaan suluissa.
Tietueiden yleiset säännöt 13 (43) Numeerisissa kentissä arvo nolla on hyväksyttävä pakollinen tieto, ellei kentässä ole erillistä validointisääntöä, joka edellyttää nollasta eroavaa lukua. Mikäli alfanumeeriseen kenttään ei tule arvoa, voidaan kenttä jättää kokonaan täyttämättä ilman että siihen muodostetaan lainausmerkkiparia. Mikäli tietueen viimeisiin kenttiin ei tule tietoja, voidaan tietueen loppuun muodostuvat puolipisteet jättää merkitsemättä.
Erätietue 14 (43) 4.1 Erätietue Raportti sisältää aina yhden erätietueen ja se on tiedoston ensimmäinen tietue. Erätietue sisältää raportin yleistiedot. Tietueen kenttien on täytettävä kentän oikean tyypin ja koon lisäksi seuraavat ehdot. 4.1.1 Tietueen kentät ja validoinnit Järj. Kenttä Koodilista Muoto Sääntö Vasen puoli Operaattori Oikea puoli 1 Tietueen 1: Tietueen Char(3) 001 Kentän 1 arvo "000" 2 Tiedon toimittajan tunnuksen 2: Tunnuksen Char(1) 001 Kentän 2 arvo 3 Tiedon toimittajan tunnus Yhtiön Y-tunnus muodossa NNNNNNNN ilman väliviivaa. Varchar(20) 001 Kentän 2 arvo Kentän 3 arvo JOS kentän 2 arvo on Y, NIIN kentän 3 arvo Koodilista 2: Tunnuksen Validi Y-tunnus <NNNNNNNN> 4 Raportoijan tunnuksen 2: Tunnuksen Char(1) 001 Kentän 4 arvo 5 Raportoijan tunnus Raportoitavan yhtiön Y-tunnus muodossa NNNNNNNN ilman väliviivaa. Varchar(20) 001 Kentän 5 arvo on muotoa JOS kentän 4 arvo on Y, NIIN kentän 5 Validi Y-tunnus <NNNNNNNN>
Erätietue 15 (43) arvo 6 Raportoijan nimi Varchar(100) 001 Kentän 6 arvo 7 Kyselytunnus Varchar(5) 001 Kentän 7 arvo "MATI" 8 Tiedon N Testitiedosto, ei välitetä Suomen Pankkiin T Testitiedosto, välitetään Suomen Pankkiin P Tuotantodataa 9 Raportin ajankohta Vuosi, jonka tietoja raportoidaan. 3: Tiedon Char(1) 001 Char(4) 001 Kentän 8 arvo Kentän 8 arvo Kentän 9 arvo Kentän 9 arvo on muotoa Koodilista 3: Tiedon <VVVV> 10 Raportin muodostamisajankohta Char(12) 001 003 Kentän 9 arvo Kentän 10 arvo Osa tiedostonimestä MATI_<VVVV>_<Raportoijan Y- tunnus>.csv pakollinen 11 Rivien määrä Tiedostossa olevien rivien määrä mukaan lukien erätietue. Number(10) 001 Kentän 10 arvo Kentän 11 arvo Kentän 11 arvo on muotoa <VVVV><KK><PP><TT><MM> Tiedoston rivien lukumäärä 12 Raportoijan kommentti Varchar(500)
Erätietue 16 (43) 4.1.2 Esimerkkejä Esimerkin erätietueessa ilmoitetaan, että kyseisessä tiedostossa on testiraportti, jolla on 122 riviä. Raportin oikeellisuus validoidaan DCS-palvelussa, mutta koska tiedon on N, tiedostoa ei välitetä Suomen Pankkiin. "000";"Y";"12345671"; Y ; 22345671 ; Tiedon toimittajan nimi ;"MATI";"N";"2014";"201505051234";122; Testiraportti Esimerkin erätietueessa ilmoitetaan, että raportissa on tuotantodataa 1523 riviä vuolta 2014. "000";"Y";"12345671"; Y ; 22345671 ; Tiedon toimittajan nimi ;"MATI";"P";"2014";"201503051234";1523
MATO-tietue (taulu 2) 17 (43) 4.2 Sisältötietue TILI 4.2.1 Tietueen kentät Tietueen on täytettävä kentän oikean tyypin, koon sekä muoto- ja pakollisuussääntöjen lisäksi seuraavat ehdot. Mikäli kentälle on ilmoitettu koodilista, tulee arvon löytyä koodilistalta. Jos TILI tietuetta raportoidaan, tietueen kaikki kentät ovat pakollisia. Sisältötietueella TILI maksulaitokset ja/tai sähköisen rahan liikkeeseenlaskijat raportoivat asetuksen taulun 1 tilitietoja (HUOM! Luottolaitokset raportoivat vastaavat tiedot RATI-tiedonkeruussa). Raportti sisältää aina maksimissaan yhden TILItietueen. Ryhmä Järj. Kenttä Koodilista Muoto Sääntö Vasen puoli Operaattori Oikea puoli Tietueen Tietueen 1: Tietueen Varchar(4) 001 Kentän 1 arvo "TILI" 1 TILI Maksutilit Raportoijan tiedot Raportoijan tunnuksen Char(1) 001 Kentän 2 arvo 2 2: Tunnuksen Kentän 2 arvo Koodilista 2: Tunnuksen 3 4 Raportoijan tunnus Yhtiön Y-tunnus muodossa NNNNNNNN ilman väliviivaa. Varchar(20) 001 Kentän 3 arvo JOS kentän 2 arvo on Y, NIIN kentän 3 arvo Validi Y-tunnus <NNNNNNNN> Maksutilien lukumäärä Number(12) 00 Kentän 4 arvo ja > 0
MATO-tietue (taulu 2) 18 (43) 5 Sähköisen rahan tilien määrä Number(12) 001 Kentän 5 arvo ja > 0 Liikkeeseen lasketun sähköisen Number 001 Kentän 6 arvo ja > 0 6 rahan tallenteiden arvo (12) 4.2.2 Esimerkkejä TILI esimerkki 1 Maksutilien lukumäärä 500 kpl, Sähköisen rahan tilien määrä 50 kpl, Liikkeeseen lasketun sähköisen rahan tallenteiden arvo 5555 euroa. TILI ; Y ; 12345671 ;500;50;5555
MATO-tietue (taulu 2) 19 (43) 4.3 Sisältötietue MATO Sisältötietueella MATO raportoidaan taulun 2 tiedot Suomessa liikkeeseen lasketuista korteista. 4.3.1 Tietueen kentät Tietueen on täytettävä kentän oikean tyypin, koon sekä muoto- ja pakollisuussääntöjen lisäksi seuraavat ehdot. Mikäli kentälle on ilmoitettu koodilista, tulee arvon löytyä koodilistalta. Jos MATO tietuetta raportoidaan, tietueen kaikki kentät ovat pakollisia. Ryhmä Järj. Kenttä Koodilista Muoto Sääntö Vasen puoli Operaattori Oikea puoli Tietueen 1 Tietueen MATO Maksukortit toimin- 1: Tietueen Varchar(4) 001 Kentän 1 arvo "MATO" Raportoijan tiedot 2 noittain Raportoijan tunnuksen 2: Tunnuksen Char(1) 001 Kentän 2 arvo Kentän 2 arvo Koodilista 2: Tunnuksen Tiedon luokittelut 3 4 Raportoijan tunnus Yhtiön Y-tunnus muodossa NNNNNNNN ilman väliviivaa. Kortin 4: Kortin Varchar(20) 001 Kentän 3 arvo JOS kentän 2 arvo on Y, NIIN kentän 3 arvo Validi Y-tunnus <NNNNNNNN> Varchar(5) 001 Kentän 4 arvo
MATO-tietue (taulu 2) 20 (43) Kentän 4 arvo koodilista 4: Kortin Arvo 5 Korttien lukumäärä Number(12) 001 Kentän 5 arvo ja >0 4.3.2 Esimerkkejä MATO esimerkki 1 Käteistoiminnolla varustettujen, Suomessa liikkeeseen laskettujen korttien lukumäärä 23100 kpl. MATO ; Y ; 12345671 ; A0211 ;23100
LAMP-tietue (taulu 3) 21 (43) 4.4 Sisältötietue LAMP Sisältötietueella LAMP raportoidaan taulukon 3 tiedot maksupalveluntarjoajien tarjoamista laitteista ja maksupäätteistä. 4.4.1 Tietueen kentät Tietueen on täytettävä kentän oikean tyypin, koon sekä muoto- ja pakollisuussääntöjen lisäksi seuraavat ehdot. Mikäli kentälle on ilmoitettu koodilista, tulee arvon löytyä koodilistalta. Jos LAMP tietuetta raportoidaan, tietueen kaikki kentät ovat pakollisia. Ryhmä Järj. Kenttä Koodilista Muoto Sääntö Vasen puoli Operaattori Oikea puoli Tietueen 1 Tietueen LAMP Laitteet ja maksupäät- 1: Tietueen Varchar(4) 001 Kentän 1 arvo "LAMP" Raportoijan tiedot 2 teet Raportoijan tunnuksen 2: Tunnuksen Char(1) 001 Kentän 2 arvo Kentän 2 arvo Koodilista 2: Tunnuksen 3 Raportoijan tunnus Yhtiön Y-tunnus muodossa NNNNNNNN ilman väliviivaa. Varchar(20) 001 Kentän 3 arvo JOS kentän 2 arvo on Y, NIIN kentän 3 arvo Validi Y-tunnus <NNNNNNNN>
LAMP-tietue (taulu 3) 22 (43) Tiedon luokittelu 4 Päätelaitteen 5: Päätelaitteen Varchar(3) 001 Kentän 4 arvo Kentän 4 arvo Koodilista 5:Päätelaitteen Arvo 5 6 Päätelaitteen sijainti Päätelaitteen sijaintimaa ISO 3166- luokituksen mukaan. 6. Maa (ISO 3166) Char(2) 001 Kentän 5 arvo Kentän 5 arvo Koodilista 6 :Maa ISO (3166) Laitteiden lukumäärä Number(12) 001 Kentän 6 arvo ja >0 4.4.2 Esimerkkejä LAMP esimerkki 1 Tilisiirtotoiminnolla varustettujen, Suomessa sijaitsevien automaattien lukumäärä 150 kpl. LAMP ; Y ; 12345678 ; B03 ; FI ;150
MIK1-tietue (taulu 4) 23 (43) 4.5 Sisältötietue MIK1 Maksuinstrumenttien käytön indikaattorit (taulu 4) on jaettu kahteen erilaiseen tietueeseen. Sisältötietueella MIK 1 raportoidaan tilisiirrot ja suoraveloitukset ja tietueella MIK2 loput 4. taulun tiedot. 4.5.1 Tietueen kentät Tietueen on täytettävä kentän oikean tyypin, koon sekä muoto- ja pakollisuussääntöjen lisäksi seuraavat ehdot. Mikäli kentälle on ilmoitettu koodilista, tulee arvon löytyä koodilistalta. Ryhmä Järj. Kenttä Koodilista Muoto Sääntö Vasen puoli Operaattori Oikea puoli Tietueen 1 Tietueen MIK1 Maksuinstrumenttien 1: Tietueen Varchar(4) 001 Kentän 1 arvo "MIK1" Raportoijan tiedot 2 käytön indikaattoreita 1 Raportoijan tunnuksen 2: Tunnuksen Char(1) 001 Kentän 2 arvo Kentän 2 arvo Koodilista 2: Tunnuksen Tiedon luokittelu 3 4 Raportoijan tunnus Yhtiön Y-tunnus muodossa NNNNNNNN ilman väliviivaa. Maksuinstrumentin 1 7: Maksu instru- Varchar(20) 001 Kentän 3 arvo JOS kentän 2 arvo on Y, NIIN kentän 3 arvo Validi Y-tunnus <NNNNNNNN> Varchar(5) 001 Kentän 4 arvo
MIK1-tietue (taulu 4) 24 (43) 5 Maa Maksutapahtuman vastapuolen sijaintimaa ISO 3166-luokituksen mukaan. mentin 1 6: Maa (ISO 3166) Kentän 4 arvo Char(2) 001 Kentän 5 arvo JOS kentän 4 arvo on <> C0411 (eräsiirrot,toistuvat) TAI C0500 (lähetetty pikasiirto) TAI C0600 (ulkomailta vastaanotettu tilisiirto) TAI C1100 (ulkomailta vastaanotettu suoraveloituspyyntö) NIIN kentän 5 arvo Koodilista 7: Maksuinstrumentin 1 koodilista 6:Maa (ISO 3166) 003 JOS kentän 4 arvo on C0411 (eräsiirrot,toistuvat) TAI C0500 (lähetetty pikasiirto) TAI C0600 (ulkomailta vastaanotettu tilisiirto) TAI C1100 (ulkomailta vastaanotettu suoraveloituspyyntö) NIIN kentän 5 arvo null 6 Vastapuoli S ryhmän sisäinen V eri rymien välinen/ toiseen pankkiryhmään Char(1) 001 Kentän 6 arvo Kentän 6 arvo S, V 003 JOS kentän 4 arvo on C0500 (lähe- V
MIK1-tietue (taulu 4) 25 (43) Arvo 7 8 tetty pikasiirto) TAI C0600 (ulkomailta vastaanotettu tilisiirto) TAI C1100 (ulkomailta vastaanotettu suoraveloituspyyntö) NIIN kentän 6 arvo Tapahtumien lukumäärä Number(12) 001 Kentän 7 arvo ja > 0 Tapahtumien arvo Number(12) 001 Kentän 8 arvo ja > 0 4.5.2 Esimerkkejä MIK1 esimerkki 1 Lähetetyt SEPA-tilisiirrot, Suomi, eri ryhmien välinen, tapahtumia 150 kpl, tapahtumien arvo 20 000. MIK1 ; Y ; 12345678 ; C0420 ; FI ; V ;150;20000 MIK1 esimerkki 2 Ulkomailta vastaanotettu tilisiirto, eri ryhmien välinen, tapahtumia 150 kpl, tapahtumien arvo 20 000. (tietoa ei raportoida maittain, vaan aggregoituna, joten maakoodi jätetään tyhjäksi) MIK1 ; Y ; 12345678 ; C0600 ;; V ;150;20000
MIK2-tietue (taulu 4) 26 (43) 4.6 Sisältötietue MIK2 Maksuinstrumenttien käytön indikaattorit (taulu 4) on jaettu kahteen erilaiseen tietueeseen. Sisältötietueella MIK 1 raportoidaan tilisiirrot ja suoraveloitukset ja tietueella MIK2 loput 4. taulun tiedot. 4.6.1 Tietueen kentät Tietueen on täytettävä kentän oikean tyypin, koon sekä muoto- ja pakollisuussääntöjen lisäksi seuraavat ehdot. Mikäli kentälle on ilmoitettu koodilista, tulee arvon löytyä koodilistalta. Ryhmä Järj. Kenttä Koodilista Muoto Sääntö Vasen puoli Operaattori Oikea puoli Tietueen 1 Tietueen MIK2 Maksuinstrumenttien 1: Tietueen Varchar(4) 001 Kentän 1 arvo "MIK2" Raportoijan tiedot 2 käytön indikaattoreita 2 Raportoijan tunnuksen 2: Tunnuksen Char(1) 001 Kentän 2 arvo Kentän 2 arvo Koodilista 2: Tunnuksen 3 Raportoijan tunnus Yhtiön Y-tunnus muodossa NNNNNNNN ilman väliviivaa. Varchar(20) 001 Kentän 3 arvo JOS kentän 2 arvo on Y, NIIN kentän 3 arvo Validi Y-tunnus <NNNNNNNN>
MIK2-tietue (taulu 4) 27 (43) Tiedon luokittelu 4 5 Maksuinstrumentin 2 Maa Maksutapahtuman vastapuolen sijaintimaa ISO 3166-luokituksen mukaan. 8: Maksuinstrumentin 2 6: Maa (ISO 3166) Char(5) 001 Char(2) 001 Kentän 4 arvo Kentän 4 arvo Kentän 5 arvo JOS kentän 4 arvo <> C2100 (sähköisen rahan tapahtuma ulkomailta)tai C2300 (ulkomailla lunastetut sekit) TAI C2500 (muut maksuinstrumentit ulkomailta) TAI C2600 (tilihyvitykset tilikirjauksella) TAI 2700 (tiliveloitukset tilikirjauksella) TAI C2900 (ulkomailta saapuvat maksumääräykset) tai C3000 (tietoliikenne ym. lähetetyt tapahtumat) tai C3100 (tietoliikenne ym. vastaanotetut tapahtumat) NIIN Kentän 5 arvo koodilista 8: Maksuinstrumentin 2 koodilista 6:Maa (ISO 3166) 003 JOS kentän 4 arvo on C2100 (sähköisen rahan tapahtuma ulkomailta)tai C2300 (ulkomailla lunastetut sekit) TAI C2500 (muut maksuinstrumentit ulkomailta) TAI C2600 (tilihyvitykset tilikirjauksella) TAI 2700 (tiliveloitukset tilikirjauksella) TAI C2900 (ulkomailta saapu- null
MIK2-tietue (taulu 4) 28 (43) vat maksumääräykset) tai C3000 (tietoliikenne ym. lähetetyt tapahtumat) tai C3100 (tietoliikenne ym. vastaanotetut tapahtumat) NIIN Kentän 5 arvo 6 Kortin käyttötapa N Kontaktiton maksupääte (NFC) P Kontaktillinen maksupääte R Etämaksuna (CNP) 14. Kortin käyttötapa Char(1) 001 Kentän 6 arvo JOS Kentän 4 arvo (Maksuinstrumentin ) on korttimaksu, eli koodi on C1210 TAI C1220 TAI C1300 TAI C1400 TAI C1500 TAI C1600 NIIN kentän 6 arvo koodilista 14: Kortin käyttötapa 003 JOS Kentän 4 arvo (Maksuinstrumentin null ) on <> C1210 TAI C1220 TAI C1300 TAI C1400 TAI C1500 TAI C1600 NIIN kentän 6 arvo Arvo 7 Tapahtumien lukumäärä Number(12) 001 Kentän 7 arvo ja > 0 8 Tapahtumien arvo Number(12) 001 Kentän 8 arvo ja > 0 Maksuinstrumentin kuvaus Varchar 001 pakollinen Palvelun nimi ja lyhyt kuvaus (200) 9 JOS kentän 4 arvo on C2400 (lähetetyt muut maksuinstrumentit) TAI C2500 (ulkomailta vastaanotetut muut maksuinstrumentit) NIIN kentän 9 arvo JOS kentän 4 arvo on <> C2400 (lähetetyt muut maksuinstrumentit) null
MIK2-tietue (taulu 4) 29 (43) TAI C2500 (ulkomailta vastaanotetut muut maksuinstrumentit) NIIN kentän 9 arvo 4.6.2 Esimerkkejä MIK2 esimerkki 1 Maksut korteilla joissa on luottotoiminto, Saksassa, myyntipisteen maksupäätteellä (kontaktillinen), tapahtumien lukumäärä 205 kpl, tapahtumien arvo 350 000. MIK2 ; Y ; 12345678 ; C1400 ; DE ; P ;205;350000 MIK2 esimerkki 2 Ulkomailta vastaanotetut muut maksuinstrumentit, tapahtumien lukumäärä 10 kpl, tapahtumien arvo 7000. (Maa koodin kenttä ja kortin käyttötapa kenttä jätetään tyhjiksi) MIK2 ; Y ; 12345678 ; C2500 ;;;10;7000; Tähän kirjataan palvelun nimi ja lyhyt kuvaus
MAKA-tietue (taulu 5) 30 (43) 4.7 Sisältötietue MAKA Sisältötietueella MAKA raportoidaan taulukon 5 tiedot maksupäätteiden käytöstä. 4.7.1 Tietueen kentät Tietueen on täytettävä kentän oikean tyypin, koon sekä muoto- ja pakollisuussääntöjen lisäksi seuraavat ehdot. Mikäli kentälle on ilmoitettu koodilista, tulee arvon löytyä koodilistalta. Jos MAKA tietuetta raportoidaan, toimiala (kenttä 8) raportoidaan ainoastaan myyntipistetapahtumille, muut kentät ovat aina pakollisia. Ryhmä Järj. Kenttä Koodilista Muoto Sääntö Vasen puoli Operaattori Oikea puoli Tietueen 1 Tietueen MAKA Maksupäätteiden käy- 1: Tietueen Varchar(4) 001 Kentän 1 arvo "MAKA" Raportoijan tiedot 2 tön indikaattoreita Raportoijan tunnuksen 2: Tunnuksen Char(1) 001 Kentän 2 arvo Kentän 2 arvo Koodilista 2: Tunnuksen Tiedon luokittelu 3 4 Raportoijan tunnus Yhtiön Y-tunnus muodossa NNNNNNNN ilman väliviivaa. Korttitapahtuman 9: Kortti- tapahtu- Varchar(20) 001 Kentän 3 arvo JOS kentän 2 arvo on Y, NIIN kentän 3 arvo Validi Y-tunnus <NNNNNNNN> Char(3) 001 Kentän 4 arvo
MAKA-tietue (taulu 5) 31 (43) Kortin liikkeeseenlaskumaa Kortin liikkeeseenlaskumaa ISO 3166-luokituksen mukaan. man 6: Maa (ISO 3166) Kentän 4 arvo Char(2) 001 Kentän 5 arvo koodilista 9: Korttitapahtuman koodilista 6: Maa (ISO 3166) JOS kentän 6 arvo U, NIIN kentän 5 arvo FI 5 003 JOS kentän 4 arvo on D06 (käteisnosto myyntipisteiden maksupäätteellä), NIIN kentän 5 arvo FI 004 JOS kentän 4 arvo on <> D07 (käteisnosto) TAI D08 NIIN kentän 5 arvo 6 Päätteen/laitteen tarjoava maksupalveluntarjoaja K kotimainen U ulkomainen 005 Char(2) 001 JOS kentän 4 arvo on D07 (käteisnosto) TAI D08 (käteistalletus) NIIN kentän 5 arvo Kentän 6 arvo JOS kentän 4 arvo on <> D06 (käteisnosto myyntipisteiden maksupäätteellä), D07 (käteisnosto) TAI D08 (käteistalletus), NIIN kentän 6 arvo null K / U
MAKA-tietue (taulu 5) 32 (43) Päätteen sijaintimaa Päätelaitteen sijainti ISO 3166- luokituksen mukaan. 6: Maa (ISO 3166) 003 JOS kentän 4 arvo on D06 (käteisnosto myyntipisteiden maksupäätteellä), D07 (käteisnosto) TAI D08 (käteistalletus) NIIN kentän 6 arvo Char(2) 001 JOS kentän 4 arvo on <> D06 (käteisnosto myyntipisteiden maksupäätteellä), D07 (käteisnosto) TAI D08 (käteistalletus), NIIN kentän 7 arvo null 7 Kentän 7 arvo koodilista 6: Maa (ISO3166) 003 JOS kentän 4 arvo on D06, D07 TAI D08, NIIN kentän 7 arvo null 8 Toimiala Toimiala luokittelun ISO 18245 Merchant category codes mukaan Char(4) 001 JOS kentän 6 arvo (Laitteen/päätteen maksupalveluntarjoaja) on K JA Kentän 5 arvo (Kortin liikeeseenlaskumaa) on <> FI JA kentän 4 arvo on D03 (myyntipistetapahtuma POS) JA kentän 7 arvo on FI NIIN kentän 8 arvo JOS kentän 6 arvo (Laitteen/päätteen maksupalveluntarjoaja) on U JA kentän 5 (kortin liikkeeseenlaskumaa) FI JA kentän 4 arvo on D03 (myyntipistetapahtuma POS) JA kentän 7 arvo on <> FI NIIN kentän 8 arvo
MAKA-tietue (taulu 5) 33 (43) 003 MUUTOIN kentän 8 arvo null Arvo 9 Tapahtumien lukumäärä Number(12) 001 Kentän 9 arvo ja >0 10 Tapahtumien arvo Number(12) 001 Kentän 10 arvo ja >0 4.7.2 Esimerkkejä MAKA esimerkki 1 Korttitapahtuma myyntipisteellä (POS), suomalainen kortti, laitteen tarjoaja ulkomainen maksupalveluntarjoaja, päätelaite sijaitsee Saksassa, toimiala: lentoyhtiö, tapahtumien lukumäärä 500 kpl, tapahtumien arvo 30 000 (Asetuksen taulu 5c) MAKA ; Y ; 12345678 ; D03 ; FI ; U ; DE ; 4511 ;500;30000 MAKA esimerkki 2 Käteisnostot konttorissa, tapahtumien lukumäärä 100 kpl, tapahtumien arvo 5 000 MAKA ; Y ; 12345678 ; D07 ;;;;;100;5000
ASLA-tietue (taulu 6) 34 (43) 4.8 Sisältötietue ASLA Sisältötietueella ASLA raportoidaan taulukon 6 tiedot asiakassovelluksista ja sähköisestä laskutuksesta. 4.8.1 Tietueen kentät Tietueen on täytettävä kentän oikean tyypin, koon sekä muoto- ja pakollisuussääntöjen lisäksi seuraavat ehdot. Mikäli kentälle on ilmoitettu koodilista, tulee arvon löytyä koodilistalta. Ryhmä Järj. Kenttä Koodilista Muoto Sääntö Vasen puoli Operaattori Oikea puoli Tietueen 1 Tietueen ASLA Asiakassovellukset ja 1: Tietueen Varchar(4) 001 Kentän 1 arvo "ASLA" Raportoijan tiedot 2 sähköinen laskutus Raportoijan tunnuksen 2: Tunnuksen Char(1) 001 Kentän 2 arvo Kentän 2 arvo Koodilista 2: Tunnuksen Tiedon luokittelut 3 4 Raportoijan tunnus Yhtiön Y-tunnus muodossa NNNNNNNN ilman väliviivaa. Palvelun Erittelee tapahtuman tyypin. 11: Palvelun Varchar(20) 001 Char(3) 001 Kentän 3 arvo JOS kentän 2 arvo on Y, NIIN kentän 3 arvo Kentän 4 arvo Kentän 4 arvo Validi Y-tunnus <NNNNNNNN> koodilista 11: Palvelun
ASLA-tietue (taulu 6) 35 (43) Arvo Tapahtumien lukumäärä Number(12) 001 JOS kentän 4 arvo on <> E110, E120, E140, E150 TAI E160, NIIN kentän 5 arvo ja > 0 5 JOS kentän 4 arvo on E110, E120, E140, E150 TAI E160, NIIN kentän 5 arvo null 6 7 Sopimuksien/käyttäjien lukumäärä Number(12) 001 Tapahtumien arvo ( ) Number(12) 001 JOS kentän 4 arvo on <> E051, E052, E070, E080, E090, E100 TAI E130, NIIN kentän 6 arvo JOS kentän 4 arvo on E051, E052, E070, E080, E090, E100 TAI E130, NIIN kentän 6 arvo JOS Kentän 4 arvo on E070 (Verkkomaksupainike) TAI E100 (Suoramaksut) NIIN kentän 7 arvo JOS Kentän 4 arvo on <> E070 (Verkkomaksupainike) TAI E100 (Suoramaksut) NIIN kentän 7 arvo ja >0 null ja >0 null
ASLA-tietue (taulu 6) 36 (43) 4.8.2 Esimerkkejä E-laskun lähetyssopimukset, 300 kpl (tapahtumien lukumäärää ja arvoa ei raportoida tämän palvelutyypin osalta). ASLA ; Y ; 12345671 ; E110 ;;300;
KIPA- tietue (taulu 7) 37 (43) 4.9 Sisältötietue KIPA Sisältötietueella KIPA raportoidaan taulukon 7 tiedot kirjeenvaihtajapankkimaksuista. 4.9.1 Tietueen kentät Tietueen on täytettävä kentän oikean tyypin, koon sekä muoto- ja pakollisuussääntöjen lisäksi seuraavat ehdot. Mikäli kentälle on ilmoitettu koodilista, tulee arvon löytyä koodilistalta. Ryhmä Järj. Kenttä Koodilista Muoto Sääntö Vasen puoli Operaattori Oikea puoli Tietueen 1 Tietueen KIPA Kirjeenvaihtajapankkima 1: Tietueen Varchar(4) 001 Kentän 1 arvo "KIPA" Raportoijan tiedot 2 ksut Raportoijan tunnuksen 2: Tunnuksen Char(1) 001 Kentän 2 arvo Kentän 2 arvo Koodilista 2: Tunnuksen Tiedon luokittelu 3 4 Raportoijan tunnus Yhtiön Y-tunnus muodossa NNNNNNNN ilman väliviivaa. Maksun 12: Maksun Varchar(20) 001 Char(3) 001 Kentän 3 arvo JOS kentän 2 arvo on Y, NIIN kentän 3 arvo Kentän 4 arvo Kentän 4 arvo jouk- Validi Y-tunnus <NNNNNNNN> koodilista 12:Maksun
KIPA- tietue (taulu 7) 38 (43) 5 6 Maa Maksutapahtuman vastapuolen sijaintimaa ISO 3166-luokituksen mukaan. Tapahtumien valuutta 6: Maa (ISO 3166) 13: Valuutta (ISO 4217) Char(2) 001 Varchar(4) 001 Kentän 5 arvo Kentän 4 arvo on <> C0411 TAI C0600 TAI NIIN kentän 5 arvo Kentän 6 arvo Kentän 4 arvo on <> C0411 TAI C0600 TAI NIIN kentän 6 arvo koon koodilista 6: Maa (ISO 3166) koodilista 13: Valuutta (ISO 4217) Maksun toimeksiantotapa Arvo 7 Maksujen lukumäärä Number(12) 001 Kentän 7 arvo ja > 0 8 Maksujen arvo (euroissa) Number(12) 001 Kentän 8 arvo ja > 0 4.9.2 Esimerkkejä KIPA esimerkki 1 Sähköiset yksittäiset maksut, Saksaan, valuutta euro, 10 kpl, 1500. KIPA ; Y ; 12345678 ; C0420 ; DE ; EUR ;10;1500
Raporttitason validointisäännöt 39 (43) 4.10 Raporttitason validointisäännöt Seuraavat validointisäännöt eivät liity yksittäisiin kenttiin, vaan ovat voimassa useamman kentän yhdistelmälle tai raportille kokonaisuutena. 4.10.1 Yleiset Sääntö MATI.ALL.R1 Raportin tietueilla tulee aina olla sama raportoijan validi y-tunnus Raportoijan tunnus-kentässä (kenttä 3). Sääntö MATI.ALL.R2 Raportilla tulee olla 000-erätietueen lisäksi vähintään yksi sisältötietue. 4.10.2 TILI-tietue Sääntö MATI.TILI.R1 - Tiedostossa voi olla 0 tai 1 kpl TILI- tietuetta.
Raporttitason validointisäännöt 40 (43) 4.10.3 MATO tietueet Sääntö MATI.MATO.R1 - Tiedostossa voi olla vain yksi MATO-tietue kullekkin koodille koodilistasta 4: Kortin (Kenttä 4) 4.10.4 LAMP tietueet Sääntö MATI.LAMP.R1 - Tiedostossa voi olla vain yksi LAMP-tietue, jossa on sama yhdistelmä kentistä: Päätelaitteen (Kenttä 4, koodilista 5: Päätelaitteen ) Päätelaitteen sijainti (Kenttä 5, koodilista6: Maa (ISO 3166) 4.10.5 MIK1 tietueet Sääntö MATI.MIK1.R1 - Tiedostossa voi olla vain yksi MIK1-tietue, jossa on sama yhdistelmä kentistä:
Raporttitason validointisäännöt 41 (43) Maksuinstrumentin 1 (Kenttä 4, koodilista 7: Maksuinstrumentin 1) Maa (Kenttä 5, koodilista 6: Maa (ISO 3166)) Vastapuoli (Kenttä 6, ei koodilista, arvo S/V) Sääntö MATI.MIK1.R2 - Lähetetyt SEPA -tilisiirrot + Lähetetyt muut kuin SEPA tilisiirrot Lähetetyt paperiset toimeksiannot + Lähetetyt sähköiset toimeksiannot C0100 + C0200 C0300 + C0410 + C0420 4.10.6 MIK2 tietueet Sääntö MATI.MIK2.R1 - Tiedostossa voi olla vain yksi MIK2-tietue, jossa on sama yhdistelmä kentistä: Maksuinstrumentin 2 (Kenttä 4, koodilista 8: Maksuinstrumentin 2) Maa (Kenttä 5, koodilista 6: Maa (ISO 3166)) Kortin käyttötapa (Kenttä 6, arvo 0/1, ei koodilista) Maksuinstrumentin kuvaus (Kenttä 9, vapaata tekstiä) 4.10.7 MAKA tietueet
Raporttitason validointisäännöt 42 (43) Sääntö MATI.MAKA.R1 - Tiedostossa voi olla vain yksi MAKA-tietue, jossa on sama yhdistelmä kentistä: Korttitapahtuman (Kenttä 4, koodilista 9: Korttitapahtuma ) Kortin liikkeeseenlaskumaa (Kenttä 5, koodilista 6: Maa (ISO 3166)) Päätteen/laitteen tarjoava maksupalveluntarjoaja (kenttä 6, K / U ) Päätteen sijaintimaa (Kenttä 7, koodilista 6:Maa(ISO 3166)) Toimiala, MCC (kenttä 8, 4-numeroinen) 4.10.8 ASLA tietueet Sääntö MATI.ASLA.R1 - Tiedostossa voi olla vain yksi ASLA-tietue kullekkin koodille koodilistasta 11: Palvelun (kenttä 4 ) 4.10.9 KIPA tietueet Sääntö MATI.KIPA.R1 - Tiedostossa voi olla vain yksi KIPA-tietue, jossa on sama yhdistelmä kentistä
Raporttitason validointisäännöt 43 (43) Maksun (Kenttä 4, koodilista 12: Maksun ) Maa (kenttä 5, koodilista 6: Maa (ISO 3166) Tapahtuman valuutta (Kenttä 6, koodilista: Valuutta (ISO 4217) Maksun toimeksiantotapa (Kenttä 7: P / S )