PANKKILINJAN ASYNKRONISEN KERMIT- TIEDOSTOSIIRRON KUVAUS
2 Sisällysluettelo SISÄLLYSLUETTELO...2 ASYNKRONINEN KERMIT-TIEDOSTOSIIRTO...3 YHTEYSKÄYTÄNTÖ...3 Yhteydenotto...3 Asiakkaan tunnistus...3 Palvelun pyyntö...3 Aineiston lähetys...4 Aineiston vastaanotto...9 Yhteyden purkaminen...10 MUUT MÄÄRITYKSET...10 Ohjaustiedostojen nimet...10 Virheilmoitukset...10 ESIMERKIT...11
3 Asynkroninen Kermit-tiedostosiirto Yhteyskäytäntö Yhteyskäytäntö on periaatteeltaan eräsiirtotyyppinen ja sisältää seuraavat vaiheet: yhteydenotto tunnistus tiedostojen lähetys/vastaanotto yhteyden katkaisu Yhteydenotto Asiakkaan tunnistus Palvelun pyyntö Asiakas muodostaa yhteyden soittamalla joko yleiseen PAD-palveluun tai suoraan Oy Samlink Ab:hen. Asiakas lähettää tunnistustietonsa (ESI-sanoman) tiedostossa, jonka nimi on ASIAKAS. ESI-sanoman sisältö on kuvattu Suomen Pankkiyhdistyksen PATUohjeessa. Pankki lähettää vastauksena ESI-turvasanomansa GGLOGG-tiedostossa. Asiakkaan palvelupyyntö välitetään PALVELU-nimisessä tiedostossa, joka sisältää yhden tietueen. Tietue sisältää eräsiirroissa sovellustunnisteen ja erätunnisteen. Tilipalvelujen osalta palvelupyyntö on erilainen. Ks. Pankkilinjan tietuekuvaukset. Sovellustunnus, erätunniste (, lisäparametri) Sovellustunnukset on lueteltu Pankkilinjan tietuekuvauksissa kohdassa Sovellustunnukset. Erätunniste yksilöi erän. Erätunniste on 4 numeroa pitkä, vapaavalintainen numerotieto. Suositeltava muoto on PPNN, jossa PP on aineiston muodostamispäivä ja NN on juokseva eränumero per päivä. Samalla eränumerolla voi lähettää aineistoa vain kerran saman vuorokauden aikana. Lisäparametrilla voidaan varsinaisen erätunnisteen lisäksi yksilöidä kyseinen erä. Lisäparametri voi olla muotoa nnnn, esim. 1234.
4 Esimerkit: Laskujen maksupalvelu erätunnisteella 0701: LP,0701 tai LP,0701,0001. Konekielinen tapahtumaluettelo erätunnisteella 1128: OP,1128 Aineiston lähetys Aineiston lähetyksen vaiheet: aineiston lähetys koontisumman vastaanotto hyväksymisen tai hylkäämisen lähetys loppukuittauksen vastaanotto Aineiston lähetys Palvelupyynnön jälkeen lähetetään varsinainen aineistoa sisältävä tiedosto. Tiedoston nimi voi olla mikä tahansa muu kuin tämän ohjeen kohdassa Ohjaustiedostojen nimet mainitut. Kun aineisto suojataan PATU-suojauksella, SUO-sanoma on aina tiedoston alussa ja VAR-sanoma tiedoston lopussa. Sanomat on kuvattu em. Suomen Pankkiyhdistyksen PATU-ohjeessa. Koontisumman vastaanotto Kun aineistoa sisältävä tiedosto on lähetetty, odotetaan koontisummaa sisältävää tiedostoa nimeltään KYSYMYS. Mikäli aineisto on suojattu PATU-suojauksella, KYSYMYS-tiedosto sisältää PTE-turvasanoman, johon on lisätty koontisummasanoman tiedot. Huom! PTE-turvasanomalla oleva koontisummasanoma on ilman EOF tekstiä. Tietue alkaa silloin sovellustunnuksella. Koontisummatiedosto sisältää yhden tietueen, koontisummasanoman, jonka tietuekuvaus on seuraava: sovellustunnus ja erätunniste otetaan sovellussanoman vastaavista kentistä kappalemäärät ja rahamäärät ylläpidetään rahamäärä -tapahtumilla sanoman pituus on 80 merkkiä tiedon muoto: A = alfanumeerinen, N = numeerinen
5 Koontisummasanoman eri tietuelajit (riippuu varsinaisesta sovelluksesta): 1. Tietueessa on vain 1 rahamäärä-kenttä Koskee seuraavia sovelluksia: ML toistuvaissuoritukset WM ulkomaille lähtevät maksut; kpl-määrä = maksutapahtumat rahamäärä = valuuttamäärät yhteensä KM maksukorttitapahtumat; kpl-määrä = tietueet 2 ja 3 rahamäärä = lisätään tietueen 2/laji 0:n ja vähennetään tietueen 2/laji 1:n sekä lisätään tietue 3:n rahamäärillä Nimi Muoto Pituus Sisältö/Huom! EOF-teksti * A 4 EOF Sovellustunnus A 2 Sovellussanomasta Tyhjä A 1 Erätunniste A 4 Sovellussanomasta Nominaatio-teksti A 5 MK= / E = Rahamäärä N 16 Rahamäärän etumerkki A 1 + tai - Kpl-teksti A 5 KPL= Kpl-määrä N 5 Tyhjät A 37 80 * PTE-sanomalla oleva koontisummasanoma alkaa Sovellustunnus-kentästä.
6 2. Tietueessa on 2 rahamäärä-kenttää Koskee seuraavia sovelluksia: MP automaattinen maksupalvelu LP laskujen maksupalvelu Nimi Muoto Pituus Sisältö/Huom! EOF-teksti * A 4 EOF Sovellustunnus A 2 Sovellussanomasta Tyhjä A 1 Erätunniste A 4 Sovellussanomasta Nominaatio-teksti A 5 MK= / E = Rahamäärä N 16 Kpl-teksti A 6 KPL= Kpl-määrä N 5 Oik./Hyv. Nominaatio-teksti A 6 OMK= / OE = Oik./Hyv. Rahamäärä N 16 Oik./Hyv. Kpl-teksti A 7 OKPL= Oik./Hyv. Kpl-määrä N 5 Tyhjä A 3 80 * PTE-sanomalla oleva koontisummasanoma alkaa Sovellustunnus-kentästä. 3. Tietueessa on vain kpl-määrä Poikkeussääntö: kpl-määrä = kaikki tapahtumat Koskee seuraavia sovelluksia: K6 maksukorttivaroitukset Nimi Muoto Pituus Sisältö/Huom! EOF-teksti * A 4 EOF Sovellustunnus A 2 Sovellussanomasta Tyhjä A 1 Erätunniste A 4 Sovellussanomasta Kpl-teksti A 6 KPL= Kpl-määrä N 5 Tyhjä A 58 80
7 * PTE-sanomalla oleva koontisummasanoma alkaa Sovellustunnus-kentästä.
8 Hyväksyminen tai hylkääminen Koontisumman vastaanoton jälkeen lähetetään kuittaus tiedostossa VASTAUS. Tiedosto sisältää tekstin HYV (hyväksytään) tai HYL (hylätään) riippuen siitä halutaanko lähetetty aineisto jatkokäsitellä vai ei. Mikäli hyväksymis/hylkäämis-sanoma annetaan muodossa HYV/HYL,KUITATAAN, asiakkaalle lähetetään loppukuittaussanoma.,kuitataan annetaan sanoman 12 positiosta eteenpäin. Loppukuittaus Kun VASTAUS-tiedosto on lähetetty, odotetaan loppukuittausta tiedostossa KUITTAUS. Tiedosto sisältää vain yhden tietueen, jonka sisältö on EOF. Mikäli asiakas on pyytänyt HYV/HYL-sanomassa kuittauksen, kuittaussanoman sisältö on seuraava: Nimi Muoto Pituus Lisätiedot EOF-teksti AN 7 EOF Sovellustunnus AN 2 Sovellussanomasta Tyhjä AN 3 Erätunniste AN 4 Sovellussanomasta Tyhjä AN 3 Erän tarkenne AN 4 Sovellussanomasta Tyhjä AN 3 HYV-teksti AN 11 HYVAKSYTTY Päivämäärä N 6 PPKKVV Tyhjä AN 1 Kellonaika N 6 HHMMSS Tyhjä AN 30 80 Mikäli aineiston lähetys on hylätty, em. sanoman sisältö poikkeaa seuraavasti: EOF-teksti on muodossa EOFb!!b HYV-tekstin sisältö on HYLATTY
9 Aineiston vastaanotto Lähetettyään aineiston vastaanoton määrittelevän palvelupyynnön asiakas siirtyy vastaanottotilaan. Pankin lähettämän tiedoston nimi muodostetaan palvelupyynnössä olevien tietojen avulla. Esim. pyydettäessä konekielistä tapahtumaluetteloa erätunnisteella 1128 pankista lähetettävän tiedoston nimi on OP1128. Aineiston vastaanotto on muodostuu kahdesta vaiheesta: Sovelluksen määrittely palvelupyynnöllä Aineiston vastaanotto Vastaanoton sovellussanoma Palvelupyynnöllä määritellään, minkä sovelluksen aineisto otetaan vastaan. Muoto on: sovellustunnus,erätunniste Sovellustunnukset on lueteltu Pankkilinjan tietuekuvauksissa kohdassa Sovellustunnukset. Erätunniste yksilöi vastaanotettavan erän. Erätunnisteen pituus on 4 merkkiä ja muoto on seuraavanlainen riippuen siitä, ottaako yhden tietyn erän vai kaikki saatavissa olevat erät: tietty erä muodossa KKPP (kuukausi, päivä) Asiakas voi vastaanottaa sovelluskohtaisesti kaikki purkamatta olevat tiedostot yhdellä sovellussanomalla. Sovellussanomassa erätunniste korvataan neljällä tähdellä (****) tai neljällä katkoviivalla (----). Huom! Kaikki mikrot eivät hyväksy tähtiä, joten niissä on käytettävä katkoviivaa. Esim.: OP,**** tai OP,----. Huom! Poikkeava erätunnisteen rakenne on seuraavissa palveluissa: K6, korttivaroitukset: K6,LUET,** = varoitusluettelo K6,kkpp,** = päivitykset ** tarkoittaa, että asiakkaalle on valmiiksi rekisteröity minkä kortinantajien varoitukset noudetaan.
10 WE, ulkomailta saapuvien maksujen ennakkoilmoitus, muotoa PPNN, jossa PP on erän luontipäivä ja NN juokseva numero per päivä. Yhteyden purkaminen Asiakas purkaa yhteyden lähettämällä LOPETUS-nimisen tyhjän tiedoston. Muut määritykset Ohjaustiedostojen nimet Siirtoja ja yhteyttä ohjataan sekä tiedostojen nimillä että niiden sisällöllä. Seuraavat tiedostonimet ovat ohjauskäytössä, eikä niitä siten saa käyttää aineistojen tiedostonimiin. ASIAKAS PALVELU KYSYMYS VASTAUS KUITTAUS LOPETUS Asiakkaan tunnistetiedot Palvelupyynnöt Koontisumma lähetyksessä Lähetyksen hyväksyminen/hylkääminen Lähetyksen loppukuittaus Yhteyden katkaisu Virheilmoitukset Tiedostonimet noudattavat PC/MS-DOS-nimistandardia siten, että vain tiedoston alkuosalla on merkitystä ja mahdollista loppuosaa ei oteta huomioon. Tällöin asiakkaalla voi olla esim. useita PALVELU-tiedostoja kuten PALVELU.ML tai PALVELU.OP. Tämä koskee kaikkia ohjaustiedostonimiä. Pankkilinjan lähettämät virheilmoitukset lähetetään asiakkaalle joko virhepaketteina (Epackets) tai vastaanottotiedostossa. Yleisperiaatteet: Pankkilinjan virheilmoitustekstit lähetetään!!-alkuisina. Virhe ohjaussanomassa, esim. palvelun pyynnössä, ilmoitetaan virhepaketissa. Virhe lähetysaineistossa ilmoitetaan myös virhepaketissa. Aineiston vastaanotossa ilmoitetaan virheet vastaanotetussa tiedostossa, esim. tapahtumaerän puuttuminen.
11 Esimerkit Asiakas Linjayhteys Oy Samlink Ab Yhteydenotto ja tunnistus Soitto Tunnistus SEND ASIAKAS ESI-sanoma piiiiip Tarkistus ja yhteyden katkaisu, jos on virheitä Pankin tunnistus SEND GGLOGG Lähetys SEND PALVELUT --(esim. LP,0701) Tarkistus SEND <tiedosto> --(SUO-sanoma) Tarkistus.tapahtumat. Tarkistus --(VAR-sanoma) Tarkistus Tarkistus (PTE-sanoma + -- koontisumma) SEND KYSYMYS SEND VASTAUS --(HYV tai HYL) Tiedoston käsittely RECEIVE (EOF)-- SEND KUITTAUS Vastaanotto SEND PALVELU --(esim. OP,1128) Tarkistus RECEIVE (SUO-sanoma)-- SEND <tiedosto>.tapahtumat. (VAR-sanoma)-- Edellä olevassa esimerkissä aineistot on suojattu PATU-turvamenettelyllä.