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