OSUUSPANKIN ERÄSIIRTOPALVELU Maksuliikepalvelut Liittymäkuvaus Osuuspankit / Pohjola Pankki Oyj
OP-KESKUS LIITTYMÄKUVAUS 2/80 OP-Keskus pidättää itsellään oikeuden muutoksiin 11/2010 OSUUSPANKIN ERÄSIIRTOPALVELUN YLEISKUVAUS 4 1 TIETOLIIKENNE 5 1.1 YHTEYSTAVAT 5 1.2 KERMIT-PROTOKOLLA 5 1.2.1 Valinnainen puhelinverkko 5 1.2.2 Pakettiverkot 5 1.2.3 Kermitissä sallittavat komennot 5 1.2.4 Kermitin SEND INIT -paketti 5 1.2.5 Kermitissä käytettävät skandinaaviset aakkosmerkit 6 1.3 TCP/IP:N FTP-KÄYTÄNTÖ 6 1.3.1 Reititinverkko (TCP/IP) 6 1.3.2 FTP-palvelimen osoitteet 6 1.3.3 FTP-palvelimen siirtoparametrien oletusarvot 7 1.3.4 FTP-palvelimen tukemat komennot 7 1.3.5 FTP:ssä käytettävät skandinaaviset aakkosmerkit 7 2 VUOROPUHELU 8 2.1 LOOGINEN ISTUNTO 8 2.2 OHJAUSSANOMAT 8 2.3 ESITTÄYTYMINEN 9 2.4 AINEISTON LÄHETYS 9 2.5 LÄHETETYN AINEISTON POISTO 11 2.6 AINEISTON TARKISTUS 11 2.7 AINEISTON NOUTO 12 2.8 TILIOTEUUSINNAN TILAUS 13 2.9 VIESTI TUKIPALVELUUN 14 2.10 AJANTASAINEN TAPAHTUMA 14 2.10.1 Tilin saldokysely 15 2.10.2 Tilin tapahtumakysely 15 2.10.3 Tilin tapahtumaotekysely 16 2.10.4 Tilien saldoyhteenveto 22 2.10.5 Tilien laajennettu saldoyhteenveto 23 2.10.6 Tilisiirto 23 2.10.7 Luoton saldokysely 24 2.10.8 Luottojen saldoyhteenveto 25 2.10.9 Valuuttatilien saldoyhteenveto 26 2.10.10 Ajantasainen pikamaksu 27 2.10.11 Konsernitilikysely 28 2.11 YHTEYDEN LOPETUSSANOMA 29 3 ESIMERKKEJÄ "VUOROPUHELUISTA" 30 3.1 TOISTUVAISSUORITUSTEN LÄHETYS 30 3.2 TAPAHTUMALUETTELON VASTAANOTTO 30 3.3 TAPAHTUMAKYSELY 31 3.4 PALVELUKESKUS HOITAA KAHDEN ERI ASIAKKAAN PANKKIYHTEYDEN SAMALLA YHTEYDELLÄ 31 4 OSUUSPANKIN ERÄSIIRTOPALVELUN KÄYTTÖÖNOTTO 33 4.1 SOPIMUKSET JA KÄYTTÄJÄTUNNUKSET 33 4.2 PATU AVAIMET PANKKIYHTEYSOHJELMASSA 33 5 TESTAUS 33 6 VIRHEILMOITUKSET 34 7 PATUN ILMOITUSKOODIT SEKÄ NIITÄ VASTAAVAT TEKSTIT 35
OP-KESKUS LIITTYMÄKUVAUS 3/80 8 PANKKIYHTEYSOHJELMISTON LÄHETTÄMÄT AINEISTOT 35 8.1 LASKUJEN MAKSUPALVELU 35 8.2 TOISTUVAISSUORITUKSET 41 8.3 SUORAVELOITUS 42 8.4 LÄHTEVÄT ULKOMAANMAKSUT 44 8.5 POHJOLA PANKIN FACTORINGLASKUT 49 8.5.1 Tarkistukset 50 8.5.1.1 Tiedostorakenteen oikeellisuuden tarkistus 50 8.5.1.1 Laskutietueista lasketaan 50 8.5.2 Koodit 50 8.6 MAKSUPÄÄTEAINEISTO 53 8.7 E-LASKUT PANKIN VERKKOPALVELUSSA, LÄHETETTÄVÄT AINEISTOT 53 8.7.1 Edellytykset palvelun käytölle 53 8.7.2 Käytettävät aineistotunnukset 53 9 PANKKIYHTEYSOHJELMISTON NOUTAMAT AINEISTOT 54 9.1 TILIOTE 54 9.2 KONSERNITILIOTE 54 9.3 TILIOTE ULKOMAILTA 56 9.4 VIITEPALVELUN TAPAHTUMALUETTELO 61 9.5 LASKUJEN MAKSUN PALAUTEAINEISTOT 62 9.6 SUORAVELOITUSPALVELUN VALTUUTUSTIETOAINEISTO 67 9.7 SAAPUVIEN ULKOMAAN MAKSUJEN ENNAKKOTIEDOT 69 9.8 PALAUTE LÄHETETYISTÄ ULKOMAANMAKSUISTA 70 9.9 MAKSUPÄÄTEPALAUTTEET 73 9.10 E-LASKUT PANKIN VERKKOPALVELUSSA, NOUDETTAVAT AINEISTOT 74 9.11 VALUUTTAKURSSIT 74 10. C2B-MAKSUAINEISTO 75 PATUN TUNNISTAUTUMIS- JA AINEISTON SUOJAUSSANOMAT OSUUSPANKIN ERÄSIIRTOPALVELUSSA 75 AINEISTOLUETTELO 79 AJANTASAISEN TAPAHTUMAN VIRHEVASTAUS 80
OP-KESKUS LIITTYMÄKUVAUS 4/80 OSUUSPANKIN ERÄSIIRTOPALVELUN YLEISKUVAUS Tämä osuuspankin eräsiirtopalvelun liittymäkuvaus on tarkoitettu ohjelmistotaloille ja niille asiakkaille, jotka rakentavat pankkiyhteysohjelmansa itse. Osuuspankin eräsiirtopalvelun välityksellä asiakas voi käyttää omalla pankkiyhteysohjelmistollaan osuuspankkien tarjoamia pankkipalveluja. Liikennöinti pankkiyhteysohjelmiston ja osuuspankin eräsiirtopalvelun välillä on eräpohjaista tiedostosiirtoa. Asiakkaan pankkiyhteysohjelma ohjaa yhteyden vuoropuhelua ohjaussanomien avulla. Asiakas voi lähettää ja noutaa aineistoja sekä tehdä ajantasaisia kyselyitä ja tapahtumia. Osuuspankin eräsiirtopalvelu varastoi asiakkaan lähettämän aineiston ja siirtää sen jatkokäsittelyyn aineistotyypille määrätyn aikataulun mukaan. Asiakas voi poistaa tai korvata lähettämänsä aineiston ennen sen siirtoa jatkokäsittelyyn. Asiakas voi noutaa osuuspankin eräsiirtopalvelusta asiakaskohtaisia ja julkisia aineistoja. Ajantasaisten palvelujen vastaukset lähetetään asiakkaalle välittömästi saman yhteyden aikana. Osuuspankin eräsiirtopalvelu palvelee asiakkaita kaikkina viikonpäivinä ympäri vuorokauden.
OP-KESKUS LIITTYMÄKUVAUS 5/80 1 TIETOLIIKENNE 1.1 Yhteystavat 1.2 Kermit-protokolla Osuuspankin eräsiirtopalveluun voidaan liikennöidä Kermit-protokollalla valintaista puhelinverkkoa ja X.29- pakettiverkkoa tai FTP-protokollalla TCP/IPverkkoa käyttäen. 1.2.1 Valinnainen puhelinverkko Puhelinnumerot: 1.2.2 Pakettiverkot - tuotanto: 09-701 8088 - testi: 09-731 0255 Modeeminopeudet: 2400-56K (v.90) 8 data bits, parity none, 1 stop bit PAD-osoitteet: Datapak - tuotanto 24420049007089 - testi 24420049007088 FinPak - tuotanto 24432001009189 - testi 24432001009188 1.2.3 Kermitissä sallittavat komennot SEND GET Tiedoston lähetys Tiedoston vastaanotto 1.2.4 Kermitin SEND INIT -paketti Osuuspankin eräsiirtopalvelu lähettää seuraavanlaisen SEND INIT-paketin 8 S-~/ @- Y1~R *Q jossa MAXL: ~ suurin vastaanotettavan paketin koko 94 merkkiä TIME: / asiakkaan Kermitin on odotettava 15 sekuntia ennen aikakatkaisua. Asiakkaan Kermit ei saa pyytää samaa arvoa omassa TIME-parametrissaan NPAD: joutomerkkejä ei käytetä PADC: @ asiakkaan Kermitissä käytettävä joutomerkki
OP-KESKUS LIITTYMÄKUVAUS 6/80 EOL: - Kermit-paketin päätösmerkki on CR QCTL: kontrollimerkkiä edeltävä merkki QBIN: Y 8-bitin data hyväksytään CHKT: 1 käytetään 1 merkin mittaista tarkistussummaa REPT: ~ samanlaisia merkkejä peräkkäin ilmaiseva merkki CAPAS: R 0101 0010 = pitkät paketit hyväksytään WINDO: ei käytetä ikkunointia MAXL1: * 10 * 95 = 950 MAXL2: Q 49 = pitkien pakettien max koko 999 merkkiä 1.2.5 Kermitissä käytettävät skandinaaviset aakkosmerkit Suositeltavaa olisi käyttää ISO 88591 merkistöä. Merkki Heksa-arvo ä E4 tai 84 å E5 tai 86 ö F6 tai 94 Å C5 tai 8F Ä C4 tai 8E Ö D6 tai 99 Osuuspankin eräsiirtopalvelun lähettämät skandinaaviset aakkosmerkit: Merkki ä å ö Å Ä Ö Heksa-arvo 84 tai 7B 86 tai 7D 94 tai 7C 8F tai 5D 8E tai 5B 99 tai 5C 1.3 TCP/IP:n FTP-käytäntö 1.3.1 Reititinverkko (TCP/IP) Yhteys voidaan muodostaa TCP/IP-verkkojen (esim. Internet) kautta ja tiedostosiirrossa käytetään FTP:tä. 1.3.2 FTP-palvelimen osoitteet Internet ja LanLink - tuotanto opnet.osuuspankki.fi 195.236.193.4
OP-KESKUS LIITTYMÄKUVAUS 7/80 - testi opnettesti.osuuspankki.fi 195.236.193.5 DataNet - tuotanto opnetdn.osuuspankki.fi 157.124.42.42 - testi opnetdntesti.osuuspankki.fi 157.124.42.43 Vpn-yhdyskäytävä 195.236.193.17 - tuotanto erasiirto.osuuspankki.fi 195.236.193.204 - testi erasiirtotesti.osuuspankki.fi 195.236.193.205 1.3.3 FTP-palvelimen siirtoparametrien oletusarvot file structure (struct) F representation type (type) ASCII Non-print transfer mode (mode) STREAM 1.3.4 FTP-palvelimen tukemat komennot PORT RETR STOR PASV QUIT dataportin osoite tiedoston vastaanotto tiedoston lähetys passiivi FTP-yhteys yhteyden lopetus 1.3.5 FTP:ssä käytettävät skandinaaviset aakkosmerkit Suositeltavaa olisi käyttää ISO 88591 merkistöä. Merkki ä å ö Å Ä Ö Heksa-arvo E4 tai 7B E5 tai 7D F6 tai 7C C5 tai 5D C4 tai 5B D6 tai 5C Osuuspankin eräsiirtopalvelun lähettämät skandinaaviset aakkosmerkit: Merkki ä å ö Å Ä Ö Heksa-arvo 84 tai 7B 86 tai 7D 94 tai 7C 8F tai 5D 8E tai 5B 99 tai 5C
OP-KESKUS LIITTYMÄKUVAUS 8/80 2 VUOROPUHELU Vuoropuhelu pankkiyhteysohjelman ja osuuspankin eräsiirtopalvelun välillä käydään ohjaussanomien avulla. Ohjaussanomat ja tiedot lähetetään tiedostoina, joissa tietueet lopetetaan aina CRLF-merkeillä. 2.1 Looginen istunto Fyysisen yhteyden avaamisen jälkeen täytyy pankkiyhteysohjelman avata looginen istunto ESI-sanomalla. Samassa fyysisessä yhteydessä voi olla useita peräkkäisiä loogisia istuntoja. Edellinen istunto lopetetaan avaamalla uusi istunto. Viimeinen istunto lopetetaan LOGOFF-sanomalla. Pankkiyhteysohjelman pitää noutaa BYE-sanoma ja sen jälkeen katkaista fyysinen yhteys protokollatasolla. 2.2 Ohjaussanomat Pankkiyhteysohjelman lähettämät ohjaussanomat Ohjaussanoma Selitys >>ESI Asiakkaan esittäytymissanoma $$LOGOFF Yhteyden lopetussanoma $$FILE OUT Aineiston noutopyyntö $$FILE IN Aineiston lähetyspyyntö >>SUO Aineiston suojausotsake >>VAR Aineiston suojauslopuke $$EOF Aineiston päättymisilmoitus $$DELETE Lähetetyn aineiston poistopyyntö $$TPn Ajantasainen tapahtuma $$ORDER Tilioteuusinnan tilaus $$NOTE Viesti tukipalveluun Osuuspankin eräsiirtopalvelun lähettämät ohjaussanomat Ohjaussanoma >>ESI $$BYE $$EOF Selitys Pankin esittäytymissanoma Yhteyden lopetussanoma Ajantasaisen tapahtuman tai aineiston noudon päättymisilmoitus
OP-KESKUS LIITTYMÄKUVAUS 9/80 >>SUO >>VAR >>PTE $$ERROR Pankin suojaaman aineiston suojausotsake Pankin suojaaman aineiston suojauslopuke Asiakkaan lähettämän suojatun aineiston vastaanottokuittaus Asiakkaan pyytämän palvelun virhevastaus 2.3 Esittäytyminen 2.4 Aineiston lähetys Asiakas ja pankki todentavat toisensa ESI-sanomilla PATU-standardin mukaisesti. osuuspankin eräsiirtopalvelun PATU-sanomien tiedot on kuvattu liitteessä 1, PATUn tunnistautumis- ja suojaussanomat. Aineiston lähetys osuuspankin eräsiirtopalveluun aloitetaan lähetyspyyntösanomalla $$FILE IN,aineistonimi missä aineistonimi yksilöi osuuspankin eräsiirtopalveluun lähetettävän aineiston. Nimi on muotoa AAnxxxxxxxxxxxxxxxxx - AA on aineistotunnus (esim. MP, katso kappaleet 8 ja 9) - n on jokin numero 0-9 - x (1-17 kpl) on numero, kirjain A-Z, taala ($), alaviiva (_) tai piste (vain kerran) Suositeltavaa on käyttää aineistonimessä lähetyspäivää ja päiväkohtaista juoksevaa numeroa. Esimerkiksi aineistonimi MP0401.12 olisi huhtikuun ensimmäisen päivän kahdestoista LMP-aineisto. Aikaisemmin lähetetty jatkokäsittelyä odottava aineisto voidaan korvata lähettämällä uusi aineisto samalla nimellä. Jatkokäsittelyyn siirrettyä aineistoa ei voida korvata, vaan uusi samanniminen aineisto hylätään. Kun aineisto suojataan PATU-menettelyn avulla, pankkiyhteysohjelma lähettää seuraavaksi suojausotsakkeen (SUO-sanoman). Seuraavaksi pankkiyhteysohjelma lähettää varsinaisen aineiston, joka noudattaa aineistotunnuksen mukaista tietuekuvausta. Jos aineisto suojattiin PATU-menettelyn avulla, pankkiyhteysohjelma lähettää seuraavaksi suojauslopukkeen (VAR-sanoman). Lopuksi pankkiyhteysohjelma lähettää aineiston päättymisilmoituksen $$EOF CHECKSUM/tarkiste/ missä - tarkiste on asiakkaan laskema tarkistussumma (ilman desimaalierotinta), kun aineistotunnus on FE, LU, MP, MT, SV tai TS. Tarkistussumma saadaan laskemalla tapahtumatietueiden
OP-KESKUS LIITTYMÄKUVAUS 10/80 rahamäärät yhteen. MP-aineiston hyvitystapahtumia ei lasketa mukaan. Esimerkiksi $$EOF CHECKSUM/879500/ Jos aineistotunnukselle ei tarvita tarkistussummaa, on päättymisilmoitus $$EOF Tämän jälkeen pankkiyhteysohjelman täytyy noutaa osuuspankin eräsiirtopalvelusta kuittaus, joka kertoo hyväksyttiinkö aineisto. Kuittaus on PATUa käytettäessä PTE-sanoma ja muulloin EOF-sanoma. osuuspankin eräsiirtopalvelu on hyväksynyt aineiston, kun se vastaa PTE-sanomalla, jonka onnistumiskoodin arvo on "K", tai allaolevalla EOF-sanomalla. $$EOF aineistonimi nnnnnnn RECORDS - CHECKSUM nnn nnn nnn nnn nn missä - aineistonimi on vastaanotetun aineiston nimi - nnnnnnn on vastaanotettujen tietueiden lukumäärä - CHECKSUM nnn nnn nnn nnn nn on osuuspankin eräsiirtopalvelun laskema tarkistussumma eli rahamäärä ilman etunollia, välilyönnein ryhmiteltynä kolmen numeron jaksoihin ja kahteen desimaalinumeroon. Esimerkiksi $$EOF MP0401.12 5 RECORDS - CHECKSUM 8 795 00 Jos aineistotunnuksella ei käytetä tarkistussummaa, CHECKSUMosa ei ole mukana. Esimerkiksi $$EOF XX0502.1 22 RECORDS Osuuspankin eräsiirtopalvelu on hylännyt aineiston, kun se vastaa PTEsanomalla, jonka onnistumiskoodin arvo on "E", tai ERROR-sanomalla. Yleisimmät hylkäyssyyt ovat: $$ERROR - INPUT FILE PROTECTED Samanniminen aineisto on jo siirretty jatkokäsittelyyn, eikä sitä voida enää korvata tai poistaa. $$ERROR - INVALID DATA; FILE DISGARDED osuuspankin eräsiirtopalvelun laskema tarkistussumma ei täsmää asiakkaan lähettämän tarkistussumman kanssa. $$ERROR - INPUT MESSAGE OVERFLOW Pankkiyhteysohjelma on lähettänyt liian pitkän tietueen osuuspankin eräsiirtopalveluun. $$ERROR - PERMISSION ERROR Asiakkaalla ei ole lupa lähettää kyseisellä aineistotunnuksella aineistoa. PTE-sanoman kuittausosa sisältää EOF-sanoman tai ERROR-sanoman. HUOM! Jos pankkiyhteysohjelma ehtii lähettää EOF-sanoman ja vuoropuhelu katkeaa ennen kuin osuuspankin eräsiirtopalvelusta saadaan kuittaus, täytyy aineisto
OP-KESKUS LIITTYMÄKUVAUS 11/80 lähettää uudelleen samannimisenä tai varmistaa aineiston perillemeno esimerkiksi lähetettyjen aineistojen tilakyselyllä. 2.5 Lähetetyn aineiston poisto Aikaisemmin lähetetty jatkokäsittelyä odottava aineisto voidaan poistaa lähetetyn aineiston poistopyynnöllä. Jatkokäsittelyyn siirrettyä aineistoa ei voida poistaa. Poistopyyntö on muotoa: $$DELETE aineistonimi missä - aineistonimi yksilöi osuuspankin eräsiirtopalvelusta poistettavan aineiston. Poistopyynnön lähettämisen jälkeen pankkiyhteysohjelman täytyy noutaa osuuspankin eräsiirtopalvelun kuittaus. Aineiston poisto onnistui, jos kuittaus on $$EOF Virhetilanteessa kuittaus on ERROR-virheilmoitus. Yleisimmät virheilmoitukset ovat: $$ERROR - FILE NOT EXISTENT Aineistoa ei ole olemassa. 2.6 Aineiston tarkistus $$ERROR - INPUT FILE PROTECTED Aineisto on jo siirretty jatkokäsittelyyn, eikä sitä voida enää poistaa. Aineistoa vastaanotettaessa tehdään aineistolle sisällöllisiä tarkistuksia. Tarkistuksessa havaittu virhe hylkää koko lähetyserän, jolloin erä ei mene sovelluksen jatkokäsiteltäväksi. Asiakas saa lähetyserän hylkäämisestä virheilmoituksen kuittauksessa. Asiakkaan noudettavaksi syntyy myös vastaanottoraportti, johon tulostetaan virheellinen tietue ja virheilmoitukset. Aineistoille tehdään myös sopimustarkistuksia: sopimus ja lähettäjä (TS). Jos tarkistettavia tietoja ei löydy tai ne eivät täsmää sopimustietojen kanssa, siirto hylätään. Aineistoa vastaanotettaessa tarkastetaan TS- sekä MP-aineistot. Pankkiyhteysohjelma pyytää aineistojen kuittaustiedoston uudella $$CHECKohjauskomennolla: $$CHECK,aineistonimi, E missä aineistonimi on sama kuin eräsiirtopalveluun lähetetyn aineiston nimi. Nimi on muotoa AAnxxxxxxxxxxxxxxxxx - AA on aineistotunnus esim. TS - n on jokin numero 0-9
OP-KESKUS LIITTYMÄKUVAUS 12/80 - x (1-17 kpl) on numero, kirjain A-Z, taala ($), alaviiva (_) tai piste (vain kerran) E - annetaan parametri E mikäli halutaan vain virhelista esim. - halutaan kaikki noutamattomat infoaineistot $$CHECK - halutaan lähetetyn aineiston MP0919.1 infotiedot (joko virhe- tai ok-lista) $$CHECK, TS1025.1 - halutaan kaikki noutamattomat virhelistat $$CHECK,,E - jne. Käyttäjä noutaa aina infoaineistonsa heti lähettämänsä aineistonsa perään käyttämällä noutopyynnössä lähetetyn aineiston nimeä esim. $$CHECK, TS1025.1 Kyselyllä $$FILE OUT, FILES.CHECK saadaan lista kaikista noudettavissa olevista infoaineistoista: Kyselyn vastaus on seuraavassa muodossa: Otsikkotietue Kenttä Tiedon nimi Muoto Kuvaus 1 Vakioteksti AN16 MUODOSTAMISPVM: 2 Muodostamispvm AN10 pp.kk.vvvv 3 Varalla AN1 4 Vakioteksti AN5 KLO: 5 Muodostamishetki AN8 tt:mm:ss 6 Varalla AN4 7 Vakioteksti AN7 TILAKD. Aineistotietue Kenttä Tiedon nimi Muoto Kuvaus 1 Aineistonimi AN16 Sama kuin lähetetyn aineiston nimi 2 Aikaleima AN19 luontihetki muodossa pp.kk.vvvv tt:mm:ss 3 Varalla AN10 4 Aineiston tilakoodi AN1 O Noutamaton OK o Noudettu OK E Noutamaton viallinen e Noudettu viallinen 2.7 Aineiston nouto Aineiston nouto osuuspankin eräsiirtopalvelusta aloitetaan noutopyyntösanomalla $$FILE OUT,aineistonimi missä - aineistonimi on osuuspankin eräsiirtopalvelulta pyydettävän aineiston nimi.
OP-KESKUS LIITTYMÄKUVAUS 13/80 Aineistonimi on yleensä muotoa AAkkpp.n tai A.AAkkpp.n, joissa - AA tai A.AA on aineistotunnus esim. TI tai C.OP - kkpp on aineiston muodostamispäivä - n on aineiston versionumero (1-998) Aineistonimellä AA9999.999 voidaan noutaa kerralla kaikki uudet (noutamattomat) AA-aineistot. Aineistonimellä AA9999.n voidaan noutaa kerralla kaikki uudet (noutamattomat) AA-aineistot, joiden versionumero on n. Aineistonimellä FILES.OUT voidaan noutaa luettelo noudettavissa olevista asiakaskohtaisista aineistoista. Aineistoluettelon muoto on kuvattu liitteessä 2. Aineistonimellä C.FILES.OUT voidaan noutaa luettelo noudettavissa olevista julkisista aineistoista. Aineistonimellä FILES.IN voidaan noutaa luettelo lähetetyistä aineistoista. Aineistonimellä C.OP voidaan noutaa osuuspankin eräsiirtopalvelun yleistiedote. Seuraavaksi pankkiyhteysohjelma noutaa tiedoston, jonka alussa on pyydetty aineisto tai aineistot ja lopussa päättymisilmoitus (EOF). $$EOF aineistonimi n RECORDS missä - aineistonimi on noudetun aineiston nimi - n on aineiston tietueiden lukumäärä. Virhetilanteessa noudetussa tiedostossa on aineiston ja päättymisilmoituksen sijasta ERROR-virheilmoitus. Yleisimmät virheilmoitukset ovat: $$ERROR - FILE NOT EXISTENT Pyydetty aineisto ei ole noudettavissa. $$ERROR - PERMISSION ERROR 2.8 Tilioteuusinnan tilaus Asiakkaalla ei ole lupaa noutaa kyseistä aineistoa. Pankkiyhteysohjelma voi tilata tilioteuusinnan osuuspankin eräsiirto-palvelusta. Tilaus on muotoa: $$ORDER TU alkupäivä loppupäivä konttorinumero tilinumero missä - alkupäivä on tiliotejakson alkupäivä muodossa vvvvkkpp - loppupäivä on tiliotejakson loppupäivä muodossa vvvvkkpp - konttorinumero 6 merkin mittaisena - tilinumero 8 merkin mittaisena
OP-KESKUS LIITTYMÄKUVAUS 14/80 Konttorinumero ja tilinumero voivat olla tyhjää, jolloin tilaus koskee kaikkia toimipaikan tiliotetilejä. Jos konttorinumero on annettu, pitää myös tilinumero antaa. Tilauksen lähettämisen jälkeen pankkiyhteysohjelman täytyy noutaa osuuspankin eräsiirtopalvelun kuittaus. Tilaus onnistui, jos kuittaus on $$EOF Virhetilanteessa kuittaus on ERROR-virheilmoitus. Yleisimmät virheilmoitukset ovat: $$ERROR - INVALID CONTROL MESSAGE Päiväys on virheellinen tai tililtä ei voi tilata tiliotetta (esim. valuuttatili). $$ERROR - PERMISSION ERROR Asiakkaalla ei ole lupaa tehdä tilausta kyseiseltä tililtä. 2.9 Viesti tukipalveluun Pankkiyhteysohjelma voi lähettää vapaamuotoisen viestin osuuspankin eräsiirtopalvelun tukipalveluun, jossa se käsitellään palveluaikana. Viesti on muotoa: $$NOTE viesti missä - viesti on enintään 80 merkkiä pitkä osuuspankin eräsiirtopalvelu ei kuittaa viestiä, vaan pankkiyhteysohjelman pitää lähettää seuraavaksi uusi ohjaussanoma. 2.10 Ajantasainen tapahtuma Pankkiyhteysohjelma lähettää erilaisia ajantasaisia tapahtumia osuuspankin eräsiirtopalveluun $$TP-ohjaussanomilla. Pankkiyhteysohjelma noutaa osuuspankin eräsiirtopalvelusta kuittauksen, jossa on tapahtumakohtainen vastausosa ja sen lopussa EOF- päättymisilmoitus. Virhetilanteessa kuittauksessa on ainoastaan ERROR-virheilmoitus. Yleisimmät virheilmoitukset ovat: $$ERROR - NO RESPONSE FROM HOST Vastausta tapahtumaan ei saatu ajoissa. $$ERROR - NO OK RESPONSE FROM HOST Tapahtuma ei onnistunut. $$ERROR - PERMISSION ERROR
OP-KESKUS LIITTYMÄKUVAUS 15/80 Asiakkaalla ei ole lupaa tehdä kyseistä tapahtumaa. $$ERROR - ONLINE SYSTEM CLOSED Ajantasaisia tapahtumia ei voida tehdä. $$ERROR - TRANSACTION NOT DEFINED Pankkiyhteysohjelma lähetti virheellisen $$TP-sanoman. Vastausosa muodostuu yhdestä tai useammasta tietueesta. 2.10.1 Tilin saldokysely Pankkiyhteysohjelma voi kysyä tilin saldoa ohjaussanomalla $$TP1 1SS konttorinumero tilinumero X missä: - konttorinumero 6 merkin mittaisena - tilinumero 8 merkin mittaisena - X on merkki X. Saldokyselyn vastausosa Tiedon nimi Pituus Selitys Tietueen järjestysnumero 1 =1 Vastaustyyppi 1 1=OK, muu=virhe* Varalla 3 Tapahtumakonttorin numero 6 Päätenumero 2 Tapahtumanumero 4 Tilinomistajan nimi 15 Konttorinumero 6 Tilinumero 8 Päivämäärä 6 ppkkvv Saldo 11 2 des. Saldon etumerkki 1 +/- Luottoraja 11 2 des. Luottorajan etumerkki 1 +/- Nostovara 11 2 des. Nostovaran etumerkki 1 +/- Rahayksikön koodi 1 1=euro *) Virhevastauksen muoto on kuvattu liitteessä 3 2.10.2 Tilin tapahtumakysely Pankkiyhteysohjelma voi kysyä tilin tapahtumia ohjaussanomalla $$TP1 2ST konttorinumero tilinumero X
OP-KESKUS LIITTYMÄKUVAUS 16/80 missä - konttorinumero 6 merkin mittaisena - tilinumero 8 merkin mittaisena - X on merkki X. Tapahtumakyselyn vastausosa Tiedon nimi Pituus Selitys Tietueen järjestysnumero 1 1 Vastaustyyppi 1 1=OK, muu=virhe* Varalla 3 Tapahtumakonttori 6 Päätenumero 2 Tapahtumanumero 4 Tilinomistajan nimi 15 Konttorinumero 6 Tilinumero 8 Päivämäärä 6 ppkkvv Tapahtumat (10 kpl) tapahtumapäivä 6 ppkkvv selite 12 rahamäärä 11 2 des. etumerkki 1 +/- Saldo 11 2 des. Etumerkki 1 +/- Luottoraja 11 2 des. Etumerkki 1 +/- Katevaraukset 11 2 des. Etumerkki 1 +/- Nostovara 11 2 des. Etumerkki 1 +/- Rahayksikön koodi 1 1=euro *) Virhevastauksen muoto on kuvattu liitteessä 3 2.10.3 Tilin tapahtumaotekysely Pankkiyhteysohjelma voi kysyä tilin kuluvan päivän noutamattomia tiliotetapahtumia ohjaussanomalla: $$TP1 3ST konttorinumero tilinumero X missä: - konttorinumero 6 merkin mittaisena - tilinumero 8 merkin mittaisena - X on merkki 1 mikäli halutaan kaikki tapahtumat uudelleen päivän alusta
OP-KESKUS LIITTYMÄKUVAUS 17/80 Vastaussanoman tietuekuvaukset Tietueet erotetaan toisistaan tietue-erottimilla. Jokainen tietue päättyy carriage return- ja line feed -merkkeihin. Tapahtumaotteen perustietue Kenttä Tiedon nimi Muoto Kuvaus 1 Aineistotunnus AN1 S 2 Tietuetunnus AN2 00 3 Tietueen pituus N3 322 4 Versionumero AN3 001 5 Tilinumero AN14 6 Tapahtumaotteen no AN3 Tyhjää 7 Kyselypäivä.1 Alkupäivä N6 VVKKPP.2 Loppupäivä N6 VVKKPP 8 Muodostamisaika.1 Kuluva päivä N6 VVKKPP.2 Kelloaika N4 HHMM 9 Asiakastunnus AN17 10 Ei käytössä N6 11 Ei käytössä AN19 12 Ei käytössä N6 13 Tilin valuutan tunnus AN3 ISO-koodi 14 Tilin nimi AN30 15 Tilin limiitti AN18 16 kok + 2 desim 16 Tilinomistajan nimi AN35 17 Pankin nimi AN40 18 Ei käytössä AN40 19 Ei käytössä AN30 20 Ei käytössä AN30 YHTEENSÄ 322 Kenttä 4 ilmoittaa tapahtumaotteen muodostuksessa käytetyn ohjelman version. Kenttä 7 Alkupäivä ja loppupäivä on sama eli kyselypäivä. Kenttä 9 ilmoittaa tilinomistajasta pankissa käytettävän asiakastunnuksen ja sen mahdollisen tarkenteen (alkuvaiheessa maatunnus tai vakio sekä tarkenne ovat tyhjiä). - maatunnus X(4) tai.1 vakio X(4) - asiakastunnus X(8).2 asikastunnus X(10) - asiakastarkenne X(5).3 asiakastarkenne X(3) Kentässä 15 on tilin limiitti luotollisella shekkitilillä. Tilillä ei ole limiittiä, mikäli kentän sisältö on nollia. Konsernitilipalvelun yksikkötilillä kentässä välitetään tilin sisäinen limiitti.
OP-KESKUS LIITTYMÄKUVAUS 18/80 Tapahtuman perustietue Kenttä Tiedon nimi Muoto Kuvaus 1 Aineistotunnus AN1 S 2 Tietuetunnus AN2 10 3 Tietueen pituus N3 188 4 Kellonaika, tap. syntyaika N6 HHMMSS 5 Alkup. arkistointitunnus AN18 6 Kirjauspäivä N6 VVKKPP 7 Arvopäivä N6 VVKKPP 8 Maksupäivä N6 VVKKPP 9 Tapahtumatunnus AN1 1, 2, 3, 4 10 Kirjausselite.1;Koodi.2;Seliteteksti 11 Tapahtuman rahamäärä.1;etumerkki.2;määrä AN3 AN35 AN1 N18 16 kok + 2 desim 12 Kuittikoodi AN1 E = erittelyt eivät tule tapahtuma-otteeseen 13 Välitystapa AN1 14 Saaja/Maksaja.1 Nimi.2 Nimen lähde 15 Saajan tili.1 Tilinumero AN35 AN1 tyhjäm., A,J tai K AN14 AN1 tyhjämerkki, *.2 Tili muuttunut -tieto 16 Viite AN20 17 Lomakkeen numero AN8 18 Tasotunnus AN1 0 YHTEENSÄ 188 Kentässä 5 on tapahtuman muodostaneen pankin antama arkistointitunnus, jonka avulla pystytään jäljittämään alkuperäinen maksutoimeksianto. Arkistointitunnus kertoo, minä päivänä pankki on käsitellyt maksutoimeksiannon sekä minkä pankin konttori tai järjestelmä on käsitellyt tapahtuman. VVKKPP XXXXXXXXXXXX ^ yksilöintitieto ^ päivämäärä Arkistointitunnuksen yksilöintitieto on pankkikohtainen. Sen ensimmäiset merkit kertovat pankkiryhmän tunnuksen. Kentässä 9 on tapahtumatunnus, jonka arvot ovat: 1 = pano 2 = otto 3 = panon korjaus 4 = oton korjaus Huom. Korjauksen korjaukset tulevat tapahtumatyypillä 1 (pano) tai 2 (otto).
OP-KESKUS LIITTYMÄKUVAUS 19/80 Kentässä 10 annettava kirjausselite ilmoittaa, minkä palvelun kautta tai miten tapahtuma on tilipankissa kirjattu. Kirjausselitteen koodin ensisijaisena tarkoituksena on mahdollistaa asiakkaiden automaattinen tilitapahtumien tiliöinti omassa kirjanpidossaan. Automaattisesti tiliöitäville tapahtumille on nimetty yksilöivät koodit, muille tapahtumille annetaan yleiskoodit. Koodien arvot ovat kaikilla pankeilla samat. Selitetekstit ovat pankkikohtaisia. Kirjausselitteen koodin arvot ovat: 700 = maksuliikepalvelu pano/otto 701 = toistuvaissuorituspalvelu pano/otto 702 = laskujen maksupalvelu otto 703 = maksupäätepalvelu pano 704 = suoraveloituspalvelu/automaattinen maksupalvelu pano/otto 705 = viitesuorituspalvelu pano 706 = maksupalvelu otto 710 = pano pano 720 = otto otto 721 = korttimaksu otto 722 = shekki otto 723 = taksibussiseteli otto 730 = palkkio otto 740 = korkoveloitus otto 750 = korkohyvitys pano 760 = laina (sisältäen lyhenyksen, koron ja palkkion) otto 761 = lainan lyhennys otto Korjauksissa koodeja käytetään sekä pano- että ottotapahtumalla. Kentässä 12 on kuittikoodi, joka ilmoittaa, ovatko tositetiedot tiliotteella vai liittyykö tapahtumaan erillinen paperikuitti tai konekielisenä annettava erittely yksittäisistä tapahtumista. Kuittikoodin arvot ovat: tyhjämerkki = Pankki ei toimita asiakkaalle tapahtumasta paperikuittia. E = Tapahtumaan liittyy erittely. P = Pankki toimittaa asiakkaalle tapahtumasta paperikuitin. Kentässä 13 on maksutoimeksiannon vastanottaneen pankin antama välitystapakoodi, joka kertoo miten maksutoimeksianto on välitetty pankkiin ja missä on alkuperäinen maksutoimeksianto. Selvittelytilanteissa välitystavan avulla päätellään, mihin otetaan yhteyttä, jos tapahtumasta tarvitaan lisää tietoa. Välitystavan arvon ollessa A selvittelypyyntö osoitetaan aina suoraan toimeksiantajalle. Muissa tilanteissa otetaan yhteyttä tilikonttoriin. Välitystapakoodin arvot ovat: A = Asiakas on lähettänyt maksun konekielisenä tai maksanut sen itsepalveluna. Alkuperäinen maksutoimeksianto on asiakkaalla. J = Tapahtuma on muodostettu pankin järjestelmässä. Perusteet sen syntyyn ovat selvitettävissä arkistointitunnuksen osoittaman järjestelmän selvittelypisteestä. K = Tapahtuma on tehty pankin konttorissa toimihenkilön tallentamana. Maksutoimeksianto löytyy arkistointitunnuksen perusteella.
OP-KESKUS LIITTYMÄKUVAUS 20/80 Kentässä 14 välitetään yksittäisellä tapahtumalla toisen osapuolen nimi aina, kun se on saatavissa. Tietoa ei ole koontitapahtumalla. Nimi on joko saajan nimi yksittäisellä maksajan tapahtumalla tai maksajan nimi saajan yksittäisellä tapahtumalla. Nimen lähde on vain sellaisella tapahtumalla, jolla on Saaja/Maksaja-tieto ja se ilmoittaa välitetyn saajan tai maksajan nimen alkuperän. Nimen lähde -tiedon arvot ovat: A = Nimitieto on saatu asiakkaan konekielisestä aineistosta tai se on asiakkaan itsepalveluna tallentama. J = Nimitieto on saatu pankin rekisteristä tilinumeron perusteella. K = Nimitiedon on tallentanut toimihenkilö pankin konttorissa. Kentässä 15 on maksajan tapahtumalla se saajan tilinumero, jonka maksajan pankki on tapahtumaa välittäessään sille antanut. Tiedon avulla maksaja voi tarkistaa, mille tilille maksu on osoitettu. Tili muuttunut -tieto liittyy vain saajan tilinumeroon ja se ilmoittaa maksajan alunperin antaneen tilin muuttuneen pankin järjestelmissä. Tili muuttunut -tiedon arvot ovat: tyhjämerkki = ei muutettu * = muutettu Tapahtuman lisätietue Kenttä Tiedon nimi Muoto Kuvaus 1 Aineistotunnus AN1 S 2 Tietuetunnus AN2 11 3 Tietueen pituus N3 4 Lisätiedon tyyppi AN2 5 Lisätieto ANnnn YHTEENSÄ 8+nnn Tapahtuman lisätietue muodostuu kaikille lisätietueille yhteisestä alkuosasta ja lisätiedosta, jonka pituus vaihtelee lisätiedon tyypin mukaisesti. Vapaa viesti, tyyppi = 00 5.1 Viesti - 1 AN35 5.2 Viesti - 2 AN35...... 5.12 Viesti - 12 AN35 YHTEENSÄ Max 420 Kpl-määrä, tyyppi = 01 5.1 Tapahtumien kpl-määrä N8 YHTEENSÄ 8 Laskutapahtuman tiedot, tyyppi = 02 5.1 Asiakasnumero AN10 5.2 Tyhjä AN1
OP-KESKUS LIITTYMÄKUVAUS 21/80 5.3 Laskun numero AN15 5.4 Tyhjä AN1 5.5 Laskun päiväys AN6 VVKKPP YHTEENSÄ 33 Korttitapahtuman tiedot, lisätiedon tyyppi = 03 5.1 Kortin numero AN19 5.2 Tyhjä AN1 5.4 Kaupan arkistoviite AN14 YHTEENSÄ 34 Korjaustapahtuman tiedot, tyyppi = 04 5.1 Korjattavan tapahtuman AN18 alkuperäinen arkistointitunnus YHTEENSÄ 18 Valuuttatapahtuman tiedot, lisätiedon tyyppi = 05 5.1 Vasta-arvo.1 Etumerkki AN1.2 Määrä N18 16 kok + 2 desim 5.2 Tyhjä AN1 5.3 Valuutan ISO-koodi AN3 5.4 Tyhjä AN1 5.5 Valuuttakurssi N11 4 kok + 7 desim 5.6 Kurssiviite AN6 YHTEENSÄ 41 Toimeksiantajan tiedot, tyyppi = 06 5.1 Toimeksiantajan tieto-1 AN35 5.2 Toimeksiantajan tieto-2 AN35 YHTEENSÄ 70 Pankin lisätiedot, tyyppi = 07 5.1 Lisätieto-1 AN35 5.2 Lisätieto-2 AN35...... 5.12 Lisätieto-12 AN35 YHTEENSÄ Max 420 Maksunaiheen tiedot, tyyppi = 08 5.1 Maksunaihekoodi N3 5.2 Tyhjä AN1 5.3 Maksunaiheen selite AN31 YHTEENSÄ 35 Nimitarkenteen tiedot, tyyppi = 09 5.1 Saajan/maksajan nimen AN35
OP-KESKUS LIITTYMÄKUVAUS 22/80 Saldotietue tarkenne YHTEENSÄ 35 Kenttä Tiedon nimi Muoto Kuvaus 1 Aineistotunnus AN1 S 2 Tietuetunnus AN2 40 3 Tietueen pituus N3 50 4 Kyselypäivä N6 VVKKPP 5 Kyselyhetken saldo.1 Etumerkki.2 Määrä 6 Käytettävissä oleva saldo.1 Etumerkki.2 Määrä AN1 N18 AN1 N18 YHTEENSÄ 50 16 kok + 2 desim 16 kok + 2 desim Tiedotetietue Tämä tietue välitetään asiakkaalle vain, jos kysely ei onnistu tai häiriöiden takia tiedot eivät ole ajantasalla. Kenttä Tiedon nimi Muoto Kuvaus 1 Aineistotunnus AN1 S 2 Tietuetunnus AN2 70 3 Tietueen pituus N3 4 Pankkiyhtymän tunnus AN3 5 Tiedote.1 Rivi - 1 (esim häiriön syy).6 Rivi - 6 AN80 AN80 YHTEENSÄ Max 489 2.10.4 Tilien saldoyhteenveto Pankkiyhteysohjelma voi kysyä tilien saldoyhteenvedon ohjaussanomalla $$TP1 1SY 0 X missä - 0 on merkki nolla - X on merkki X Saldoyhteenvedon vastausosa muodostuu yhdestä tai useammasta tietueesta, joista vain viimeisessä on mukana rahayksikön koodi. Tiedon nimi Pituus Selitys Asiakkaan nimi 15 Tilien lukumäärä tässä tietueessa 3
OP-KESKUS LIITTYMÄKUVAUS 23/80 Tuleeko saldotietueita lisää 1 0=ei tule, 1=tulee Tili ja saldo (0-n kpl) konttorinumero 6 tilinumero 8 saldo 11 etumerkki 1 +/- saldon pvm. 6 vvkkpp Varalla 78 Rahayksikön koodi 1 1=euro Tämä kenttä on mukana vain viimeisessä tietueessa. Sanoman tietuepituus vaihtelee. 2.10.5 Tilien laajennettu saldoyhteenveto Pankkiyhteysohjelma voi kysyä tilien laajennettua saldoyhteenvetoa ohjaussanomalla $$TP1 2SY Saldoyhteenvedon vastausosa muodostuu yhdestä tai useammasta tietueesta. Tiedon nimi Pituus Selitys Asiakkaan nimi 40 Tilien lukumäärä tässä tietueessa 3 Tuleeko saldotietueita lisää 1 0=ei tule, 1=tulee Tili ja saldo (0-n kpl) konttorinumero 6 tilinumero 8 saldo 13 11 kok. + 2 desim. saldon etumerkki 1 +/- nostovara 13 11 kok. + 2 desim. nostovaran etumerkki 1 +/- korkoprosentti 6 4 des. saldon pvm. 8 vvvvkkpp Sanoman tietuepituus vaihtelee. 2.10.6 Tilisiirto Pankkiyhteysohjelma voi tehdä tilisiirron omien tilien välillä ohjaussanomalla $$TP1 ES X vknro vtnro hknro htnro euromäärä viesti missä - X on merkki X - vknro veloitettava konttorinumero 6 merkin mittaisena - vtnro veloitettava tilinumero 8 merkin mittaisena - hknro hyvitettävä konttorinumero 6 merkin mittaisena
OP-KESKUS LIITTYMÄKUVAUS 24/80 - htnro hyvitettävä tilinumero 8 merkin mittaisena - euromäärä siirrettävä rahamäärä sentteinä ilman desimaalipistettä - viesti max 70 merkkiä pitkä lainausmerkkien välissä Esimerkki jossa siirretään 1500 euroa tililtä 500015-118 tilille 500015-22228 viestillä Mallitilisiirto $$TP1 ES X 500015 10000018 500015 20002228 150000 "Mallitilisiirto" Tilisiirron vastaussanoma Tiedon nimi Pituus Selitys Tietueen järjestysnumero 1 1 Vastaustyyppi 1 1=OK, muu=virhe* Varalla 3 Tapahtumakonttori 6 Päätenumero 2 Tapahtumanumero 4 Tilinomistajan nimi 15 Päivämäärä 6 ppkkvv Veloitettu konttorinumero 6 Veloitettu tilinumero 8 Veloitetun tilin saldo 11 sentteineen ilman desimaalipistettä Saldon etumerkki 1 +/- Hyvitetty konttorinumero 6 Hyvitetty tilinumero 8 Varalla 12 Siirretty euromäärä 11 sentteineen ilman desimaalipistettä Etumerkki 1 + Rahayksikön koodi 1 1=euro *) Virhevastauksen muoto on kuvattu liitteessä 3 2.10.7 Luoton saldokysely Pankkiyhteysohjelma voi kysyä luoton saldoa ohjaussanomalla $$TP2 1AL konttorinumero luottonumero X missä: - konttorinumero 6 merkin mittaisena - luottonumero 8 merkin mittaisena - X on merkki X. Luoton saldokyselyn vastaussanoman sanomarakenne Tiedon nimi Pituus Selitys Tietueen järjestysnumero 1 1 Vastaustyyppi 1 1=OK, muu=virhe*
OP-KESKUS LIITTYMÄKUVAUS 25/80 Varalla 3 Tapahtumakonttori 6 Päätenumero 2 Tapahtumanumero 4 Tilinomistajan nimi 15 Konttorinumero 6 Luottonumero 8 Luoton saldo 11 2 des. Saldon etumerkki 1 +/- Korkoprosentti 6 4 des. Koron eräpäivä 6 vvkkpp Lyhennyksen määrä 11 2 des. Lyhennyksen etumerkki 1 +/- Lyhennyksen eräpäivä 6 vvkkpp Rahayksikön koodi 1 1=euro *) Virhevastauksen muoto on kuvattu liitteessä 3 2.10.8 Luottojen saldoyhteenveto Pankkiyhteysohjelma voi kysyä luottojen saldoyhteenvedon ohjaussanomalla $$TP1 5SY 0 X missä - 0 on merkki nolla - X on merkki X Saldoyhteenvedon vastausosa muodostuu yhdestä tai useammasta tietueesta, joista vain viimeisessä on mukana rahayksikön koodi. Tiedon nimi Pituus Selitys Asiakkaan nimi 15 Luottojen lukumäärä tässä tietueessa 3 Tuleeko saldotietueita lisää 1 0=ei tule, 1=tulee Luotto ja saldo (0-n kpl) konttorinumero 6 luottonumero 8 saldo 11 etumerkki 1 +/- saldon pvm 6 vvkkpp korko % 6 4 des. lyhennyksen/koron eräpvm 6 vvkkpp koron rahamäärä 11 etumerkki 1 +/- luoton eräpvm 6 vvkkpp Varalla 13
OP-KESKUS LIITTYMÄKUVAUS 26/80 Rahayksikön koodi 1 1=euro Tämä kenttä on mukana vain viimeisessä tietueessa. 2.10.9 Valuuttatilien saldoyhteenveto Pankkiyhteysohjelma voi kysyä valuuttatilien saldoyhteenvedon ohjaussanomalla $$TP1 1VA X tilimuoto valuuttakoodi missä - X on merkki X - tilimuoto on AV-KP (=OP-valuuttatili), MTA (=määräaikainen OPvaluuttatili) tai ALL (=kaikki valuuttatilit) - valuuttakoodi on valuutan ISO-koodi (esim. USD) tai ALL (=kaikki valuutat) Saldoyhteenvedon vastausosa muodostuu yhdestä tai useammasta tietueesta, joista vain viimeisessä on mukana rahayksikön koodi. Tiedon nimi Pituus Selitys Asiakkaan nimi 15 Tilien lukumäärä tässä tietueessa 3 Tuleeko saldotietueita lisää 1 0=ei tule, 1=tulee Tili (0-n kpl) Konttorinro 6 Tilinumero 8 Tilimuoto 5 Valuuttakoodi 3 korko % 6 4 des. saldot (3 kpl) Valuuttamäärä 13 2 des. etumerkki 1 +/- Kirjauspäivä 6 ppkkvv Vasta-arvo 13 2 des. etumerkki 1 +/- Keskikurssi 10 7 des. Summien lukumäärä 2 Summat (0-n kpl) Yhteensä euroa 15 etumerkki 1 +/- Kirjauspäivä 6 ppkkvv Rahayksikön koodi 1 1=euro Tämä kenttä on mukana vain viimeisessä tietueessa. Tilejä lisää -kenttä saa arvon 1, mikäli sanomassa on lisää tilitietueita. Tietueessa on enintään kolmea tiliä koskevat tiedot. Tilejä koskevat
OP-KESKUS LIITTYMÄKUVAUS 27/80 yhteenvedot esitetään tietueittain; viimeisessä tietueessa ei siis ole koko sanoman saldoja yhteensä, vaan ne on laskettava erikseen jokaiselta tietueelta. Jokaisessa tilitietueessa on kolme saldoa, joissa on esitetty mahdolliset tulevien kirjauspäivien saldot. Puuttuvan saldon kirjauspäivämääräkentässä on nollaa 2.10.10 Ajantasainen pikamaksu Lähetettävä pikamaksusanoma Pikamaksusanoma on tiedosto, joka sisältää yhden tietueen. Tietueessa on osuuspankin eräsiirtopalvelun vaatima ohjauskomento, pikamaksun tiedot ja näistä PATU-standardin mukaan laskettu MAC-tarkiste ks. PATUjärjestelmäkuvaus, Suomen Pankkiyhdistys. Tarkiste lasketaan käyttöavaimella tietueen alusta tarkistekenttään asti kuten muissakin PATU-sanomissa (ESI, SUO, VAR ja PTE). Tiedon nimi Pituus Selitys Ohjauskomento 11 $$TP4 PS01 Maksajan konttori 6 5nnnnn Maksajan tilinumero 8 Maksajan nimi 30 Saajan konttori 6 Saajan tilinumero 8 Saajan nimi 30 Siirrettävä rahamäärä 14 Euroina tai sentteinä, ks. alla Rahayksikkökoodi 1 1 euro Eräpäivä 10 pp.kk.vvvv, toistaiseksi tyhjä Viite 20 Etunollatäyttö Viesti 140 Paperikuitti maksajalle 1 E, ei kuitteja toistaiseksi Ilmoitus saajalle 1 0 ei ilmoitusta 1 puhelin 2 fax 9 muu Saajan yhteystiedot 70 Saajan yhteystiedot, kun ilmoitetaan saajalle, muuten tyhjä Aikaleima 15 Vvkkppttmmssnnn, yksilöllinen Sanomaversio 1 1 Käyttöavaimen sukupolvi 1 0.. 9 Tarkiste 16 Patu-standardin mukainen MAC-tarkiste heksadesimaalina Vastaanotettava pikamaksukuittaus
OP-KESKUS LIITTYMÄKUVAUS 28/80 Pikamaksukuittaus on tiedosto, jossa on kaksi tietuetta; kuittaustietue ja osuuspankin eräsiirtopalvelun tapahtuman päättymistietue ($$EOF). Pikamaksukuittaus saattaa olla myös pelkkä osuuspankin eräsiirto-palvelun $$ERROR-virhevastaus esim. PERMISSION ERROR tai NO RESPONSE FROM HOST. Pankkiyhteysohjelman on varauduttava pikamaksussa normaalia pitempään vasteaikaan; noin 120 sekuntia (tapahtuma voidaan käsitellä muussa rahalaitoksessa). Jos kuittausta ei saada osuuspankin eräsiirtopalvelusta tai se on $$ERROR - NO RESPONSE FROM HOSTvirhevastaus, pitää pankkiyhteysohjelman pyytää käyttäjää ottamaan yhteyttä pankkiinsa tai tarkistamaan esim. tapahtumakyselyn avulla onnistuiko pikamaksu. Jos tilillä on pikamaksua vastaava tapahtuma, pikamaksu on onnistunut. Kuittaustietueelle on laskettu MAC-tarkiste PATU-standardin mukaan ks. PATUjärjestelmäkuvaus, Suomen Pankkiyhdistys. Tarkiste lasketaan käyttöavaimella kuittaustietueen alusta tarkistekenttään asti kuten muissakin PATU-sanomissa (ESI, SUO, VAR ja PTE). Tiedon nimi Pituus Selitys Onnistumiskoodi 2 00 Onnistui muut numeroarvot ovat virheitä, jolloin seliteteksti kertoo syyn esim. HYLÄTTY, KATE EI RIITÄ. Seliteteksti 80 Seliteteksti, asiakkaan kielellä Arkistointitunnus 22 Jos onnistui, muuten tyhjä Aikaleima 15 Vvkkppttmmssnnn Sanomaversio 1 1 Käyttöavaimen sukupolvi 1 0.. 9 Tarkiste 16 Patu-standardin mukainen MAC-tarkiste heksadesimaalina 2.10.11 Konsernitilikysely Pankkiyhteysohjelma voi kysyä konsernitilin saldon, otot sekä panot ohjaussanomalla $$TP1 2KS konttorinumero tilinumero X missä - konttorinumero 6 merkin mittaisena - tilinumero 8 merkin mittaisena - X on merkki X.
OP-KESKUS LIITTYMÄKUVAUS 29/80 Konsernitilikyselyn vastausosa Tiedon nimi Pituus Selitys Tietueen järjestysnumero 1 1 Vastaustyyppi 1 1=OK, muu=virhe* Varalla 3 Tapahtumakonttori 6 Päätenumero 2 Tapahtumanumero 4 Tiliomistajan nimi 15 Konsernikonttorinumero 6 Konsernitilinumero 8 Päiväys 6 ppkkvv Saldo 13 2 des. Etumerkki 1 +/- Päivän otot 13 2 des. Etumerkki 1 +/- Päivän panot 13 2 des. Etumerkki 1 +/- Rahayksikön koodi 1 1=euro *) Virhevastauksen muoto on kuvattu liitteessä 3 2.11 Yhteyden lopetussanoma Pankkiyhteysohjelmisto pyytää osuuspankin eräsiirtopalvelua päättämään yhteyden lähettämällä sanoman $$LOGOFF Seuraavaksi pankkiyhteysohjelman täytyy noutaa osuuspankin eräsiirtopalvelusta BYE-kuittaus. $$BYE PP.KK.VVVV HH:MM:SS yhteystunnus missä - PP.KK.VVVV = päivämäärä - HH:MM:SS = yhteyden purkamisen ajankohta - yhteystunnus = yhteyden tunnus Tämän jälkeen pankkiyhteysohjelma katkaisee fyysisen yhteyden protokollatasolla.
OP-KESKUS LIITTYMÄKUVAUS 30/80 3 ESIMERKKEJÄ "VUOROPUHELUISTA" 3.1 Toistuvaissuoritusten lähetys Pankkiyhteysohjelma Osuuspankin eräsiirtopalvelu ESI-SANOMA ------------------------------------------------------------------------------------> ESI-KUITTAUS <------------------------------------------------------------------------------------ $$FILE ------------------------------------------------------------------------------------> SUO-SANOMA ------------------------------------------------------------------------------------> data ------------------------------------------------------------------------------------> VAR-SANOMA ------------------------------------------------------------------------------------> IN,TS0616.001 $$EOF CHECKSUM/1200000/ ------------------------------------------------------------------------------------> PTE-SANOMA <------------------------------------------------------------------------------------ $$LOGOFF ------------------------------------------------------------------------------------> $$BYE 16.06.2000 12:34:56 OPLA::000021 <------------------------------------------------------------------------------------ 3.2 Tapahtumaluettelon vastaanotto Pankkiyhteysohjelma Osuuspankin eräsiirtopalvelu ESI-SANOMA ------------------------------------------------------------------------------------> ESI-KUITTAUS <------------------------------------------------------------------------------------ $$FILE OUT,TL9999.999 ------------------------------------------------------------------------------------> data <------------------------------------------------------------------------------------ $$EOF TL9999.999 126 RECORDS <------------------------------------------------------------------------------------
OP-KESKUS LIITTYMÄKUVAUS 31/80 $$LOGOFF ------------------------------------------------------------------------------------> $$BYE 16.06.2000 01:25:42 OPLB::000009 <------------------------------------------------------------------------------------ 3.3 Tapahtumakysely Pankkiyhteysohjelma Osuuspankin eräsiirtopalvelu ESI-SANOMA ------------------------------------------------------------------------------------> ESI-KUITTAUS <------------------------------------------------------------------------------------ $$TP1 2ST 500015 10000018 X ------------------------------------------------------------------------------------> data <------------------------------------------------------------------------------------ $$EOF <------------------------------------------------------------------------------------ $$LOGOFF ------------------------------------------------------------------------------------> $$BYE 16.06.2000 10:54:02 OPLA::000037 <------------------------------------------------------------------------------------ 3.4 Palvelukeskus hoitaa kahden eri asiakkaan pankkiyhteyden samalla yhteydellä Pankkiyhteysohjelma Osuuspankin eräsiirtopalvelu ESI-SANOMA ------------------------------------------------------------------------------------> ESI-KUITTAUS <------------------------------------------------------------------------------------ $$FILE OUT,TI9999.999 ------------------------------------------------------------------------------------> data <------------------------------------------------------------------------------------ $$EOF TI9999.999 21 RECORDS <------------------------------------------------------------------------------------ ESI-SANOMA ------------------------------------------------------------------------------------>
OP-KESKUS LIITTYMÄKUVAUS 32/80 ESI-KUITTAUS <------------------------------------------------------------------------------------ $$FILE OUT,TI9999.999 ------------------------------------------------------------------------------------> data <------------------------------------------------------------------------------------ $$EOF TI9999.999 15 RECORDS <------------------------------------------------------------------------------------ $$FILE OUT,TL9999.999 ------------------------------------------------------------------------------------> $$ERROR - FILE NOT EXISTENT <------------------------------------------------------------------------------------ $$LOGOFF ------------------------------------------------------------------------------------> $$BYE 16.06.2000 06:32:02 OPLA::000037 <------------------------------------------------------------------------------------
OP-KESKUS LIITTYMÄKUVAUS 33/80 4 OSUUSPANKIN ERÄSIIRTOPALVELUN KÄYTTÖÖNOTTO 4.1 Sopimukset ja käyttäjätunnukset Asiakas tekee sopimuksen palvelun käyttöönotosta osuuspankissa. Samalla asiakas saa yhden tai useamman käyttäjätunnuksen. Lähetetyt aineistot ovat käyttäjätunnuskohtaisia, mutta noudettavat aineistot ovat yhteisiä saman sopimuksen eri käyttäjätunnuksille. Käyttäjätunnuksen pituus on vähintään 6 merkkiä ja enintään 12 merkkiä. Asiakas saa sopimuksen teon jälkeen käyttäjätunnukset mukaansa. Osuuspankkikeskuksesta postitetaan kahtena peräkkäisenä päivänä siirtoavaimen osat 1 ja 2, jotka kohdistetaan käyttäjätunnukseen sen kolmen viimeisen merkin avulla (ks. PATU-standardi). 4.2 PATU avaimet pankkiyhteysohjelmassa OP-Keskus postittaa säännöllisin väliajoin uuden sukupolven siirtoavaimen, jonka käyttäjä päivittää pankkiyhteysohjelmaan. Siirtoavaimen vaihto ei saa vaikuttaa voimassaolevaan käyttöavaimeen. Pankkiyhteysohjelma luo vain ensimmäisen 0-sukupolven käyttöavaimen voimassaolevalla siirtoavaimella. Osuuspankin eräsiirtopalvelu toimittaa säännöllisin väliajoin tai pankkiyhteysohjelman pyynnöstä uuden sukupolven käyttöavaimen, jonka pankkiyhteysohjelma ottaa käyttöön automaattisesti. Käyttöavaimen vaihto ei saa vaikuttaa siirtoavaimeen. Pankkiyhteysohjelmassa pitää olla mahdollisuus luoda uusi 0-sukupolven käyttöavain tuoreimmalla siirtoavaimella (ns. käyttöavaimen nollaus). Pankkiyhteysohjelma voi pyytää käyttöavaimen vaihtojakson katkaisua, jolloin edellisen sukupolven käyttöavainta ei enää voi käyttää. Pankkiyhteysohjelmassa pitää olla mahdollisuus nähdä käytössä olevista siirtoja käyttöavaimista kohdistin, sukupolvi, tarkiste ja käyttöönottopäivä. 5 TESTAUS Käyttöönotettaville palveluille voidaan suorittaa testaus ennen tuotantokäyttöä. Testaus suoritetaan lähettämällä aineistoja testikäyttäjä-tunnuksella. Linjayhteyden toimivuutta voidaan testata vastaanottamalla testikäyttäjätunnuksella esim. valuuttakurssit. Testiaineiston luonti on kerrottu osuuspankin eräsiirtopalvelun asiakasohjeessa. Osuuspankin eräsiirtopalveluun on perustettu testausta varten kaksi Malliyrityskäyttäjää, joiden tiedot ovat seuraavat: Käyttäjä: Malliyritys1 Käyttäjätunnus: 82874796
OP-KESKUS LIITTYMÄKUVAUS 34/80 PATU kohdistin: 796 Sukupolvi: 0 Siirtoavainosa 1: A1 CE E0 C8 15 DA 20 46 Siirtoavainosa 2: 9E 7A E3 B5 2F BF F4 97 Avaintarkiste: 8C DC 7A Käyttäjä: Malliyritys2 Käyttäjätunnus: 56224608 PATU kohdistin: 608 Sukupolvi: 0 Siirtoavainosa 1: 9E 5B 98 94 80 61 0E 97 Siirtoavainosa 2: 58 C4 97 DF 70 B6 AE DC Avaintarkiste: 7E BD B5 Tilit: 500046-20001629 500032-10002229 Valuuttatilit: 584102-30111504 gbp 584102-30103717 usd 584102-30950307 eur Malliyritykselle on valmiina noudettavia aineistoja mm. tilioteaineisto ja viiteaineisto. Ajantasaisen luettelon noudettavista aineistoista saa noutamalla tiedoston FILES.OUT. Ajantasaisen luettelon käytettävissä olevista tileistä saa tekemällä kyselyn 1SY, 5SY tai 1VA. 6 VIRHEILMOITUKSET Osuuspankin eräsiirtopalvelu lähettää tiedonsiirtoyhteyden aikana virhetilanteissa seuraavia virheilmoituksia INVALID CONTROL MESSAGE pyydetyn palvelun ohjaussanoma virheellinen MESSAGE SEQUENCE ERROR sanomajärjestys virheellinen UNCLASSIFIED ERROR määrittelemätön virhe FILE NOT EXISTENT pyydettyä tiedostoa ei ole saatavilla FILE OPENING FAILED tiedoston avaus epäonnistui BAD DISK READ STATUS tiedoston lukuvirhe PERMISSION ERROR asiakkaalla ei ole valtuuksia suorittaa pyydettyä palvelua INPUT MESSAGE OVERFLOW syöttösanomavirrassa ylivuoto INVALID DATA;FILE DISCARDED aineistossa virheitä, yleisin syy on tarkistussummavirhe tai aineiston esitarkistuksessa havaittu virhe INPUT FILE PROTECTED samanniminen tiedosto otettu vastaan aikaisemmin ja siirretty jatkokäsittelyyn NO RESPONSE FROM HOST yhteys ajantasapalveluun suljettu ONLINE SYSTEM CLOSED yhteys ajantasapalveluun suljettu NO OK RESPONSE FROM HOST hyväksyttyä ajantasavastausta ei saada TRANSACTION NOT DEFINED virheellinen ajantasakyselyn palvelupyyntö
OP-KESKUS LIITTYMÄKUVAUS 35/80 7 PATUN ILMOITUSKOODIT SEKÄ NIITÄ VASTAAVAT TEKSTIT 0010 "PATU-KÄYTTÄJÄ LUKITTU" 0012 "KÄYTTÄJÄTUNNUKSEN VOIMASSAOLOAIKA PÄÄTTYNYT" 0013 "PANKKIYHTEYSOHJELMA VANHENTUNUT" 0997 " AINEISTO HYLÄTTY SISÄLTÖVIRHEEN TAKIA" 0998 "EI SALLITTU KÄYTTÖAIKA" 0999 "OPNET-VIESTI KULTALINKKI-OHJELMILLE" 1001 "HYVÄKSYTTY" 1002 "HYVÄKSYTTY, AVAINVAIHTO" 1003 "HYVÄKSYTTY, AVAINVAIHTO HYVÄKSYTTY" 1004 "HYVÄKSYTTY, AVAINVAIHTO HYLÄTTY" 1005 "HYVÄKSYTTY, AVAINVAIHTO LIIAN USEIN" 1010 "MUOTOVIRHE KENTÄSSÄ NNN VVV" 1011 "ARVOVIRHE KENTÄSSÄ NNN VVV" 1012 "VERSIO ON LIIAN VANHA" 1013 "SIIRTOAVAIN EI OLE VOIMASSA" 1014 "KÄYTTÖAVAIN EI OLE VOIMASSA" 1015 "PÄIVÄYS ON LIIAN VANHA" 1016 "PÄIVÄYS ON ETEENPÄIN" 1017 "KERTA-AVAIN ON JO KÄYTETTY" 1018 "AIKALEIMA ON JO KÄYTETTY" 1019 "TIIVISTE EI TÄSMÄÄ" 1020 "TARKISTE EI TÄSMÄÄ" 1021 "VASTAANOTTAJA ON VÄÄRIN" 1022 "ESI-AIKALEIMAT EIVÄT TÄSMÄÄ" 1023 "SUO-SANOMA PUUTTUU" 1024 "VAR-SANOMA PUUTTUU" 1025 "SUOJAUSOIKEUTTA EI OLE" 1026 "KENTTÄ NNN: SUO-SANOMA<>VAR-SANOMA" 1027 "KENTTÄ NNN: SUO-SANOMA<>PTE-SANOMA" 1028 "KENTTÄ TIIVISTE: VAR-SANOMA<>PTE-SANOMA" 1029 "PTE-SANOMA PUUTTUU" 1030 "KÄYTTÖAVAIMEN PARITEETTI EI TÄSMÄÄ" 1031 "KERTA-AVAIMEN PARITEETTI EI TÄSMÄÄ" 1032 "TURVASANOMA LIIAN LYHYT" 1033 "ASIAKASTUNNUS VIRHEELLINEN" 1034 "JÄRJESTELMÄVIRHE" 1035 "PATUN KÄYTÖSTÄ EI OLLA SOVITTU" 1036 "HYVÄKSYTTY, VAIHTOJAKSO KATKAISTU" 1037 "HYVÄKSYTTY, VAIHTOJAKSON KATKAISU HYLÄTTY" Kentännumero NNN on neljä numeroa pitkä. Virheellisen kentän sisältö VVV on max 30 merkkiä pitkä. 8 PANKKIYHTEYSOHJELMISTON LÄHETTÄMÄT AINEISTOT 8.1 Laskujen maksupalvelu Laskujen maksupalvelulla maksetaan tilisiirtojen lisäksi myös maksuosoituksia.
OP-KESKUS LIITTYMÄKUVAUS 36/80 Maksuosoitus on maksu, jossa saajantilinumeron sijaan välitetään maksu saajalle saajan jakeluosoitteen, postitoimipaikan ja postinumeron perusteella. Maksuosoituspalvelun käyttäminen vaatii erillisen sopimuksen pankin kanssa. Aineistotunnus on MP. Erätietue: Erätietue on aineiston ensimmäinen tietue. Se muodostetaan, kun joku seuraavista tiedoista vaihtuu: - maksajan tunnus - maksajan tilinumero - eräpäivä - maksajan nimitarkenne - erän yksilöintitieto - rahayksikön koodi Erätietueen rahayksikön koodi määrittelee koko aineiston maksutapahtumien ja erittelytapahtumien rahamäärien rahayksikön. 1 Aineistotunnus AN4 P 'LM03' 2 Tietuetunnus N1 P '0' 3 Tapahtumalaji N1 P '0' 4 Maksajan tilinumero N14 P 5 Maksatustunnus N9 P 6 Tiedoston luontipäivä N6 P vvkkpp 7 Tiedoston luontiaika N4 P hhmm 8 Vastaanottava rahalaitos AN2 P = 5 9 Eräpäivä N6 P vvkkpp 10 Maksajan nimitarkenne AN35 V 11 Erän yksilöintitieto AN35 V 12 OVT-tunnus AN17 V 13 Rahayksikön koodi AN1 P 1=euro 14 Varalla AN65 V 15 Pankkikohtainen varaus AN100 V Yhteensä 300 Kenttä 4: on maksajan tilinumero konekielisessä muodossa 14 merkin mittaisena. Kenttä 9: on eräpäivä, jolloin maksaja on tarkoittanut maksut maksettavaksi. Kenttä 10: Nimitarkenne välittyy maksajan ja saajan tiliotteelle. Kenttä 11: Erän yksilöintitieto palaa maksajalle tiliotteella veloitustapahtuman toimeksiantajan tietona. Kenttä 13: Kerrotaan rahayksikön koodi: 1 = maksut maksetaan euroina
OP-KESKUS LIITTYMÄKUVAUS 37/80 Kenttä 15: Sisältö selviää kunkin pankin omista kuvauksista. Maksutapahtuman tietue: 1 Aineistotunnus AN4 P LM03 2 Tietuetunnus N1 P 1 3 Tapahtumalaji N1 P 0 4 Maksajan tilinumero N14 P 5 Saajatarkenne-1 AN30 P 6 Saajatarkenne-2 AN20 V Ei käytetä maksuosoituksessa 7 Saajatarkenne-3 AN20 V Maksuosoitus kt. tarkennus 8 Saajan tilinumero N14 P Maksuosoitus kt. tarkennus 9 Maksun aihe AN3 V 10 Viestin tyyppi N1 P 1, 2, 5, 6,7 11 Viesti AN70 P 12 Varalla AN2 V 13 Eräpäivä AN6 V 14 Rahamäärä N12 P 2 des. 15 Varalla AN1 V 16 Varalla AN4 V 17 Varalla AN12 V 18 Sisäinen tieto AN20 V 19 Kustannuspaikka AN20 V 20 Postinumero AN5 V Pakollinen maksuosoituksessa 21 Postitoimipaikka AN10 V Pakollinen maksuosoituksessa 22 Saajan jakeluosoite AN30 V Pakollinen maksuosoituksessa Yhteensä 300 Kenttä 3: Tapahtumalajin arvo on: 0 = maksu Kentät 5, 6 ja 7: Yksilöivät saajan. Saajatarkenne-1 on saajan nimi. Saajatarkenne-2 on toimeksiantajan antamaa tietoa, kuten toimittajan nimi rahoitusyhtiöille osoitetuissa laskuissa tai saajan lähiosoite. Tämä kenttä ei ole käytössä maksuosoituksessa Saajarakenne-3 on toimeksiantajan antamaa tietoa, kuten saajan ly-tunnus tai saajan postinumero ja postitoimipaikka. Ly-tunnus kirjoitetaan kentän 7 vasempaan laitaan. Loppu jätetään tyhjäksi. Maksuosoituksella tähän kenttään laitetaan henkilötunnus (hetu) tai Ly-tunnus. Tieto on vapaaehtoinen, mutta suositeltava, jotta saaja pystytään yksilöimään mahdollisimman tarkasti.
OP-KESKUS LIITTYMÄKUVAUS 38/80 Kenttä 8: On saajan tilinumero konekielisessä muodossa 14 merkin mittaisena. Mikäli tapahtuma on maksuosoitus, niin saajan tilinumeroksi annetaan aina konekielisessä muodossa 59999999999991 Kenttä 10: On viestin tyyppi, jonka arvot ovat: 1 = Viite 2 = Laskun tiedot 5 = 70 merkin pituinen vapaa viesti 6 = pitkä viesti, joka voi olla korkeintaan 420 merkkiä (= 12 * 35) 7 = veroviesti Maksuosoituksessa voi käyttää vain viestityyppejä 1 tai 5, 6, 7 mukaisia viestejä. Maksuosoituksessa tämä viesti näkyy myös saajan postitse saamassa lunastusilmoituksessa. Jos maksuosoitusta ei lunasteta, niin tämä viesti tulee palautukseen yksilöintitiedoksi. Jos palautukset tulevat viitepalvelun kautta, vain viite voidaan näyttää palautuksen yksilöintitietona. Kun viestissä käytetään viestityyppejä 5,6 tai 7, käytetään palautustapahtuman viestin 40 viimeisintä merkkiä maksuosoituksen saajan nimen näyttämiseen. Palautus tapahtuman viestin enimmäispituus on aina 40 merkkiä lyhyempi kuin maksajan lähettämän viestin. Kenttä 11: Sisältö pitää muodostaa viestin tyypin mukaan. Viestin Viestirivin muoto Kuvaus tyyppi 1 N20, 50 tyhjää Viite etunollilla täydennettynä 2 AN10,AN15,N6, 39 tyhjää Asiakasnumero, laskun numero ja laskun päiväys 5 AN35, AN35 Viesti 6 AN35, AN35 Pitkän viestin alku 7 N20, 15 tyhjää, AN35 Viite ja viestin alku Kentät 18 ja 19: On varattu maksajan omiin tietoihin ja ne palautuvat maksajalle toimeksiantajan tietoina tiliotteella tai erillisellä palautteella: Kenttä 20: On pakollinen, kun maksu on maksuosoitus. Kenttää annetaan saajan postinumero. Postinumeron numeerisuus tarkistetaan. Kenttä 21: On pakollinen, kun maksu on maksuosoitus. Kenttään annetaan saajan postitoimipaikan nimi. Kenttä 22: On pakollinen, kun maksu on maksuosoitus. Kenttään annetaan saajan jakelusoite.
OP-KESKUS LIITTYMÄKUVAUS 39/80 Erittelytapahtuman tietue: Jos yhteen maksutapahtumaan liittyy hyvitys- ja tavallisia laskuja, on ko. tiedot erittelytapahtumilla. - Erittelytapahtumat seuraavat maksutapahtumaa tai maksutapahtuman viestejä. - Saajan tilinumeron tulee olla sama kuin maksutapahtumalla. Irralliset erittelytapahtumat hylätään. - Erittelytapahtumalla voi olla yksi tai useampia viestejä samoin kuin maksutapahtumallakin. - Kun maksutapahtumassa on veroviesti tai viite, erittelytapahtumia ei voi käyttää. - Pankin käsittelyssä erittelytapahtuman rahamäärien yhteissummaa ei verrata maksutapahtuman rahamäärään. - Tapahtuman rahamäärän yksikkö määräytyy erätietueen rahayksikön koodin mukaan. - Maksuosoituksiin ei tallenneta erittely- eikä viestitapahtumien tietoja 1 Aineistotunnus AN4 P LM03 2 Tietuetunnus N1 P 2 3 Tapahtumalaji N1 P 0,2 4 Varalla AN14 V 5 Saajatarkenne-1 AN30 P 6 Saajatarkenne-2 AN20 V 7 Saajatarkenne-3 AN20 V 8 Saajan tilinumero N14 P 9 Maksun aihe AN3 V 10 Viestin tyyppi N1 P 1, 2, 5, 6 11 Viesti AN70 P 12 Varalla AN2 V 13 Varalla AN6 V 14 Rahamäärä N12 P 2 desim. 15 Varalla AN1 V 16 Varalla AN4 V 17 Varalla AN12 V 18 Sisäinen tieto AN20 V 19 Kustannuspaikka AN20 V 20 Varalla AN5 V 21 Pankkikohtainen varaus AN40 V Yhteensä 300 Kenttä 3: Tapahtumalajin arvot ovat 0 = lasku ja 2 = hyvityslasku. Jos kentän 8 saajan tilinumero ei ole maksutapahtumia, erittelythylätään irrallisina erittelyinä.
OP-KESKUS LIITTYMÄKUVAUS 40/80 Viestitietue: Viestitietueen pitää seurata sitä maksutapahtuman tai erittelytapahtuman tietuetta, johon se liittyy. Viestitietue voi olla vain tapahtumilla, joiden viestityyppi on 6 (pitkä viesti) tai 7 (veroviesti). Viestityyppiin 6 (pitkä viesti) voi liittyä yksi tai kaksi viestitietuetta. Viestityyppiin 7 (veroviesti) voi liittyä vain yksi viestitietue. Jos viestitietueen kentän 8 saajan tilinumerolla ei ole vastaavia maksu- tai erittelytapahtumia, viestitietueet hylätään irrallisina viesteinä. 1 Aineistotunnus AN4 P LM03 2 Tietuetunnus N1 P 1, 2 3 Tapahtumalaji N1 P 9 4 Varalla AN14 V 5 Varalla AN30 V 6 Varalla AN20 V 7 Varalla AN20 V 8 Saajan tilinumero N14 P 9 Viesti-1 AN35 P 10 Viesti-2 AN35 V 11 Viesti-3 AN35 V 12 Viesti-4 AN35 V 13 Viesti-5 AN35 V 14 Varalla AN21 V Yhteensä 300 Kenttä 2: Tietuetunnuksen arvot ovat: Summatietue: 1 = maksutapahtuman viesti 2 = erittelytapahtuman viesti 1 Aineistotunnus AN4 P LM03 2 Tietuetunnus N1 P 9 3 Tapahtumalaji N1 P 0 4 Maksajan tilinumero AN14 P sama kuin erätietueella 5 Maksajan liiketunnus N9 V 6 Tiedoston luontipäivä N6 P sama kuin erätietueella 7 Maksujen kappalemäärä N6 P 8 Maksujen rahamäärä N13 P 2 desim. 9 Varalla AN6 V 10 Varalla AN13 V 11 Varalla AN6 V 12 Erän yksilöintitieto AN35 V sama kuin erätietueella 13 OVT-tunnus AN17 V
OP-KESKUS LIITTYMÄKUVAUS 41/80 14 Varalla AN69 V 15 Pankkikohtainen varaus AN100 V Yhteensä 300 8.2 Toistuvaissuoritukset Aineistotunnus on TS. Tapahtumatietue: 1 Tietuetunnus N1 P = 1 2 Määräpäivä N6 P vvkkpp 3 Varalla AN2 V 4 Saajan tilinumero N14 P 5 Maksatustunnus N9 P 6 Maksunaihekoodi N2 P 7 Rahamäärä N11 P 2 desim. 8 Maksun saajan nimi AN19 P 9 Maksun saajan henkilötunnus AN11 P 10 Varalla AN5 V 80 Kenttä 2: määräpäivä on se päivä, jolloin suorituksen on oltava nostettavissa saajan pankissa. Yksittäisen aineiston määräpäivä saa olla enintään 60 päivän kuluttua. Kenttä 5: maksaja yksilöidään maksatustunnuksella. Maksatustunnuksena käytetään pankin kanssa sovittua 9 merkin mittaista tunnusta. Kenttä 6: maksunaihekoodi: 10 Palkka 15 Palkkio 17 Koulutustuki 18 Avustus 20 Eläke 30 Korvaus 31 Vakuutuskorvaus 34 Asumistuki 36 Apuraha 50 Puutavaratilitys 51 Vakuustalletus 55 Osinkotulo 56 Korkotulo 60 Maatilatulo 61 Maitotilitys 62 Viljatilitys 63 Teurastilitys 64 Turkistilitys 68 Maataloustilitys 90 Muut
OP-KESKUS LIITTYMÄKUVAUS 42/80 Kenttä 7: rahamäärä ilmoitetaan käyttäen etunollatäyttöä. Kaikkien toistuvaissuoritusten tulee olla panoja. Kenttä 8: maksun saajan nimi. Sukunimi ilmoitetaan ensin. Sukunimen ja etunimen väliin jätetään yksi tyhjä merkki. Kenttä täytetään vasemmalta ja loput merkit jätetään tyhjiksi. Kenttä 11: saajan henkilötunnukseen suositellaan tallennettavaksi aina virallinen henkilötunnus. Ellei henkilötunnusta tiedetä, käytetään yrityksen omaa henkilönumeroa tms. Henkilötunnus tallennetaan kenttään vasemmalta alkaen ilman yhdysmerkkiä. Jos käytetään muuta kuin henkilötunnusta esim. henkilötai eläkenumeroa, osoitetaan se merkitsemällä numero 9 kentän ensimmäiseksi merkiksi ja väliin jätetään tarvittaessa tyhjää. Virallisen henkilötunnuksen käyttö palvelee maksajaa tilinumeroiden ylläpidossa. Kentät 3 ja 10 ovat varalla. Kenttää 10 voi tarvittaessa käyttää pankin ja maksajan sopimalla tavalla. Tapahtumat lajitellaan tietokenttien mukaan seuraavaan järjestykseen: 5 = maksatustunnus 2 = määräpäivä 6 = maksunaihekoodi 1 = tietuetunnus 4 = tilinumero Summatietue: 1 Tietuetunnus N1 P = 4 2 Maksupäivä N6 P = 999999 3 Varalla AN16 V 4 Maksatustunnus N9 P 5 Maksunaihekoodi N2 P 6 Maksatustunnuskohtainen N11 P 2 desim. rahamäärä 7 Rahayksikön koodi AN1 P 1=euro 8 Varalla AN18 V 9 Maksatustunnuskohtainen N6 P kpl-määrä 10 Toimeksiantaja AN10 V Maksajan tiliotteelle 80 Kappale- ja rahamäärät lasketaan tapahtumatietueilta. Summatietue muodostetaan aina maksajatunnuksen, maksupäivän, maksunaihekoodin tai rahayksikön koodin muuttuessa. 8.3 Suoraveloitus Erätietue: Aineistotunnus on SV.
OP-KESKUS LIITTYMÄKUVAUS 43/80 1 Tietuetunnus N1 P 0 = erätietue 2 Tietueen järjestysnumero N6 P 0 3 Kirjoituspäivä N6 P vvkkpp 4 Ajon aloitusajankohta N4 P hhmm 5 Laskuttajan palvelutunnus AN9 P 6 Vastaanottavan pankkiryhmän AN3 P 5 ja kaksi tyhjää tunnus 7 Rahayksikön koodi AN1 P 1=euro 8 Varalla AN90 120 Tapahtumatietue: 1 Tietuetunnus AN1 P 3 = suoraveloitus 2 Tietueen järjestysnumero N6 P 3 Tapahtuman tyyppikoodi N2 P 50 = veloituspyyntö 4 Eräpäivä N6 P vvkkpp 5 Käsittelytunnus N1 P 0 = veloituspyyntö 1= peruutus 6 Maksajan tilinumero N14 P 7 Rahamäärä N11 P 2 desim. 8 Maksun aihe AN3 V ks. maksunaiheluettelo 9 Laskuttajan tilinumero N14 P 10 Maksajan nimi AN19 V 11 Viite N20 P 12 Viesti AN23 V 120 Suoraveloituksen maksunaiheluettelo: 70 Vuokra 71 Sähkömaksu 72 Vesimaksu 73 Puhelinmaksu 74 Vakuutusmaksu 75 Lääkärimaksu 76 Sairaalamaksu 77 Koulumaksu 78 Lehtimaksu 79 Jäsenmaksu 80 Vero 81 Liikevaihtovero 82 Työnantajasuoritus 83 Lupamaksu 84 Osamaksu 85 Factoring-maksu 86 Luottokortti- ja osamaksu 89 Lasku 90 Muu
OP-KESKUS LIITTYMÄKUVAUS 44/80 Summatietue: 1 Tietuetunnus AN1 P 9 = summatietue 2 Tietueen järjestysnumero N6 P 3 Tapahtuman tyyppikoodi N2 P 50 = veloituspyyntö 4 Tapahtumien kpl-määrä N6 P 5 Tapahtumien rahamäärä N12 P 2 desim. 6 Peruutustapaht. kpl-määrä N6 P 7 Peruutustapaht. rahamäärä N12 P 2 desim. 8 Varalla AN75 120 8.4 Lähtevät ulkomaanmaksut Aineistotunnus on LU. Erätietue: Erätietue on tiedoston ensimmäinen tietue, joka sisältää tiedoston yksilöintitiedot. 1 Sovellustunnus AN4 P LUM2 2 Tietuetunnus N1 P 0 3 Aineistolaji N1 P 0 4 Varalla AN1 5 Asiakastunnus AN11 P 6 Asiakastunnuksen lisäosa AN5 00000-00999 7 Varalla AN2 8 Varalla AN1 9 Aineiston luontiaika N10 P VVKKPPHHMM 10 Maksupäivä N8 P VVVVKKPP 11 Varalla AN556 600 Kenttä 5: Asiakastunnus - LY-tunnus normaalimuodossa väliviivalla esim.0123456-7 - HETU normaalimuodossa esim. 111111A111C Kenttä 6: Asiakastunnuksen lisäosa - yrityksen eri toimipaikat voidaan määritellä itsenäisiksi käyttäjiksi Kenttä 10: Eräpäivä Mikäli käytetään eräpäivää, muodostetaan jokaisesta eri eräpäivästä aina uusi erä (erätietue, maksutietue(et), ja summatietue). Samassa erässä voi siis olla ainoastaan saman eräpäivän maksuja eli eri eräpäivien tapahtumat on lähetettävä omina erinä pankkiin. Palaute muodostetaan eräpäiväkohtaisesti, ja se on noudettavissa eräpäivää
OP-KESKUS LIITTYMÄKUVAUS 45/80 seuraavana päivänä. Palauteaineiston nimessä aineiston päiväys vastaa eräpäivää ja eränumerona käytetään numeroa.1 (esim. VL1218.1) Maksutietue: Maksutietue sisältää yhden maksun tiedot. 1 Sovellustunnus AN4 P LUM2 2 Tietuetunnus N1 P 1 3 Varalla AN1 Saajatiedot, kentät 4-8: 4 Nimi ja osoite AN140 P 4x35 5 Saajan pankin maakoodi AN2 P 6 Pankin SWIFT (BIC) -koodi AN11 7 Pankin nimi ja osoite AN140 8 Tilinumero AN34 Maksun tiedot, kentät 9-11: 9 Maksunaihe AN140 P 4x35 10 Nolla N1 P 0 11 Valuuttamäärä N14 P 2 desimaalia 12 Valuuttalaji AN3 P Esim. USD 13 Varalla AN3 14 Kurssisopimusnumero AN14 15 Maksutapa AN1 P M=maksumääräys P=pikamääräys Q=SWIFT-shekki S=shekki T=tilisiirto U=ulkom.toim.anto B=SEPA-maksu 16 Palvelumaksu AN1 17 Veloituspäivä AN8 18 Varalla AN15 19 Valuuttakurssi N11 V 6 desimaalia 20 Veloitustili N14 P 21 Valuuttalaji AN3 P 22 Varalla AN15 23 Varalla AN20 24 Rahayksikön koodi AN1 P 1=euro 25 Varalla AN3 600 Kenttä 4: Saajan nimi ja osoite - kentän ensimmäinen merkki ei saa olla blanko. Muuten kenttä on vapaamuotoinen. Suositus on, että kahdelle ensimmäiselle riville tulevat saajan nimitiedot ja kahdelle seuraavalle osoitetiedot. Kenttä 5: Saajan pankin maakoodi - esimerkiksi DE=Saksa, SE=Ruotsi jne. Kenttä 6: Saajan pankin SWIFT (BIC) -koodi - Aina 8 tai 11 merkkiä ilman välilyöntejä Kenttä 7: Saajan pankin nimi ja osoite - Sen pankin nimi ja osoite, jossa saajalla on tili. Jos saajan pankin maassa
OP-KESKUS LIITTYMÄKUVAUS 46/80 on käytössä sisäinen clearing-järjestelmä, aloitetaan ensimmäinen rivi kahdella kauttaviivalla ja lisätään ilman välilyöntejä 2-merkkinen kirjainkoodi ja numerosarja. Esim. //FW + 9 merkkiä = Fedwire (USA) //SC + 6 merkkiä = Sort Code (esim. Iso-Britannia) Kenttä 8: Saajan tilinumero - IBAN tai BBAN -muodossa yhtenä numerosarjana ilman välilyöntejä tai merkkejä. IBANin kanssa on täytettävä myös kenttä 6 ja BBANin kanssa kenttä 6 tai 7 Kenttä 9: Maksunaihe: Maksunaihe saajan kielellä tai englanniksi, latin character setin mukaisesti. Kenttä 11: Valuuttamäärä - valuuttamäärä ilmoitetaan kokonaislukuna ilman desimaaleja, jos valuuttalaji on JPY Kenttä 15: Maksutapa Q=SWIFT-shekki, joka soveltuu maksuihin, joissa ei ole pankkiyhteyttä ja asiakas haluaa lähettää maksun shekkinä. Pankki lähettää sen maksumääräyksenä sopimuspankkiinsa, joka tekee siitä shekin ja postittaa sen maksun saajalle. SWIFT-shekkiä voidaan käyttää seuraavissa valuutoissa; EUR, USD ja GBP T=siirto valuuttatililtä toiselle tai valuutta- ja eurotilin välinen siirto OP-Pohjolaryhmän tilien välillä. Tällöin maksun valuuttalajin ja määrän on oltava samat kuin kohdetilin valuuttalaji ja määrä. U=ulkomainen maksutoimeksianto. Asiakas voi välittää toimeksiannon ulkomaiseen pankkiin muiden maksujen joukossa. Tällöin pankki välittää maksutoimeksiannon ulkomaiselle pankille. Ks. maksutietueen lisätietue kenttä 6. B=SEPA-maksu. Maksun, jossa maksutapana on B, on täytettävä seuraavat edellytykset, muuten maksu hylätään: - sekä maksajan että saajan pankki sijaitsee EU/ETA alueella - maksu on euromääräinen - maksussa on annettu sekä maksajan että saajan nimi ja maksunaihe - saajan pankkiyhteys on ilmoitettu SWIFT- osoitteena (ei muita tietoja) - saajan tilinumero on ilmoitettu IBAN-muotoisena (International Bank Account Number) - SWIFT-osoitteen viidennen ja kuudennen merkin pitää täsmätä IBAN-tilinumeron alussa olevaan maakoodiin (kaksi ensimmäistä merkkiä) - maksaja ja saaja vastaavat kumpikin oman pankkinsa palvelumaksuista (palvelumaksu-kentän arvo J) - maksulla ei ole tietoa, joka estää maksun automaattisen käsittelyn, esim. erityisohjeita maksun käsittelyyn. Kenttä 16: Palvelumaksu - oletusarvo = J, jolloin saaja saa maksun ulkomaisen pankin
OP-KESKUS LIITTYMÄKUVAUS 47/80 kuluilla vähennettynä - Arvo voidaan muuttaa: T:ksi, jolloin ulkomaisen pankin kulut maksaa maksun toimeksiantaja V:ksi, jolloin saaja maksaa kaikki kulut Kenttä 17: Veloituspäivä - jos lähetystapa = U, kenttä välitetään ulkomaiselle pankille maksutoimeksiannon mukana Kentät 20 ja 21: Veloitustili ja sen valuuttalaji - joko muodossa 500001-1234 tai 50000110000234 - valuuttalaji on euromääräisissä tileissä EUR ja valuuttamääräisissä ko. valuutan ISO-koodi esim. USD, SEK jne. Jos maksutapa on U (ulkomainen maksutoimeksianto), nämä kentät ohitetaan pankin järjestelmissä. Maksutietueen lisätietue Maksaja voi antaa maksusta lisätietoja pankille. Huom! Jos maksutapa on U, annetaan kentässä 6 ulkomaiseen maksutoimeksiantoon liittyvät tiedot ks. tietojen lisäselvennykset. 1 Sovellustunnus AN4 P LUM2 2 Tietuetunnus AN1 P L 3 Varalla AN1 4 Varalla AN11 5 Varalla AN20 6 Ohjeita pankille AN350 7 Asiakkaan omat tiedot AN50 1x20+3x10 8 Varalla AN11 9 Varalla AN70 10 Varalla AN14 11 Varalla AN8 12 Varalla AN15 13 Varalla AN14 14 Varalla AN31 600 Kenttä 4: Veloituskurssi - sama kuin maksutietueen kenttä 19. Kenttä 6: Ohjeita pankille - vapaamuotoisia maksuun liittyviä ohjeita tiedoksi pankille (10x35) - Jos maksutapa on U, annetaan ulkomaisen maksun toimeksiantoon liittyvät tiedot seuraavasti: Kenttä Tiedon nimi P/V Muoto Kuvaus 6.1 SWIFT-osoite V AN11
OP-KESKUS LIITTYMÄKUVAUS 48/80 6.2 Toimeksiannon viite P AN16 6.3 Veloitettava tili ulkom. Pankissa P AN34 6.4 Maksuohjekoodi ulkom. Pankille V AN35 4AN + / + 30 merk. 6.5 Alkuperäinen valuuttalaji V AN3 6.6 Nolla V N1 0 6.7 Alkuperäinen valuuttamäärä V N14 6.8 Varalla V Tarkistukset: - jos valuuttakurssi (maksutietue, kenttä 19) on annettu, on kurssisopimuskenttä (maksutietue, kenttä 14) annettava - jos valuuttakurssi (maksutietue, kenttä 19) on annettu, on alkuperäinen valuuttamäärä (kentät 6.5-6.7) annettava - jos alkuperäinen valuuttamäärä (kentät 6.5-6.7) on annettu, on maksettavan valuuttamäärän valuutan (maksutietue, kenttä 11) oltava eri - veloituspäivä välitetään ulkomaille. Veloituspäivä ei voi olla lähetyspäivää vanhempi - Kenttä 6.4 muodostuu koodista (4 merkkiä), kauttaviivasta (/) ja vapaasta viestistä (30 merkkiä). Kentässä voidaan käyttää seuraavia koodeja: - CHQH Maksu saajalle shekillä - CORT Pankin kanssa tehty kauppa (FX,arvopaperi) - INTC Yrityksen sisäinen rahansiirto - NETS Netotus-järjestelmän kautta maksettava maksu - RTGS Maksu RTGS-järjestelmän kautta - URGP Erikoispika - PHON Saajalle ilmoitettava puhelimella maksusta, koodin lisäksi puhelinnumero - OTHR Pankin oma koodi. Tämän lisäksi kauttaviivan jälkeen pankin kanssa erikseen sovittu koodi. Kenttä 7: Asiakkaan omat tiedot - maksajan omaan käyttöön varattu tila, esim. reskontratunnus, maksun numero, kustannuspaikka, käsittelijä jne. Laskutietue Asiakas voi halutessaan ilmoittaa aineistonsa laskuittain. Tällöin asiakas saa aineistonsa laskukohtaisesti kurssattuna. Laskutietueet eivät kuitenkaan ole pakollisia. Laskutietueiden valuuttalajin täytyy olla sama kuin maksun valuuttalajin. Jos laskutietueet eivät täsmää maksutietueeseen, maksu hylkääntyy. Laskutietue sisältää yhden laskun tiedot. Laskutietueella on varattu tilaa asiakkaan omille reskontratiedoille. 1 Sovellustunnus AN4 P LUM2 2 Tietuetunnus N1 P 2
OP-KESKUS LIITTYMÄKUVAUS 49/80 3 Aineistolaji N1 P 0 4 Varalla AN1 5 Valuuttalaji AN3 P 6 Laskulaji N1 P 0=lasku, 2=hyvityslasku 7 Valuuttamäärä N15 P 2 desimaalia 8 Varalla AN11 9 Varalla AN15 10 Laskun numero AN20 11 Varalla AN8 12 Asiakkaan omat tiedot AN50 1x20 + 3x10 13 Varalla AN470 600 Kenttä 10: Laskun numero - asiakkaan reskontratiedoille Summatietue: Summatietue on tiedoston viimeinen tietue ja se sisältää yhteenvetotietoja aineistosta. 1 Sovellustunnus AN4 P LUM2 2 Tietuetunnus N1 P 9 3 Aineistolaji N1 P 0 4 Varalla AN1 5 Asiakastunnus AN11 P Ks. erätietue 6 Varalla AN2 7 Asiakastunnuksen lisäosa AN5 Ks. erätietue 8 Varalla AN1 9 Maksujen lukumäärä N5 P 10 Laskujen lukumäärä N5 Jos laskutietueita 11 Maksujen valuutta- N15 P 2 desimaalia Määrät yhteensä 12 Varalla AN549 600 8.5 Pohjola Pankin factoringlaskut Aineistotunnus on FE. Tiedosto sisältää neljänlaisia tietueita: Tietuetunnus Erätietue 0 Ostajatietueet 1 Laskutietueet 3 Summatietue 9 Erätietue on tiedoston ensimmäinen tietue, joka sisältää tunnistetietoja.
OP-KESKUS LIITTYMÄKUVAUS 50/80 Jokaista laskutietuetta edeltää oma ostajatietue. Jos aineisto sisältää useampia laskuja samalle ostajalle, kertautuu ostajatietue samansisältöisenä niin monta kertaa kuin ostajan laskuja on aineistossa. Summatietue sisältää yhteenvetotietoja edeltävistä laskutietueista. Tietueet ovat kaikki 400 merkin pituisia. 8.5.1 Tarkistukset 8.5.1.1 Tiedostorakenteen oikeellisuuden tarkistus Ensin tarkistetaan erätietue, seuraavaksi ostaja- ja laskutietueet ja viimeisenä summatietue. Erätietueella olevalla myyjällä pitää olla ko. aineiston OPeräsiirtopalvelusopimus. 8.5.1.1 Laskutietueista lasketaan Tietueiden lukumäärä, jota verrataan summatietueella olevaan Laskujen lukumääräkenttään. Laskun loppusumma -kenttien yhteissumma, jota verrataan summatietueelta laskettuun yhteissummaan seuraavien laskujen osalta, Veloituslaskujen summa, Hyvityslaskujen summa. 8.5.2 Koodit AN= aakkosnumeerinen, kenttä on vasenlaitainen ja jos arvo ei täytä koko kenttää loppu jätetään tyhjäksi N= numeerinen, kenttä täytetään etunollilla P= pakollinen V= valinnainen Erätietue 1 Sovellustunnus AN4 P LA01 2 Tietuetunnus N1 P 0 3 Myyjän y-tunnus AN17 P Annetaan ilman väliviivaa 4 Aineiston luontipäivä N6 P VVKKPP 5 Aineiston luontiaika N4 P HHMM 6 Myyjänumero N6 P Myyjälle annettu rahoituslimiitin numero 7 Valuutan tunnus AN3 P Myyjälimiitin valuutta, EUR 8 Rahoitusyhtiön tunnus AN2 P OP 9 Siirtäjän nimi AN30 P Myyjän nimi 10 Siirtoluettelon numero N6 V 11 Rahoitusyhtiökohtainen varaus AN97 V 12 Varalla AN224 Ostajatietue
OP-KESKUS LIITTYMÄKUVAUS 51/80 1 Sovellustunnus AN4 P LA01 2 Tietuetunnus N1 P 1 3 Myyjänumero N6 P Myyjälle annettu rahoituslimiitin numero 4 Ostajan numero AN10 P Myyjän ostajalleen antama numero, max 8 numeroa 5 Ostajan y-tunnus N10 P Y- tai henkilötunnus Huom. Ilman väliviivaa 6 Ostajan nimi 1 AN30 P Isoilla kirjaimilla 7 Ostajan nimi 2 AN30 V Ei käytössä 8 Ostajan jakeluosoite AN20 P Isoilla kirjaimilla 9 Ostajan postitoimipaikka AN20 P Alkaa postinumerolla 5 merkkiä, postitoimipaikka 15 merkkiä/isoilla kirjaimilla. Huom. Postinumeron ja -toimipaikan väliin yksi välilyönti 10 Puhelinnumero AN13 V 11 Yhteyshenkilön nimi AN30 V 12 Yhteyshenkilön puhelin AN13 V 13 Ostajan faxnumero AN13 V 14 Kieli koodi AN2 P FI 15 Valuutan tunnus AN3 P EUR 16 Viivästyskorkoprosentti N4 V Ei käytössä 17 Ostajan sektorikoodi N3 V Ei käytössä 18 Ostajan toimialakoodi N6 V Ei käytössä 19 Sopimustunnus N3 P Myyjälle annettu sopimustunnus esim. 001 tai 002 20 Ostajan maakoodi N2 P Esim. FI=Suomi, SE=Ruotsi 21 Varalla AN177 Laskutietue 1 Sovellustunnus AN4 P LA01 2 Tietuetunnus N1 P 3 3 Myyjänumero N6 P Myyjälle annettu rahoituslimiitin numero 4 Ostajanumero AN10 P Myyjän ostajalleen antama numero, max 8 numeroa 5 Laskun numero N10 P max 7 numeroa 6 Laskun päiväys N6 P VVKKPP 7 Valuutan tunnus AN3 P esim. EUR, GBP, SEK (valuutan isokoodi) 8 Laskun arvopäivä N6 P VVKKPP 9 Laskun tyyppi N2 P 01=veloituslasku, 02= hyvityslasku
OP-KESKUS LIITTYMÄKUVAUS 52/80 10 Laskun loppusumma N12 P Sentteinä 11 Laskun eräpäivä N6 P VVKKPP 12 Kassa-alennuspäivä1 N6 P VVKKPP 13 Kassa-alennuspäivä2 N6 P VVKKPP 14 Kassa-alennuspäivä3 N6 P VVKKPP 15 Kassa-alennuspäivä4 N6 V Ei käytössä 16 Kassa-alennuspäivä5 N6 V Ei käytössä 17 Kassa-alennuspäivä6 N6 V Ei käytössä 18 Kassa-alennuseurot1 N12 P Sentteinä 19 Kassa-alennuseurot2 N12 P Sentteinä 20 Kassa-alennuseurot3 N12 P Sentteinä 21 Kassa-alennuseurot4 N12 V Ei käytössä 22 Kassa-alennuseurot5 N12 V Ei käytössä 23 Kassa-alennuseurot6 N12 V Ei käytössä 24 Kassa-alennuskoodi1 N1 V Ei käytössä 25 Kassa-alennuskoodi2 N1 V Ei käytössä 26 Kassa-alennuskoodi3 N1 V Ei käytössä 27 Kassa-alennuskoodi4 N1 V Ei käytössä 28 Kassa-alennuskoodi5 N1 V Ei käytössä 29 Kassa-alennuskoodi6 N1 V Ei käytössä 30 Hyvitettävän laskun numero N10 V Veloituslaskun numero, johon hyvitys kohdistetaan. Keskusliikkeiden laskujen osalta kenttä jätetään tyhjäksi. 31 Arvonlisäprosentti N4 V Ei käytössä 32 Toimituspaikan nimi AN30 V Ei käytössä 33 Ostajanumero N6 V Ei käytössä 34 Y-tunnus N10 V Ei käytössä 35 Jakeluosoite AN20 V Ei käytössä 36 Postitoimipaikka AN20 V Ei käytössä 37 Yhteyshenkilö AN30 V Ei käytössä 38 Yhteyshenkilön puhelinnumero AN13 V Ei käytössä 39 Tilaajan nimi AN30 V Ei käytössä 40 Toimituspäivä N6 V Ei käytössä 41 Sopimustunnus N3 P Myyjälle annettu sopimustunnus esim. 001 tai 002 42 Varalla AN38 V Summatietue 1 Sovellustunnus AN4 P LA01 2 Tietuetunnus N1 P 9 3 Myyjän y-stunnus AN17 P Annetaan ilman väliviivaa 4 Aineiston luontipäivä N6 P VVKKPP 5 Aineiston luontiaika N4 P HHMM 6 Laskujen lukumäärä N6 P 7 Veloituslaskujen lukumäärä N6 P
OP-KESKUS LIITTYMÄKUVAUS 53/80 8 Veloituslaskujen summa N13 P 9 Hyvityslaskujen lukumäärä N6 P 10 Hyvityslaskujen summa N13 P 11 Vii.korkolaskujen lukumäärä N6 P 12 Vii.korkolaskujen summa N13 P 13 Vk-hyvityslaskujen lukumäärä N6 P 14 Vk-hyvityslaskujen summa N13 P 15 Varalla AN286 V 8.6 Maksupääteaineisto Vanhan standardin mukaisen maksupääteaineiston aineistotunnus on MT. EMV-maksupääteaineiston tunnus on EA. Aineistokuvaukset voi tilata Finanssialan Keskusliitosta. 8.7 E-laskut pankin verkkopalvelussa, lähetettävät aineistot Osuuspankkien verkkolaskujen välityksessä noudatetaan Finanssialan Keskusliitossa kuvattua Finvoice-välityspalvelun palvelukuvausta ja ehtoja. Laskuttaja voi lähettää Finvoice-laskuja osuuspankin verkkopalvelua käyttäville asiakkaille. Aineistomuotona käytetään Finvoicea. Jokainen lasku on erikseen kehystetty Finvoice-soveltamisohjeessa kuvatulla kuvauksella. Finvoicesoveltamisohje ja Ilmoittamispalvelun kuvaus on nähtävissä Pankkiyhdistyksen sivuilla. Palvelukokonaisuus muodostuu kahdesta osasta: - Ilmoittamispalvelu, jossa laskuttaja ilmoittaa itsensä verkkopalveluun yhdeksi laskuttajaksi, jota voi tarjota palvelua. Vastaanottajien ilmoitukset, joissa vastaanottaja ilmoittaa laskuttajalle oman vastaanottoosoitteensa ja laskuttajan pyytämät yksilöintitiedot. - Laskutus, joka pohjautuu Finanssialan Keskusliitossa määriteltyyn Finvoice-malliin Katso myös noudettavat aineistot. 8.7.1 Edellytykset palvelun käytölle Laskuttajalla on Verkkolaskun välityssopimus osuuspankin kanssa (VV). Pankkiyhteysohjelmalla voidaan lähettää laskuttajailmoitus, noutaa vastaanottoilmoitus. 8.7.2 Käytettävät aineistotunnukset
OP-KESKUS LIITTYMÄKUVAUS 54/80 Laskuttaja-ilmoituksen lähetys: Aineistotunnus on SI. Laskujen lähetys: Aineistotunnus on XS. 9 PANKKIYHTEYSOHJELMISTON NOUTAMAT AINEISTOT 9.1 Tiliote Aineistotunnus on TI. 9.2 Konsernitiliote Tiliotteen sanomarakenteet on kuvattu Finanssialan Keskusliiton toimittamassa "tiliote tositteena -palvelun kuvauksessa". Aineistotunnus on KT Konsernitiliotteen sanomarakenteet on kuvattu Finanssialan Keskusliiton toimittamassa "tiliote tositteena -palvelun kuvauksessa". Konsernitiliote ja korkotiedot Erityistietue 1 Aineistotunnus AN1 P T 2 Tietuetunnus AN2 P 60 3 Tietueen pituus N3 P 4 Pankkiryhmän tunnus AN3 P 500 5 Erityistietueen tunnus AN2 P 01 6 Korkokausi AN13 P VVKKPP-VVKKPP 7 Talletus.1 Tiedon tyyppi AN1 P.2 Keskisaldo.1 Etumerkki AN1 P.2 Määrä N18 P 16 kok + 2 desim 8 Talletuskorko.1 Tiedon tyyppi AN1 P.2 Korkoprosentti N7 P 3 kok + 4 desim 9 Luotto.1 Tiedon tyyppi AN1 P.2 Keskisaldo.1 Etumerkki AN1 P.2 Määrä N18 P 16 kok + 2 desim 10 Luottokorko.1 Tiedon tyyppi AN1 P.2 Korkoprosentti N7 P 3 kok + 4 desim 11 Luoton käyttöaste.1 Tiedon tyyppi AN1 P.2 Käyttöasteprosentti N7 P 3 kok + 4 desim
OP-KESKUS LIITTYMÄKUVAUS 55/80 12 Pysyvä saldo.1 Tiedon tyyppi AN1 P.2 Alin saldo.1 Etumerkki AN1 P.2 Määrä N18 P 16 kok + 2 desim 13 Talletusviitekorko.1 Tiedon tyyppi AN1 P.2 Viitekoron nimi AN35 P.3 Korkoprosentti N7 P 3 kok + 4 desim 14 Luottoviitekorko.1 Tiedon tyyppi AN1 P.2 Viitekoron nimi AN35 P.3 Korkoprosentti N7 P 3 kok + 4 desim 15 Ylityskorko.1 Tiedon tyyppi AN1 P.2 Ylityskorkoprosentti N7 P 3 kok + 4 desim 16 Provisiokorko.1 Tiedon tyyppi AN1 P.2 Provisiokorkoprosentti N7 P 3 kok + 4 desim 17 Provisiopäiväkorko.1 Tiedon tyyppi AN1 P.2 Provisiokorkopros.päivä N7 P 3 kok + 4 desim 18 Talletuskorko.1 Tiedon tyyppi AN1 P.2 Talletuskorko.1 Etumerkki AN1 P.2 Määrä N18 P 16 kok + 2 desim 19 Velkakorko.1 Tiedon tyyppi AN1 P.2 Velkakorko.1 Etumerkki AN1 P.2 Määrä N18 P 16 kok + 2 desim 20 Ylityskorko.1 Tiedon tyyppi AN1 P.2 Ylityskorko.1 Etumerkki AN1 P.2 Määrä N18 P 16 kok + 2 desim 21 Provisiokorko.1 Tiedon tyyppi AN1 P.2 Provisiokorko.1 Etumerkki AN1 P.2 Määrä N18 P 16 kok + 2 desim 22 Provisiopäiväkorko.1 Tiedon tyyppi AN1 P.2 Provisiopäiväkorko.1 Etumerkki AN1 P.2 Määrä N18 P 16 kok + 2 desim Varalla AN28 YHTEENSÄ 346
OP-KESKUS LIITTYMÄKUVAUS 56/80 Pankkiryhmän tunnuksen (kenttä 4) jälkeen tietuekuvaus on pankkikohtainen. Osuuspankin erityistietue sisältää tilin koronlaskentatiedot. Erityistietueen tunnus (kenttä 5) kertoo koronlaskentatietojen muodon. Tiedon tyyppi koronlaskennan elementtien yhteydessä kertoo onko tieto käytössä vai ei. Mikäli tieto on käytössä, sen mahdollinen nollamääräinen sisältö on merkitsevä. Tiedon tyypin arvot ovat: 0 = tietoa ei ole 1 = tieto on merkitsevä Viitekoron nimi annetaan selväkielisenä, esim. EURIBOR 1 KK. 9.3 Tiliote ulkomailta Aineistotunnus on OD. Tiliote ulkomailta voi sisältää seuraavia tietuetyyppejä: - erän alkutietue (pakollinen) - otsikkotietue (pakollinen) - tapahtumatietue (pakollinen) - tapahtumakohtainen tiedonantotietue - väli-/loppusaldotietue (pakollinen) - tulevaisuudessa käytettävissä olevat varat Forward Available Balance - tilikohtainen tiedonantotietue - erän lopputietue (pakollinen) Erän alkutietue 1 Aineistotunnus AN4 "OD" 2 Tietuetyyppi N1 "0" 3 Liiketunnus N10 4 Asiakkaan nimi AN30 5 Aineiston luontipäivä N6 VVKKPP 6 Aineiston päivitysaika N4 HHMM 7 Varalla AN113 168 Otsikkotietue 1 Aineistotunnus AN4 "OD" 2 Tietuetyyppi N1 "1" 3 Eränumero N2 4 Lähettäjäpankki AN25 5 (konttori) AN10 6 Asiakkaan tilinumero AN35
OP-KESKUS LIITTYMÄKUVAUS 57/80 7 Tiliotteen numero N5 8 Sanoman viite, tilipankin antama AN16 TRN 9 Viite/kyselysanoma kysely- AN16 sanoman TRN 10 VVKKPP N6 11 Tilivaluuttalaji AN3 12 Alkusaldo etumerkki, + tai - AN1 tieto, kaksi desimaalia N15 13 Saldotyyppi AN1 M = välisaldo F = alkusaldo 14 Varalla AN 168 SWIFT-kentät: Kenttä 3/field 28 Kenttä 6/field 25 Kenttä 7/field 28 Kenttä 8/field 20 Kenttä 9/field 21 Kenttä 10/field 60 date Kenttä 11/field 60 ccy Kenttä 12/alkusaldon tieto/field 60a Tapahtumatietue 1 Aineistotunnus AN4 "OD" 2 Tietuetyyppi N1 "2" 3 Arvopäivä, tapahtuman N6 VVKKPP arvopäivä 4 Saapumispäivä, kirjauspäivä N4 KKPP 5 Tapahtuman viite, tilinomistajan AN16 viite 6 Tiedonanto AN34 7 Tilipankin viite AN16 8 Oikaisutunnus AN1 0 = ei oikaisu 1 = oikaisu (R) 9 Tapahtuman määrä AN15 etumerkki, + = C, RD - = D, RC tieto, kaksi desimaalia 10* Tapahtumatyyppi AN4 * 11* Rahalajikoodi AN1 * 12 Varalla AN65 168 Kenttä 10 ja 11: Koodien käytöstä sovitaan asiakkaan ja tilipankin kesken.
OP-KESKUS LIITTYMÄKUVAUS 58/80 SWIFT-kentät: Kenttä 3/field 61/1 Kenttä 4/field 61/2 Kenttä 5/field 61/7 Kenttä 6/field 61/9 Kenttä 7/field 61/8 Kenttä 8/field 61/3 Kenttä 9/field 61/5 ja 61/3 Kenttä 10/field 61/6 Kenttä 11/field 61/4 Tapahtumatietue 1 Aineistotunnus AN4 "OD" 2 Tietuetyyppi N1 "3" 3 Viite, tiliotetapahtuman viite AN16 4 Tiedonanto AN65 5 Tiedonanto AN65 6 Varalla AN17 168 Tietue on valinnainen. Tapahtumakohtainen tiedonantotietue seuraa aina vastaavaa tapahtumatietuetta. Max 3 kpl tiedonantotietuetta / 1 tapahtumatietue. SWIFT-kentät: Kenttä 4/field 86 Kenttä 5/field 86 Väli-/loppusaldotietue Kenttä Tieto Muoto P/V Kuvaus 1 Aineistotunnus AN "OD" 2 Tietuetyyppi N1 "4" 3 Closing Balance 3.1 Päivämäärä N6 VVKKPP 3.2 Loppusaldon etumerkki AN1 + tai - 3.3 Loppusaldo N15 2 desimaalia 4 Closing Available Balance 4.1 Päivämäärä N6 VVKKPP 4.2 Käytettävissä olevan saldon AN1 Etumerkki + tai - 4.3 Käytettävissä oleva saldo N15 2 desimaalia 5 Saldotyyppi M = välisaldo F = loppusaldo 6 Varalla AN118 168 AN1 Liittyy closing balanceen SWIFT-kentät: Kenttä 3/field 62 Kenttä 4/field 64 Tulevaisuudessa käytettävissä olevat varat
OP-KESKUS LIITTYMÄKUVAUS 59/80 1 Aineistotunnus AN4 P "OD" 2 Tietuetyyppi N1 P "5" 3 Forward Available Balance (7 kpl) 3.1 Päivämäärä N6 V VVKKPP 3.2 Loppusaldon etumerkki AN1 V + tai - 3.3 Loppusaldo N15 V 2 desimaalia 4 Varalla AN9 V 168 SWIFT-kentät: Kenttä 3/field 65 Tilikohtainen tiedonantotietue 1 Aineistotunnus AN4 "OD" 2 Tietuetyyppi N1 "6" 3 Viite AN16 Tiliotesanoman viite 4 Tiedonanto AN65 5 Tiedonanto AN65 6 Varalla AN17 168 SWIFT-kentät: Kenttä 4/field 86 Erän lopputietue Kenttä Tieto Muoto P/V Selitys 1 Aineistotunnus AN4 "OD" 2 Tietuetyyppi N1 "9" 3 Liiketunnus AN10 asiakkaan LY 4 Lähetyserän siirtopäivä N6 VVKKPP 5 Tietueiden lukumäärä N6 6 Varalla AN141 168 SWIFT-KENTTÄKUVAUKSET Field 20 Transation Reference Number (TRN) sanoman viite (P) Useasta sanomasta koostuvan tiliotteen "osasanomilla" voi olla joko sama tai eri viite, riippuen lähettäjäpankin käytännöstä. Field 21 Related Reference SANOMAAN LIITTYVÄN SANOMAN VIITE (V) Jos MT940 on lähetetty MT920 kyselysanoman vastauksena, tämä enttä sisältää alkuperäisen kyselysanoman TRN:n.
OP-KESKUS LIITTYMÄKUVAUS 60/80 Field 25 Account Identification TILINUMERO (P) Sen tilin numero, josta tiliote on lähetetty Field 28 Statement number/sequence number TILIOTTEEN NUMERO/ JÄRJESTYSNUMERO (P) Tiliotteen järjestysnumero, jonka jäljessä ilmoitetaan monesko sanoma tästä tiliotteesta on kysymyksessä. Esim. 235/01 on tiliotteen ensimmäinen sanoma ja 235/02 tiliotteesta lähetetty toinen sanoma jne. Field 60a Opening Balance ALKUSALDO (P) Kentän sisällön on aina oltava sama tätä edeltävän tiliotteen l loppusaldon F62a. Ensimmäisen tiliotesanoman (esim. 235/01) alkusaldokentän koodi 62F (first opening balance). Vastaavasti toisen sanoman, 235/02 väli (alku)saldokentän koodi on 62M (Intermediate opening balance). Field 61 Statement line TILIOTERIVI (V) Kenttä sisältää tapahtumakohtaiset tiedot. Kenttää voidaan toistaa maksimipituuden asettamissa rajoissa. sanoman Tilioterivit koostuvat yhdeksästä alakentästä, joka on hajautettu tapahtumatietueella eri kenttiin. Kenttien käyttö selviää tietosisällöstä ja Standards I Part VI: olevasta koodiluettelosta. Field 62 Closing Balance (booked funds) LOPPUSALDO (P) Tämän kentän sisältö toistetaan seuraavassa tilistä tuotetun tiliottesanoman kentässä 60a. Jos koko tiliote välittyy yhdellä sanomalla, käytetään koodia 62F. Jos taas tiliote välitetään useana sanomana, kaikkien muiden paitsi viimeisen sanoman väli(loppu)saldon koodi on 62M (Intermediate closing balance), tiliotteen viimeisen sanoman lopullisen loppusaldon koodi on 62F (Final closing balance). Field 64 ((O) Closing Available Balance KÄYTETTÄVISSÄ OLEVAT VARAT Kentässä ilmoitetaan tiliomistajan käytettävissä oleva saldo (jos kreditsaldo) ja saldo, jolle lasketaan veloituskorkoa (jos kyseessä on debitsaldo). Huom. tarkastelu on suoritettu pankin kirjanpidon kannalta. Field 65 Forward Available Balance Jos tapahtumia on kirjattu useammille kirjausarvopäiville (joko kyseisellä tai aiempina tiliotejaksoina), tässä kentässä ilmoitetaan paljonko kullekin päivälle on kirjattu.
OP-KESKUS LIITTYMÄKUVAUS 61/80 Field 86 Information to ACCOUNT owner TIEDONANTO TILINOMISTAJALLE Kenttä sisältää lisätietoja tilinomistajalle. Kenttä 86 voidaan liittää jokaisen Statement linen jälkeen Field 61, jolloin se koskee sitä edeltävää tapahtumaa. Jos kenttä 86 esiintyy sanoman lopussa, koskee se koko tiliotetta tai sisältää yleistietoa tilinomistajalle. Esimerkiksi: 86: PRIME RATE AS OF TODAY 11 PCT. 9.4 Viitepalvelun tapahtumaluettelo Aineistotunnus on TL. Erätietue: 1 Tietuetunnus N1 P 0 = erätietue 2 Kirjoituspäivä N6 P vvkkpp 3 Ajon aloitusajankohta N4 P ttmm 4 Läh. rahalaitostunnus AN2 P 5 blanco 5 Laskuttajan tunnus AN9 Konekielisen tapahtumaluettelon laskuttajan tunnus 6 Rahayksikön koodi AN1 1=euro 7 Varalla AN67 90 Tapahtumatietue: 1 Tietuetunnus N1 P 3 = viitesuoritus 5 = suoraveloitus 6 = Elma, ei käytössä 2 Laskuttajan tilinumero N14 P 3 Kirjauspäivä N6 P Epäonnistuneissa svtapahtumissa = päivä, jolloin tapahtuma on käsitelty OKOssa. 4 Maksupäivä N6 P vvkkpp = päivä, jolloin maksajan tiliä on veloitettu. Epäonnistuneissa svtapahtumissa pvmäärä = eräpäivä tai päivä jolloin veloitusta on viimeksi yritetty tehdä 5 Arkistointitunnus AN16 P 6 Viite N20 P 7 Maksajan nimi AN12 P 8 Rahayksikön koodi AN1 P 1=euro
OP-KESKUS LIITTYMÄKUVAUS 62/80 9 Nimen lähde AN1 V A = asiakkaalta K = konttorista J = järjestelmästä 10 Rahamäärä N10 P 2 desim. 11 Oikaisutunnus N1 P 0 = normaali 1 = oikaisu 12 Välitystapa AN1 V A = asiakkaalta K = konttorista J = järjestelmästä 13 Syykoodi AN1 P " ", 0 = onnistunut 1 = tiliä ei löytynyt 2 = kate ei riitä 3 = ei maksupalvelutili 4 = maksaja peruuttanut 5 = pankki peruuttanut 6 = peruutus ei kohdistu 7 = valtuutus puuttuu 8 = eräpäivävirhe 9 = muotovirhe 90 Summatietue: 1 Tietuetunnus N1 P 9 = summatietue 2 Sv + viitetap. kpl-määrä N6 P 3 Sv + viitetap. rahamäärä N11 P 2 desim. 4 Sv + viiteoikaisujen kpl-määrä N6 P 5 Sv + viiteoikaisujen rahamäärä N11 P 2 desim. 6 Epäonnistuneiden kpl-määrä N6 P 2 desim. 7 Epäonnistuneiden rahamäärä N11 P 2 desim. 8 Varalla AN38 V 90 Suoraveloitusten palauteaineisto noudattaa konekielisen tapahtumaluettelon rakennetta. Samassa palauteaineistossa voidaan lähettää sekä sisäänluvun tarkistusajossa ja/tai eräpäivänä epäonnistuneet tapahtumat. Palauteaineistot muodostetaan hyvitystilikohtaisesti. Noutoaineistossa on oma erätietue ja oma summatietue jokaista tiliä kohden. Erätietue Pakolliset kentät ovat 1, 2, 3, 4, 5 ja 6. Rahayksikön koodi tulee tilin tietojen perusteella. Tapahtumatietue Pakolliset kentät ovat 1, 2, 3, 4, 5, 6, 9, 10 ja 12. Summatietue Pakolliset kentät ovat 1, 2, 3, 4, 5, 6 ja 7. 9.5 Laskujen maksun palauteaineistot
OP-KESKUS LIITTYMÄKUVAUS 63/80 Aineistotunnukset ovat: LM maksetut laskut LV virheelliset maksut LO katetta odottavat maksut LK katteettomat maksut Viestikoonnin perustietue Jokaista tili - maksatustunnusparia kohti syntyy päivittäin yksi viestikoonti, jota seuraa päivän aikana maksetut laskut (voi sisältyä useita maksatuseriä). 1 Tietuetunnus AN3 P 'T03' 2 Tietueen pituus N3 P 322 3 Versionumero AN3 P '100' 4 Maksajan tilinumero AN14 V LM03 erätietueelta 5 Varalla AN15 V Tyhjää 6 Muodostuspäivä AN6 V Palautteen muodostuspäivä (vvkkpp) 7 Muodostusaika N4 V Palautteen muodostusaika (ttmm) 8 Maksatustunnus AN17 V LM03 erätietueelta 9 Varalla AN25 V Tyhjää 10 Varalla N6 V 000000 11 Valuutta AN3 P EUR 12 Varalla AN48 V Tyhjää 13 Maksajan nimi AN35 V LM03 erätietueelta 14 Yhteystieto-1 AN40 V Tilipankin nimi 15 Yhteystieto-2 AN40 V Tilikonttorin nimi 16 Palvelun tunnus AN3 V 'LMP' 17 Palvelun nimi AN27 V Tyhjää 18 Varalla AN30 V Tyhjää Maksajan veloituksen perustietue Yhden LMP-veloituksen (= maksatuserän) perustietue, jonka jälkeen tulee erittelyt erään sisältyvistä maksuista. Erittelyt päättyvät seuraavaan viestikoonnin perustietueeseen, veloituksen perustietueeseen tai aineiston loppuun. Veloituksen perustietue erotetaan siihen kuuluvista erittelyistä tasotunnuksen avulla. 1 Tietuetunnus AN3 P 'T10' (virhepalautteella T80 ) 2 Tietueen pituus N3 P 188 3 Tapahtuman numero N6 V '000000'
OP-KESKUS LIITTYMÄKUVAUS 64/80 4 Arkistotunnus AN18 V Veloituksen arkistotunnus (vvkkpp5 LM nnnnnn). Virhepalautteella tyhjää 5 Kirjauspäivä N6 V Kirjauspäivä (vvkkpp) 6 Arvopäivä N6 V '000000' 7 Maksupäivä N6 V Aineiston maksupäivä (yleensä sama, kuin kirjauspäivä) vvkkpp 8 Tapahtumatunnus N1 V '2' 9 Kirjausselitekoodi AN3 V '702' 10 Varalla AN35 V Tyhjää 11 Rahamäärän etumerkki AN1 V 12 Rahamäärä N18 Maksajan tililtä veloitettu rahamäärä kahdella desimaalilla. Virhepalautteella nollaa 13 Varalla AN1 V Tyhjää 14 Välitystapa AN1 V 'A' (asiakkaan aineistosta) 15 Maksajan nimi AN35 V LMP sopijan nimi 16 Nimen lähde AN1 V 'J' (pankin järjestelmästä) 17 Varalla AN14 V Tyhjää 18 Varalla AN1 V Tyhjää 19 Viite N20 V Nollaa 20 Varalla AN8 V Tyhjää 21 Tasotunnus N1 P 0 Maksajan veloituksen lisätietueet Kaikki lisätietueet liittyvät edeltävään perustietueeseen. Kenttä Tieto Muoto P/V Kuvaus 1 Tietuetunnus AN3 P 'T11' (virhepalautteella T81 ) 2 Tietueen pituus N3 P 8 + lisätiedon pituus 3 Lisätiedon tyyppi AN2 P 4 Lisätiedot AN8 35 P Kenttä 4: Lisätieto on tyypistä riippuen joku seuraavista: Tyyppi 01: Tyyppi 06: Tyyppi 09: Erään sisältyvien laskujen määrä (sisältää myös hyvityslaskujen määrän), pituus 8 merkkiä. Toimeksiantajatieto erätietueelta, 35 merkkiä. Maksajan nimitarkenne erätietueelta, 35 merkkiä. Saajan hyvitystietue
OP-KESKUS LIITTYMÄKUVAUS 65/80 Saajan hyvitystietue tehdään jokaisesta saajan tilille kirjatusta maksusta. Yhdistetyillä tapahtumilla siihen liittyy vielä erittelyjä. 1 Tietuetunnus AN3 P 'T10' (virhepalautteella T80 ) 2 Tietueen pituus N3 P 188 3 Tapahtuman numero N6 V Saajan hyvityksen järjestysnumero aineiston alusta 4 Arkistotunnus AN18 V Hyvityksen arkistotunnus (vvkkpp5 LM nnnnnn) 5 Varalla N6 V '000000' 6 Varalla N6 V '000000' 7 Varalla N6 V '000000' 8 Tapahtumatunnus N1 V '2' 9 Kirjausselitekoodi AN3 V '702' 10 Varalla AN35 V tyhjää 11 Rahamäärän etumerkki AN1 V 12 Rahamäärä N18 Maksajan tililtä veloitettu rahamäärä kahdella desimaalilla. Virhepalautteella nollaa 13 Varalla AN1 V tyhjää 14 Välitystapa AN1 V 'A' (asiakkaan lähettämä) 15 Nimi AN35 V Saajatarkenne-1 16 Nimen lähde AN1 V A asiakkaalta J pankista 17 Saajan tili AN14 V Tili, jolle maksu on maksettu 18 Tili muuttunut-koodi AN1 V '*', jos tili ei ole maksajan antama. 19 Viite AN20 V Maksajan antama viite, mikäli se on hyväksytty tarkistuksissa. Viestilaskuilla nollaa 20 Varalla AN8 V Tyhjää 21 Tasotunnus N1 P 1 Saajan hyvityksen lisätietueet Saajan hyvityksen lisätietueita käytetään viestitietojen, toimeksiantajatietojen ja huomautusten välittämiseen. Niillä välitetään myös nollaeuroisina lähetetyt viestitiedot, ellei saajan hyvitykseen ole yhdistelty useampia laskuja (hyvityslaskuja).
OP-KESKUS LIITTYMÄKUVAUS 66/80 Kenttä Tieto Muoto P/V Kuvaus 1 Tietuetunnus AN3 P 'T11' (virhepalautteella T81 ) 2 Tietueen pituus N3 P 8 + lisätiedon pituus 3 Lisätiedon tyyppi AN2 P 4 Lisätiedot AN33-420 P Kenttä 4: Lisätieto on tyypistä riippuen joku seuraavista: Tyyppi 00: vapaa viesti = 1-12 kpl 35 merkin mittaista tekstiä. Tyyppi 02: laskutapahtuman (standardiviestin) tiedot: asiakasnumero 10 merkkiä tyhjää 1 merkki laskun numero 15 merkkiä tyhjää 1 merkki laskun pvm 6 merkkiä. Tyyppi 06: sisäinen tieto ja kustannuspaikka (jos molemmat käytössä niin 2*35 merkkiä) Tyyppi 07: huomautustieto: tarkistuksessa havaittu virhe, joka ei aiheuta tapahtuman hylkäämistä. Saajan hyvityksen erittelyn perustietue Erittelyjä voi olla LM03-aineistoissa sekä LM00- ja LM02-aineistojen yhdistetyillä tapahtumilla eli tapahtumilla, joihin sisältyy hyvityslaskuja. Erittelyihin voi liittyä lisätietueita, joiden sisältö on samanlainen kuin edellä. 1 Tietuetunnus AN3 P 'T10' (virhepalautteella T80 ) 2 Tietueen pituus N3 P 188 3 Tapahtuman numero N6 V Erittelyn järjestysnumero saajan hyvityksen sisällä 4 Varalla AN18 V Tyhjää 5 Varalla N6 V '000000' 6 Varalla N6 V '000000' 7 Varalla N6 V '000000' 8 Tapahtumatunnus AN1 V '1' = lasku '2' = hyvityslasku 9 Kirjausselitekoodi AN3 V '702' 10 Varalla AN35 V Tyhjää 11 Rahamäärän etumerkki AN1 V
OP-KESKUS LIITTYMÄKUVAUS 67/80 12 Rahamäärä N18 Maksajan tililtä veloitettu rahamäärä kahdella desimaalilla. Virhepalautteella nollaa 13 Varalla AN1 V Tyhjää 14 Välitystapa AN1 V 'A' (asiakkaan aineistosta) 15 Nimi AN35 V Saajatarkenne-1 16 Nimen lähde AN1 V A asiakkaalta J pankista 17 Varalla AN14 V Tyhjää 18 Varalla AN1 V Tyhjää 19 Viite AN20 V Maksajan antama viite, mikäli se on hyväksytty tarkistuksissa. Viestilaskuilla nollaa 20 Varalla AN8 V Tyhjää 21 Tasotunnus N1 P 2 9.6 Suoraveloituspalvelun valtuutustietoaineisto Aineistotunnus on VA. Aineisto on palvelutunnuskohtainen (erätietueen kenttä 6). Aineiston rakenne: - erätietue - valtuutustietue - summatietue Valtuutusaineiston lajittelujärjestys - maksajan tilinumero - käsittelytunnus - tapahtumapäivä Erätietue: 1 Aineistotunnus AN4 P SVVA 2 Tietuetunnus AN1 P 0 = erätietue 3 Kirjoituspäivä AN8 P vvvvkkpp 4 Kirjoitusaika AN4 P ttmm 5 Lähettävän rahalaitoksen tunnus AN3 P 5 blanco blanco Pankin pankkiryhmätunnus 6 Laskuttajan palvelutunnus AN9 P 7 Palvelutunnusnimi AN30 V 8 OVT-tunnus: - OVT-tunnuskoodi AN4 V - Laskuttajan OVT-tunnuskoodi AN10 V - Varalla AN3 V
OP-KESKUS LIITTYMÄKUVAUS 68/80 Varalla AN84 160 OVT-tunnus eli Organisaatioiden Välisen Tiedonsiirron tunnus a on SFS 5748:n mukainen. OVT-tunnuskoodi (An 4), arvo = 0037, kun laskuttajan OVT-tunnuksena käytetään LY:tä arvo = 9991, kun laskuttajan OVT-tunnus on pankin antama arvo = bbbb voi myös esiintyä. Valtuutustietue: 1 Aineistotunnus AN4 P SVVA 2 Tietuetunnus AN1 P 1 = valtuutustietue 3 Käsittelytunnus AN1 P 1 = uusi 2 = muutos 3 = irtisanottu 4 = huoltotapahtuma *) 4 Viite N20 P Viite tai laskutettavan yksilöintitieto 5 Laskutettavan yksilöintitieto AN30 V 6 Laskutettavan nimi AN35 P 7 Valtuutuksen arkistointitunnus AN20 P 8 Valtuutuksen pankkiyhteyskoodi AN1 P 1 = tilinumero 9 Valtuutustyyppi AN2 V 00 = suoraveloitus 02 = suoralasku **) 10 Varalla AN3 11 Maksajan tilinumero N14 P 12 Tapahtumapäivä AN8 V vvvvkkpp uudessa tapahtumapäivä, muutoksessa voimaantulopäivä, irtisanomisessa päättymispäivä, huoltotapahtumassa ajopäivä 13 Varalla AN5 14 Vanha maksajan tilinumero N14 V Muutoksessa 15 Eräpäivätoivomus AN2 V Maksajan toivoma eräpäivä laskutuskuukaudelle 160 Huom! *) Käsittelytunnuksen arvo 4 = huoltotapahtuma on käytössä erikseen sovittavissa poikkeustilanteissa. **) Valtuutustyypin käyttö on pankkikohtaista. Summatietue: 1 Aineistotunnus AN4 P SVVA 2 Tietuetunnus AN1 P 9 = summatietue 3 Valtuutusten kpl N6 P
OP-KESKUS LIITTYMÄKUVAUS 69/80 4 Varalla AN149 160 9.7 Saapuvien ulkomaan maksujen ennakkotiedot Aineistotunnus on TM. Saapuvat ulkomaanmaksut -tiedosto muodostuu kolmesta tietuetyypistä: - erätietue - tapahtumatietue - erän lopputietue Erätietue: 1 Aineistotunnus AN4 P VS blanco blanco 2 Tietuetunnus N1 P 0 = erätietue 3 Asiakastunnus AN10 P LY, hetu, syntymäaika ilman väliviivaa ja 4 nollaa loppuun 4 Aineiston luontipäivä N6 P VVKKPP 5 Aineiston luontiaika N4 P TTMM 6 Varalla AN487 512 Tapahtumatietue: 1 Aineistotunnus AN4 P VSEU 2 Tietuetunnus N1 P 1 = tapahtumatietue 3 Maksulaji AN2 SM = saapuvamaksumääräys 4 Päivitystunnus N2 01 = päivän 1. purku 02 = päivän 2. purku 5 Viite AN16 Ulk. pankin viite 6 Tapahtuman arkistointitunnus AN16 Ei käytössä 7 Saapumistapa AN1 S = Swift 8 Arvopäivä N6 VVKKPP 9 Saajan tilinumero N14 10 Hyvitettävän tilin valuuttalyh. AN3 11 Valuuttakurssi AN13 Ei käytössä 12 Hyvitettävä valuuttamäärä AN14 Ei käytössä 13 Erikoisnumero N10 = 0000000000 14 Maksun valuuttalyhennys AN3 15 Maksun valuuttakurssi AN13 Ei käytössä 16 Maksun valuuttamäärä. AN14 = määrä, 2 desim. 17 Maksun vasta-arvo AN14 Ei käytössä 18 Pankin kulut AN10 Ei käytössä 19 Maksettava rahamäärä AN14 Ei käytössä 20 Maksaja AN135 21 Maksun aihe AN135 22 Maksajan pankki AN70 23 Rahayksikön koodi AN1 P 1 =euro 24 Varalla AN1 512
OP-KESKUS LIITTYMÄKUVAUS 70/80 Kenttä 5 Kenttä 8 Lähettävän pankin antama viite. Saapuvan maksun ulkomainen arvopäivä. Päivä, jolloin pankki on vastaanottanut maksun katteen. Erän lopputietue: 1 Aineistotunnus AN4 P VS blanco blanco 2 Tietuetunnus N1 P 9 = erän lopputietue 3 Asiakastunnus AN10 P LY, hetu ilman väliviivaa ja 4 nollaa loppuun 4 Tapahtumien kpl-määrä N6 P 5 Varalla AN491 512 9.8 Palaute lähetetyistä ulkomaanmaksuista Aineistotunnus on VL. Erätietue: Erätietue on tiedoston ensimmäinen tietue, joka sisältää tiedoston yksilöintitiedot. 1 Sovellustunnus AN4 P VLU2 2 Tietuetunnus N1 P 0 3 Aineistolaji N1 P 9 4 Varalla AN1 5 Asiakastunnus AN11 P 6 Asiakastunnuksen lisäosa AN5 7 Varalla AN2 8 Hyväksymiskoodi N1 0=hyväksytty 4= hylätty 9 Palautteen luontiaika N10 P VVKKPPHHMM 10 Varalla N14 11 Varalla AN550 600 Maksutietue: Maksutietue sisältää yhden maksun tiedot. 1 Sovellustunnus AN4 P VLU2 2 Tietuetunnus N1 P 1
OP-KESKUS LIITTYMÄKUVAUS 71/80 3 Hyväksymiskoodi N1 0=hyväksytty 4=hylätty 5=poistettu Saajatiedot, kentät 4-8: 4 Nimi ja osoite AN140 P 4x35 5 Saajan pankin maakoodi AN2 P 6 Pankin SWIFT (BIC) -koodi AN11 7 Pankin nimi ja osoite AN140 8 Tilinumero AN34 Maksun tiedot, kentät 9-11: 9 Maksunaihe AN140 P 4x35 10 Nolla N1 P 0 11 Valuuttamäärä N14 P 2 desimaalia 12 Valuuttalaji AN3 P 13 Varalla AN3 14 Kurssisopimusnumero AN14 15 Maksutapa AN1 P Ks. LU-aineisto 16 Palvelumaksu AN1 17 Veloituspäivä N8 PPKKVVVV 18 Nolla N1 P 0 19 Vasta-arvo N14 2 desimaalia Kurssi x val.määrä lähimpään senttiin pyöristettynä 20 Maksun kurssi N11 6 desimaalia 21 Veloitustili ja sen N14 P 22 Valuuttalaji AN3 P 23 Nolla N1 P 0 24 Veloitettu määrä N14 2 desimaalia 25 Arkistointitunnus tai AN20 hylkäyksen syy 26 Rahayksikön koodi AN1 P 1=euro 27 Varalla AN3 600 Kenttä 20: Maksun kurssi - Kurssi on maksuvaluutan eurokurssi (esim. USD:n eurokurssi) tai - euron ollessa maksuvaluuttana veloitusvaluutan eurokurssi (veloitus esim. USD-tililtä). Maksutietueen lisätietue 1 Sovellustunnus AN4 P VLU2 2 Tietuetunnus AN1 P L 3 Hyväksymiskoodi N1 0=hyväksytty 4=hylätty 5=poistettu 4 Veloituskurssi N11 6 desimaalia 5 Varalla AN20 6 Ohjeita pankille AN350 Ks. LU-aineisto 7 Asiakkaan omat tiedot AN50 1x20+3x10
OP-KESKUS LIITTYMÄKUVAUS 72/80 8 Maksun saajan-/shekkipankin AN11 SWIFT-koodi 9 Maksun saajan-/shekkipankin AN70 2x35 nimi- ja osoite 10 Maksun numero AN14 11 Ulkomainen arvopäivä AN8 PPKKVVVV 12 Pohjola Pankin palvelumaksu N15 13 Palvelumaksun veloitustili N14 14 Varalla AN31 600 Kenttä 10: Maksun numero - maksun viite, jota käytetään maksua koskevissa tiedusteluissa. Maksun numero on muodossa MMY+kkpp+1234567 esim. MMY10310805123 Huom! Tiliotteella vastaava numero on 15 merkin mittainen. Palautteessa kkpp:n jälkeinen 0 on poistettu, jotta pituus saadaan 14 merkin mittaiseksi. Kentät 12 ja 13: Pohjola Pankin palvelumaksu ja palvelumaksun veloitustili. Palautteen lisätietoja asiakkaalle: 1 Sovellustunnus AN4 P VLU2 2 Tietuetunnus AN1 P P 3 Hyväksymiskoodi N1 0=hyväksytty 4=hylätty 5=poistettu Muutetut/lisätyt tiedot Pohjola Pankissa* 4 Saajan pankin SWIFT-koodi AN11 5 Saajan pankki AN140 6 Saajan pankin tilinumero N34 7 Välittäjäpankin SWIFT-koodi AN11 8 Välittäjäpankin nimi ja osoite AN140 4x35 9 Välittäjäpankin tilinumero N34 10 Tietoja asiakkaalle AN210 6x35 11 Varalla AN14 600 Tietokenttien lisäselvitykset: Kentät 4-9: Muutetut/lisätyt tiedot Pohjola Pankissa - maksaja saa palautteella muutetut tai täydennetyt pankkiyhteystiedot, jotka on tehty esim. asiakkaan "tietoja pankille"-maksuohjeen perusteella Laskutietue Laskutietueiden valuuttalajin täytyy olla sama kuin maksun valuuttalajin. Jos laskutietueet eivät täsmää maksutietueeseen, maksu hylkääntyy. Laskutietue sisältää yhden laskun tiedot. Laskutietueella on varattu tilaa asiakkaan omille reskontratiedoille.
OP-KESKUS LIITTYMÄKUVAUS 73/80 1 Sovellustunnus AN4 P VLU2 2 Tietuetunnus N1 P 2 3 Aineistolaji N1 P 9 4 Hyväksymiskoodi N1 0=hyväksytty 4=hylätty 5=poistettu 5 Valuuttalaji AN3 P 6 Laskulaji N1 P 0=lasku 2=hyvityslasku 7 Valuuttamäärä N15 P 2 desimaalia 8 Valuuttakurssi N11 6 desimaalia 9 Nolla N1 0 10 Vasta-arvo N14 2 desimaalia 11 Laskun numero AN20 12 Varalla N8 13 Asiakkaan omat tiedot AN50 1x20 + 3x10 14 Varalla AN470 600 Kentät 8 ja 9: Valuuttakurssi ja eurovasta-arvo - Samoin kuin maksutietueen kentät 19 ja 20. - Käytetty kurssi ja viimeinen lasku pyöristettynä siten, että laskujen yhteissumma täsmää maksun vasta-arvoon. Kenttä 10: Laskun numero - asiakkaan reskontratiedoille Summatietue: Summatietue on tiedoston viimeinen tietue ja se sisältää yhteenvetotietoja aineistosta. 1 Sovellustunnus AN4 P VLU2 2 Tietuetunnus N1 P 9 3 Aineistolaji N1 P 9 4 Varalla AN1 V 5 Asiakastunnus AN11 P 6 Varalla AN2 V 7 Asiakastunnuksen lisäosa AN5 V 8 Hyväksymiskoodi N1 P 0=hyväksytty 4=hylätty 9 Maksujen lukumäärä N5 P 10 Laskujen lukumäärä N5 P 11 Maksujen valuutta- N15 P 2 desimaalia määrät yhteensä 12 Varalla AN549 V 600 9.9 Maksupäätepalautteet
OP-KESKUS LIITTYMÄKUVAUS 74/80 Vanhan maksupäätestandardin mukaisen palautteen aineistotunnus on MYkkpp.999 EMV-palauteaineiston saa noudettua nimellä EBkkpp.999 Avainaineiston saa noudettua nimellä W.EA.1 BIN-aineiston nimi on W.EB.1 AID-aineisto, päätetyypille 1 on W.EC.1 AID-aineisto, päätetyypille 2 on W.EC.2 AID-aineisto, päätetyypille 3 on W.EC.3 AID-aineisto, päätetyypille 4 on W.EC.4 Aineistokuvaukset voi tilata Finanssialan Keskusliitosta. 9.10 E-laskut pankin verkkopalvelussa, noudettavat aineistot RI-aineistojen nouto edellyttää VV-sopimusta (verkkolaskujen lähetys) pankin kanssa. Vastaanotto-ilmoituksen nouto RIkkpp.999 (RI9999.999=noutamattomat) XR-aineistojen nouto edellyttää VOS-sopimusta (Verkkolaskujen vastaanottosopimus) pankin kanssa. Laskujen vastaanotto XRkkpp.999 Lähetysten virhepalautteet XIkkpp.999 9.11 Valuuttakurssit Aineistotunnus on C.EK Valuuttakurssitiedosto muodostuu kahdesta tietuetyypistä: - erätietue - kurssitietue Erätietue: 1 Aineistotunnus AN4 P VK01 2 Tietuetunnus N3 P 000 3 Kurssien muutospvm N8 P YYYYMMDD 4 Kurssien muutosaika N6 P HHMMSS 5 Info AN120 6 Varalla AN9
OP-KESKUS LIITTYMÄKUVAUS 75/80 Kurssitietue: 150 1 Aineistotunnus AN4 P VK01 2 Tietuetunnus N3 P 001 3 Noteerauksen päivä N8 P YYYYMMDD 4 Noteerauksen aika N6 P HHMMSS 5 Kurssilaji N4 P 0001=listakurssi 6 Valuutan ISO-koodi AN3 P 7 Vastavaluutan ISO-koodi AN3 P EUR 8 * Tilivaluutan keskikurssi N13 P 7 desimaalilla 9 * Tilivaluutan ostokurssi N13 P 7 desimaalilla 10 * Tilivaluutan myyntikurssi N13 P 7 desimaalilla 11 Setelivaluutan ostokurssi N13 P 7 desimaalilla 12 Setelivaluutan myyntikurssi N13 P 7 desimaalilla 13 Muutoksen suunta AN1 P tyhjä 14 Valuutan vaihdettavuus AN1 P tyhjä 15 Valuutan eurotieto N1 P 1=euroalueen valuutta 0=euroalueen ulkopuolinen valuutta 16 Euroon liittymisen päivä N8 00000000, jos kenttä 15 on 0 19990101, jos kenttä 15 on 1 17 Valuutan voimassaolokoodi AN1 P K=käytössä E=ei käytössä 18 Varalla AN42 150 * Kentissä 8, 9 ja 10 ilmoitetaan EMU-valuutoilla kiinteä muutokerroin. 10. C2B-MAKSUAINEISTO C2B-maksuaineisto, palautteet ja esimerkit kuvataan erillisessä palvelukuvauksessa. PATUN TUNNISTAUTUMIS- JA AINEISTON SUOJAUSSANOMAT OSUUSPANKIN ERÄSIIRTOPALVELUSSA ESITTÄYTYMIS (ESI) SANOMAN TIEDOT ESI a -sanoma on asiakkaan lähettämä sanoma ESI p - sanoma on pankin lähettämä sanoma Tiedon numero Nimi Tieto Selitys 1 Sanomatunnus >>ESI Esittäytymissanoman tunnus 2 Sanomapituus ESI a = 161 Sanoman pituus merkkeinä ESI p = 237 3 Versio V1.1 = 110,120 Voimassa oleva turvastrandardi versio
OP-KESKUS LIITTYMÄKUVAUS 76/80 4 Onnistumiskoodi ESI a = tyhjää ESI p = K/E Pankin lähettämä koodi: K = ESI a hyväksytty E = ESI a hylätty 5 Ilmoituskoodi 4 merkkiä Virhe tai ilmoituskoodi (kts. PATUstandardin ilmoituskoodit -taulukko) 6 Ohjelmisto 16 merkkiä Vapaamuotoinen ohjelmiston nimi ja versio ESI a = vapaamuotoinen ESI p = OPNET 1.0 7 Menetelmä SMH Turvamenetelmää yksilöivä koodi 8 Vastaanottaja ESI a = 001999207 Sanoman vastaanottajan tunniste ESI p =käyttäjätunnus Tarkenneosa tyhjää 9 Lähettäjä ESI a = käyttäjätunnus Sanoman lähettäjän tunniste ESI p = 001999207 Tarkenneosa tyhjää 10 Siirtoavain sukupolvi arvot 0-9 Siirtoavaimen sukupolvinumero 11 Käyttöavain arvot 0-9 Käyttöavaimen sukupolvinumero sukupolvi 12 Aikaleima vvkkpphhmmssnnn Päiväys (muodossa vvkkpp) + kellonaika (muodossa hhmmss) + leimanumero nnn luku 000-999 13 Suojausalue tyhjää Ei käytössä 14 Varalla tyhjää Ei käytössä 15 Kerta-avain tyhjää Ei käytössä 16 Tiiviste tyhjää Ei käytössä 17 Tarkiste 16 merkkinen heksaluku 18 Avainvaihto ESI a 0 ei toimenpiteitä 1 käyttäjä pyytää avainvaihtoa ESI p 0 ei toimenpiteitä 1 pankki toimittaa uuden avaimen ESI a -sanoma yhteensä 161 merkkiä Seuraavat kentät vain ESI p -sanomassa Tämän turvasanoman tarkiste (MAC) heksadesimaalisena Käyttöavaimen vaihtopyyntö 19 Uusi avain 16 merkkinen Uusi käyttöavain salakirjoitettuna, heksaluku heksadesimaalisena 20 Ilmoitus 60 merkkinen ilmoitus Virheitä tai muuta tilannetta kuvaava selväkielinen ilmoitus (kts. ilmoituskoodien teksti) ESI p -sanoma yhteensä 237 merkkiä SUOJAUSOTSAKKEEN (SUO-SANOMA) TIEDOT SUO a -sanoma on asiakkaan lähettämä SUO p -sanoma on pankin lähettämä Tiedon numero Nimi Tieto Selitys 1 Sanomatunnus >>SUO SUO-sanoman tunnus 2 Sanomapituus SUO a = 128 Sanoman pituus merkkeinä SUO p = 128 3 Versio V1.1 = 110, 120 Voimassaoleva turvastandardiversio
OP-KESKUS LIITTYMÄKUVAUS 77/80 4 Onnistumiskoodi K/E Pankin lähettämä koodi: K = hyväksytty, E = hylätty 5 Ilmoituskoodi 4 merkkiä Virhe- tai ilmoituskoodi (kts. PATUstandardin ilmoituskooditaulukko) 6 Ohjelmisto 16 merkkiä Vapaamuotoinen ohjelmiston nimi ja versio. SUO a = vapaamuotoinen SUO p = OPNET 1.0 7 Menetelmä SKH Turvamenetelmää yksilöivä koodi 8 Vastaanottaja SUO a = 001999207 SUO p = OPNETkäyttäjä-tunnus 9 Lähettäjä SUO a = OPNETkäyttäjä-tunnus SUO p = 001999207 Sanoman vastaanottajan tunniste Tarkenneosa tyhjää Sanoman lähettäjän tunniste Tarkenneosa tyhjää 10 Siirtoavainnumero Arvot 0-9 Siirtoavaimen sukupolvinumero 11 Käyttöavainnumero Arvot 0-9 Käyttöavaimen sukupolvinumero 12 Aikaleima vvkkpphhmmssleimanr o Päiväys (muodossa vvkkpp) + kellonaika (muodossa hhmmss) + vvkkpphhmmss sisällä yksilöivä leimanumeroluku 000-999 13 Suojausalue S Siirtoeräkohtainen suojaus 14 Varalla 9 merkkiä tyhjää Ei käytössä 15 Kerta-avain 16 merkkinen Heksadesimaalisena salakirjoitettu heksaluku siirtoavaimella
OP-KESKUS LIITTYMÄKUVAUS 78/80 SUOJAUSLOPUKKEEN (VAR-SANOMA) TIEDOT VAR a -sanoma on asiakkaan lähettämä VAR p -sanoma on pankin lähettämä Tiedon numero Nimi Tieto Selitys 1 Sanomatunnus >>VAR VAR-sanoman tunnus 2 Sanomapituus VAR a = 161 Sanoman pituus merkkeinä VAR p = 237 3 Versio V1.1 = 110, 120 Voimassaoleva turvastandardiversio 4 Onnistumiskoodi K/E Pankin lähettämä koodi: K = hyväksytty, E = hylätty 5 Ilmoituskoodi 4 merkkiä Virhe- tai ilmoituskoodi (kts. PATUstandardin ilmoituskooditaulukko) 6 Ohjelmisto 16 merkkiä Vapaamuotoinen ohjelmiston nimi ja versio. VAR a = vapaamuotoinen VAR p = OPNET 1.0 7 Menetelmä SMH Turvamenetelmää yksilöivä koodi 8 Vastaanottaja VAR a = 001999207 VAR p = OPNETkäyttäjä-tunnus 9 Lähettäjä VAR a = OPNETkäyttäjä-tunnus VAR p = 001999207 Sanoman vastaanottajan tunniste Tarkenneosa tyhjää Sanoman lähettäjän tunniste Tarkenneosa tyhjää 10 Siirtoavainnumero Arvot 0-9 Siirtoavaimen sukupolvinumero 11 Käyttöavainnumero Arvot 0-9 Käyttöavaimen sukupolvinumero 12 Aikaleima vvkkpphhmmssleimanr o Päiväys (muodossa vvkkpp) + kellonaika (muodossa hhmmss) + vvkkpphhmmss sisällä yksilöivä leimanumeroluku 000-999 13 Suojausalue S Siirtoeräkohtainen suojaus 14 Varalla 9 merkkiä tyhjää Ei käytössä 15 Kerta-avain 16 merkkinen Heksadesimaalisena salakirjoitettu heksaluku siirtoavaimella 16 Tiiviste 16 merkkinen Aineistoerän tiiviste heksaluku 17 Tarkiste 16 merkkinen heksaluku PALAUTESANOMAN (PTE-SANOMA) TIEDOT PTE-sanoma on aina pankin lähettämä heksadesimaalisena (laskettuna kertaavaimen avulla MAC-laskennalla. Kts. PATUstandardi). Tämän turvasanoman tarkiste heksadesimaalisena (laskettuna käyttöavaimen avulla MAClaskennalla. Kts. PATUstandardi). Tiedon numero Nimi Tieto Selitys 1 Sanomatunnus >>PTE PTE-sanoman tunnus 2 Sanomapituus 317 Sanoman pituus merkkeinä 3 Versio V1.1 = 110, 120 Voimassaoleva turvastandardiversio
OP-KESKUS LIITTYMÄKUVAUS 79/80 4 Onnistumiskoodi K/E Pankin lähettämä koodi: K = hyväksytty, E = hylätty 5 Ilmoituskoodi 4 merkkiä Virhe- tai ilmoituskoodi (kts. PATUstandardin ilmoituskooditaulukko) 6 Ohjelmisto 16 merkkiä Vapaamuotoinen ohjelmiston nimi ja versio. OPNET1.0 7 Menetelmä SMH Turvamenetelmää yksilöivä koodi 8 Vastaanottaja OPNETkäyttäjätunnus Sanoman vastaanottajan tunniste Tarkenneosa tyhjää 9 Lähettäjä PTE=001999207 Sanoman lähettäjän tunniste Tarkenneosa tyhjää 10 Siirtoavainnumero Arvot 0-9 Siirtoavaimen sukupolvinumero 11 Käyttöavainnumero Arvot 0-9 Käyttöavaimen sukupolvinumero 12 Aikaleima vvkkpphhmmssleimanr o Päiväys (muodossa vvkkpp) + kellonaika (muodossa hhmmss) + vvkkpphhmmss sisällä yksilöivä leimanumeroluku 000-999 13 Suojausalue S Siirtoeräkohtainen suojaus 14 Varalla 9 merkkiä tyhjää Ei käytössä 15 Kerta-avain 16 merkkinen Heksadesimaalisena salakirjoitettu heksaluku siirtoavaimella 16 Tiiviste 16 merkkinen Aineistoerän tiiviste heksaluku 17 Tarkiste 16 merkkinen heksaluku 18 Avainvaihto 0=ei toimenpiteitä 1=pankki toimittaa uuden käyttöavaimen 19 Uusiavain 16 merkkinen heksadesimaalisena (laskettuna kertaavaimen avulla MAC-laskennalla. Kts. PATUstandardi). Tämän turvasanoman tarkiste heksadesimaalisena (laskettuna käyttöavaimen avulla MAClaskennalla. Kts. PATUstandardi). Käyttöavaimen vaihtopyyntö Käyttöavain salakirjoitettuna heksaluku siirtoavaimella heksadesimaalisena 20 Ilmoitus 60 merkkiä Virhettä tai muuta tilannetta kuvaava selväkielinen ilmoitus. Kts. PATUstandardin ilmoitustaulukko. 21 Kuittaus 80 merkkiä Koontisummasanoma. OPNETin $$EOF-sanoma Aineistoluettelo Otsikkotietue 1 Vakioteksti AN16 P MUODOSTAMISPVM: 2 Muodostamispvm AN10 P pp.kk.vvvv 3 Varalla AN1 P 4 Vakioteksti AN5 P KLO: 5 Muodostamishetki AN8 P tt:mm:ss 6 Varalla AN4 P 7 Vakioteksti AN16 P TILAKD. 8 Vakioteksti AN10 P TARK.SUMMA
OP-KESKUS LIITTYMÄKUVAUS 80/80 70 Aineistotietue 1 Aineistonimi AN16 P 2 Aikaleima AN19 P pp.kk.vvvv tt:mm:ss aineiston vastaanottotai luontihetki 3 Varalla AN10 P 4 Aineiston tilakoodi AN1 P 0-9 odottaa jatkokäsittelyä tai noutoa P siirretty jatkokäsittelyyn H noudettu T poistettu J jäädytetty tai julkinen 5 Tarkistussumma AN24 V Tasattu oikealle 70 Ajantasaisen tapahtuman virhevastaus Tiedon nimi Muoto Kuvaus Sanomalohkon järjestysnumero N1 = 1 Vastaustyyppi N1 = 3 tai 4 Varalla AN3 Tapahtumakonttorin numero N6 Päätteen numero N2 Tapahtumanumero N4 Asiakkaan nimi AN15 Virheilmoitukset (1-8 kpl) Virheilmoituksen alkumerkki N1 = 1 Virheilmoitus AN11 - AN20 Virheilmoituksen loppumerkki AN1 = ^ (heksa 5E) Kentät Sanomalohkon järjestysnumero Tapahtumanumero ovat mukana tapahtumakyselyn, tilisiirron, luoton saldon ja luoton lyhennyssuunnitelman virhevastauksissa. Valuuttatilien saldoissa ja saldoyhteenvedossa sanoma alkaa asiakkaan nimestä.