Yleistä YomaniML-maksupäätteen vikatilanteista

Tehdenin kassan ja maksupäätteen välisessä yhteydessä on monta vaihetta, ja vikatilanteessa häiriö voi olla missä kohtaa tahansa tätä yhteyttä. Maksutapahtumiin osallistuvat järjestelmän osat ovat

1. Tehdenin kassa tietokoneen Internet-selaimessa
2. TehdenCard-palvelu tietokoneella paikallisesti suoritettavana ohjelmana
3. Yrityksen käytössä oleva sisäverkko ja reititin
4. Maksupääte
5. Maksupäätteen yhteys maksupäätepalvelun tarjoajan Poplatekin palvelimiin

Lyhyesti kuvailtuna maksutapahtuman kulku menee seuraavasti:

1. Tuotteet ovat lisättynä kassakuitille, ja kassahenkilö painaa Maksa-painiketta Tehdenin kassa -sivulla
2. Tehdenin kassa yhdistää selaimesta tietokoneen TehdenCard-palveluun
3. TehdenCard saa kassalta maksun tiedot, ja muodostaa yhteyden kassaan määriteltyyn maksupäätteeseen ja lähettää maksun tiedot yrityksen sisäverkon yli, käytössä olevan reitittimen kautta.
4. Maksupääte pyytää asiakkaan kortin, ja varmentaa korttimaksun Internet-yhteydellä

Ongelmakohta voi olla siis missä tahansa kohdassa maksun käsittelyä, ja tässä ohjeessa käsitellään yleisimpien ongelmien tunnistaminen ja niiden korjaaminen.

Osa vianetsintätoimenpiteistä on hyvin teknisiä, joten kiireellisissä vikatilanteissa voi asian selvittämiseksi tarvittaessa olla yhteydessä Tehdenin asiakastukeen (02 6514 1240) klo 8-16, tai tämän ajan ulkopuolella Tehdenin vikapäivystykseen (02 6514 1250) klo 7-21.

Korttimaksupainike harmaana - Kassa ei saa yhteyttä TehdenCardiin

Mikäli maksuikkunan korttimaksupainike ei aktivoidu ollenkaan, kyse on siitä, että kassaohjelma ei saa yhteyttä tietokoneella olevaan TehdenCard-ohjelmaan. Ensimmäinen toimenpide tässä tapauksessa on käynnistää TehdenCard uudelleen työpöydältä löytyvästä "Reset TehdenCard" -kuvakkeesta. (Mac-tietokoneilla vastaava toimenpide tapahtuu työpöydältä löytyvästä tehdencard_run.command -tiedoston avaamalla.)

Tämä uudelleenkäynnistää käynnissä olleen TehdenCard-palvelun, tai käynnistää TehdenCard-palvelun, mikäli palvelu ei ole jostain syystä ollut aikaisemmin käynnissä.

Varmenneongelmat (Firefox)

Harvinaisempi tapaus saattaa tulla vastaan Mozilla Firefox -selaimen selainpäivitysten yhteydessä, tai jos kassaa käytetään ensimmäistä kertaa Firefoxilla. Mikäli TehdenCard on resetoitu, eikä korttimaksupainike siltikään aktivoidu, on ongelma todennäköisesti siinä, että Firefoxilta puuttuu yhteyden muodostamiseen vaadittava varmenne. Helpoin ratkaisu on vaihtaa Chrome-selaimeen, joka osaa hakea varmenteen suoraan käyttöjärjestelmältä. Firefoxiin varmenne täytyy tuoda kuitenkin käsin seuraavasti:

Varmenteen tuonti Firefoxiin

1. Avaa Firefoxin asetukset oikean yläkulman valikkokuvakkeesta aukeavasta valikosta.
   
2. Asetuksissa valitse vasemman reunan valikosta kohta "Tietosuoja ja turvallisuus"
3. Selaa avautuva sivu alas asti, ja klikkaa painiketta "Näytä varmenteet"
   
4. Avautuvassa "Varmenteiden hallinta" -ikkunassa valitse välilehti "Varmentajat", ja siellä klikkaa painiketta "Tuo".
   
5. Mene avautuvassa ikkunassa kansioon C:/Tehden/Tehdencard, ja tuplaklikkaa tiedostoa tci.crt. Mac-tietokoneilla varmenne löytyy kansiosta ~/Dokumentit/tehdencard.
6. Ruksaa avautuvassa ikkunassa varmenteelle kaikki oikeudet.
7. Mene tämän jälkeen "Varmenteiden hallinta" -ikkunassa välilehdelle "Palvelimet", ja klikkaa "Lisää poikkeus".
   
8. Kirjoita osoitekenttään "https://localhost:9999". Tämä on osoite, johon selain yhdistää ottaessaan yhteyden Tehdencardiin. Klikkaa sen jälkeen "Lataa varmenne". Jos Tehdencard toimii normaalisti, "Varmenteen tila" -kentään tulee teksti "Tietoja ei ole saatavilla". Tämän jälkeen klikkaa painiketta "Vahvista turvallisuuspoikkeus". Mikäli painike ei aktivoidu, vika on siinä, että Tehdencard ei vastaa. Tällöin voi vielä koettaa Reset TehdenCardia.
9. Varmenne on nyt tuotu Firefoxiin, ja maksupainike aktivoituu kassalla maksuikkunan avatessa.

Kassa ei löydä päätettä

Kun kassa saa yhteyden TehdenCardiin, jää kassa odottamaan että TehdenCard muodostaa yhteyden maksupäätteeseen. Mikäli päätettä ei jostain syystä heti löydy, alkaa TehdenCard skannata sisäverkkoa laitteen löytämiseksi. Joskus maksupääte löytyy, ja yhteys muodostuu skannauksen jälkeen normaalisti, mutta usein päätettä ei löydy, ja kassa ilmoittaa virheestä yhteydessä. Tällöin ongelmana on todennäköisesti jokin seuraavista:

Väärä toimipiste

Mikäli yrityksellä on useita toimipisteitä tai kassoja, kannattaa ensimmäiseksi tarkistaa, että käyttäjä on kirjautuneena oikeaan toimipisteeseen, ja valittuna on oikea kassa. Mikäli valittuna on väärä toimipiste tai kassa, Tehden yrittää etsiä maksupäätettä toisen toimipisteen päätteen tiedoilla, eikä löydä sitä. Ongelma korjaantuu vaihtamalla Tehdenissä oikeaan toimipisteeseen ja kassaan, ja tämän jälkeen kokeilemalla maksua uudelleen.

Tietokone väärässä verkossa

Mikäli tietokone on jostain syystä yhdistänyt eri verkkoon, kuin missä maksupääte on, on syytä tarkistaa, että tietokone ei ole yhdistänyt automaattisesti esimerkiksi johonkin avoimeen WLAN-verkkoon. 

Päätteen IP-osoite vaihtunut

Maksupäätteelle itselleen ei pysty asettamaan kiinteää IP-osoitetta. Tämä pyritään ottamaan huomioon maksupäätteen asennuksessa konfiguroimalla käytössä oleva reititin mahdollisuuksien mukaan siten, että reititin antaa päätteelle aina DHCP:llään saman osoitteen päätteen MAC-osoitteen perusteella. Kaikilla reitittimillä tämä ei ole kuitenkaan mahdollista, vaan reititin saattaa jakaa päätteelle uuden sisäverkon IP-osoitteen, jolloin TehdenCard joutuu turvautumaan sisäverkon skannaukseen päätteen löytämiseksi. Mikäli päätettä ei löydy, vaikka se on varmasti kytkettynä samaan verkkoon tietokoneen kanssa, voi päätteen IP:n selvittää ja kertoa TehdenCardille seuraavasti:

1. IP-osoitteen selvittämiseen on eri vaihtoehtoja
   1. Yksinkertaisin tapa: Käynnistä pääte uudestaan. Käynnistyksen aikana päätteen ruudulla näkyy lyhyen ajan päätteen verkosta saama IP-osoite, heti sen jälkeen, kun päätteen ruudulla on pomppinut neljä vihreää ympyrää ja lukenut teksti "Käynnistetään". IP-osoite on yleensä muotoa 192.168.xxx.yyy.
   2. Toinen tapa: Selvitä laitteen IP-osoite esimerkiksi reitittimen hallintasivun kautta, mikäli siellä näkyy reitittimeen kytketyt laitteet. Toinen tapa nähdä verkon laitteet on avata komentorivi, ja ajaa komento "arp -a", jolloin komentorivi listaa kaikki laitteet joiden kanssa tietokone on kommunikoinut. Molemmilla tavoilla maksupäätteen IP löytyy riviltä, joissa verkkoon kytketyn laitteen MAC-osoite täsmää maksupäätteen kanssa. Poplatekin YomaniML -päätteillä MAC on aina muotoa 000819xxxxxx. Päätteen MAC-osoitteen voi myös tarkistaa laitteen pohjassa olevasta tarrasta.
2. Kun päätteen IP on selvillä, avaa tietokoneelta löytyvä päätteen asetustiedosto config.cfg. Windowsilla tiedosto löytyy kansiosta C:\Tehden\, Macilla suoraan kotikansiossa /Users/<käyttäjätunnus>/.
3. Config.cfg:n sisällöstä kiinnostaa tässä tapauksessa vain [Poplatek] -tagin alla olevat kolme riviä. Host-riville asetetaan päätteen IP-osoite sellaisenaan. Port on aina 10001 ja mac on päätteen MAC-osoite.