Quick Utility Service

Muokattu To, 5 Kesä klo 10:14 AM

SISÄLLYSLUETTELO

Näin asennat
Käyttöoikeudet Windowsissa
Perusasetukset
Yhteys ja tila
Maksupääte
Kassalaatikko
Tulostus
Asiakirjojen lataaminen
Lokit

Quick Utility Service on Windows-ohjelma, joka on suunniteltu kommunikoimaan Quick3:n kanssa monipuolisemmalla tavalla kuin mitä pelkkä selain mahdollistaisi.

Maksupääte: Kommunikaatio maksupäätteen ja kassanäkymän välillä Quick 3:ssa.
Kassalaatikko: Yhteys kassalaatikkoon ja sen avaaminen automaattisesti käteistä käytettäessä.
Tulostus: Raporttien ja muiden dokumenttien pikatulostus ilman selaimen tulostusikkunan kautta siirtymistä.
Tiedostojen lataaminen: Automaattinen tiedostojen lataaminen dokumenttikeskukseen.

Näin asennat

Lataa asennustiedosto Quick3:n oikeassa yläkulmassa olevasta valikosta (klikkaa omaa nimeäsi).
Mene kohtaan Lataukset ja valitse Quick Utility Service ja lataa tiedosto.
Tietokoneesi saattaa antaa ilmoituksen "Windows suojasi tietokonettasi". Paina Lisätietoja ja sen jälkeen Suorita joka tapauksessa. Koneesi saattaa myös kysyä, annetaanko sovelluksen tehdä muutoksia tietokoneeseen, vastaa Kyllä.
Kun lataus on valmis, asenna Quick Utility Service suorittamalla asennustiedosto.
Asennuksen jälkeen avaa Quick Utility Service.

Käyttöoikeudet Windowsissa

Anna Utility Servicelle (Bootstrapper) kaikki käyttöoikeudet jokaiselle ryhmälle/käyttäjätunnukselle. Tämä löytyy yleensä sijainnista C:\Program Files (x86)\Quick Systems\Quick Utility Service\Bootstrapper.exe.

2. Anna käyttöoikeudet myös rekisterieditorissa. Löytyy yleensä sijainnista Tietokone\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Quick Utility Service

3. Palomuurin säännöt: Tee sääntö saapuvalle/lähtevälle liikenteelle, portille 9670 ja bootstrapper.exe-tiedostolle sekä myös portille 6001, jos käytetään integroitua maksupäätettä.

Perusasetukset

Luo pääsyavain Utility Serviceen. Lue lisää täältä.
Avaa Settings-välilehti:
1. Kopioi luomasi pääsyavain Authentication Key -kenttään. (Avain löytyy Omat Asetukset -> Turvallisuus. Tämä välilehti on näkyvillä vain järjestelmänvalvojakäyttäjillä)
2. Kopioi Quick 3:n osoite selaimestasi, esim. https://q3.quick.no/Prod_FI_001
3. Kirjoita kuvaus, esim. Huoltotiski 1 tai Matin kone
4. Klikkaa Test Settings nähdäksesi, saatko yhteyden Quick 3:een. Mikäli tiedot on oikein, saat ilmoituksen "Connected to Quick 3".

Yhteys ja tila

Valitse Status -välilehti
Jos tämä on ensimmäinen käynnistyskerta, tila (Mode) on asetettu manuaaliseksi. Manuaalitila on tarkoitettu vain ensimmäisen yhteyden testaamiseen, eikä se yhdistä Quick 3:een ennen kuin klikkaat Restart. Älä käytä manuaalitilaa normaalissa käytössä.
1. Automatic: Jos ohjelma asennetaan päivittäin käytettävälle tietokoneelle, tila voidaan asettaa automaattiseksi. Tämän tilan etuna on, että ohjelma saa pääsyn esimerkiksi verkkotulostimiin, mikäli käyttäjällä on niihin pääsyoikeudet. Tässä on huomioitava, että ohjelma ei käynnisty, ennen kuin joku kirjautuu sisään Windowsiin.
2. Service: Ohjelma on suoritetaan Windows-palveluna. Tällöin ohjelma käynnistyy, vaikka tietokone käynnistettäisiin uudelleen eikä kukaan käyttäjä ole kirjautunut Windowsiin. HUOM! Mikäli käytössä on integroitu maksupääte, käytetään aina Service-tilaa.
Virheilmoitukset
1. Connection to Quick3 is: NotFound
  - Varmista, että olet kirjoittanut Quick 3 -instanssin osoitteen oikein Settings -välilehdellä
2. Connection to Quick3 is: Unauthorized
  - Varmista, että kopioimasi pääsyavain Settings -välilehdellä on oikein, eikä se ole vanhentunut tai poistettu käytöstä

Maksupääte

Mene Status-välilehdelle ja vaihda tilaksi Service.
Varmista, että maksupääte on päällä ja ethernet-johto kytkettynä reitittimeen (ei suoraan tietokoneeseen).
Klikkaa Payment terminal -välilehteä. Valitse Device vendor -kenttään Nets/Baxi.
Connection Type kenttään valitaan Ethernet.
Listen port on 6001.
Rastita vielä Active.
Paina lopuksi Apply tallentaaksesi asetukset.

Netsin maksupäätteen yhdistäminen Quickiin

Varmista ensin, että kassatietokoneen sisäverkon (ipv4) IP-osoite on kiinteä. Jos IP-osoite ei ole kiinteä, viimeiset numerot saattavat vaihdella ja yhteys maksupäätteeseen katkeaa. Tämä on paras tehdä reitittimen asetuksien kautta. Katso tarkempi ohje tästä.
Näet ivp4-osoitteesi avaamalla Windowsin komentokehotteen ja suorittamalla komennon ipconfig.
Tarkista myös ennen asennusta, että palomuurisi sallii saapuvan liikenteen portille 6001 (Windows Defenderin laajennettu palomuuri -> Saapuvan liikenteen säännöt)
Syötä seuraavat tiedot maksupäätteeseen. Saat kauppiasmenun auki vetämällä kauppiaskortin maksupäätteen sivusta.
- Kauppiasmenu -> Parametrit -> Muuta -> Kassa
  - ECR/TLS: Kyllä
  - ECR IP-osoite: kassatietokoneen ipv4-osoite (esim. 192.168.1.10)
  - ECR IP-portti: 6001
- Kauppiasmenu -> Parametrit -> Muuta -> Yhteydet
  - Conn. Typ. : Ethernet
  - DHCP: Käytössä
  - Host IP-osoite: 91.102.24.142
  - Host portti: 9670
Käynnistä maksupääte uudelleen painamalla pilkkua ja keltaista nappia samanaikaisesti.
Mene Utility Servicessä Status-välilehdelle ja paina Restart service
Tee maksupäätteessä päivänpäätös painamalla Menu + 6. (Jos päivänpäätöstä ei ole tehty 2 viikon sisällä, maksut hylätään automaattisesti)
Tee vielä seuraavat määritykset Quickissä
- Maksutavat-valikko -> valitse Kortti (Nets) ja Suorita toiminto -sarakkeeseen Korttipääte
- Kassarekisteri-valikko -> valitse käytettävä kassa -> valitse Maksupääte-kenttään yhdistetty maksupääte
Mikäli Utility Service antaa tämän jälkeen virheilmoituksen "ERROR [Banking] Baxi: Failed to open Baxi: 7406 PROPERTY_BAUD_RATE" täytyy Baud rate käydä vaihtamassa Windowsin rekisterieditorissa.
- Avaa rekisterieditori
- Etsi polku Computer\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Quick Utility Service
- Etsi tiedosto nimeltä banking_json ja avaa se
- Aseta Baud rate -kenttään 9600. Huomioi, että luvun edessä tulee olla : ja sen jälkeen , (:9600,)

Jos maksupäätteen kanssa ilmenee ongelmia, voit katsoa lisää ohjeita täältä.

Kassalaatikko

Klikkaa Cash drawer -välilehteä
Valitse kassa/yhteystyyppi ja syötä tarvittavat asetukset
Jotkin kassalaatikot saattavat ilmoittaa olevansa suljettu, vaikka ovatkin auki. Jos näin on, voit kääntää tämän logiikan valitsemalla Flip open switch.
Klikkaa Apply tallentaaksesi asetukset.
Mene Quick 3:ssa Kassarekisteriin ja valitse Kassalaatikko-kenttään yhdistetty kassalaatikko.

Esim. Starin kuittitulostin toimii yleensä seuraavilla asetuksilla. Port name -kenttään kirjoitetaan USBPRN:"tulostusjonon nimi", tässä tapauksessa Star MCP21/20.

Tulostusjonon nimen voi helposti tarkistaa vaikkapa kuittia tulostettaessa:

Huom! Jos käytät USB-MS Cash Drawer -tyyppistä kassalaatikkoa, varmista ennen sen kytkemistä USB-porttiin, että kytkimet alapuolella on konfiguroitu kuvan mukaisesti.

Tulostus

Varmista ensin, että tulostin on yhdistetty Windowsiin.
Klikkaa Printing -välilehteä.
Rastita Upload Printers Automatically.
Poista valinta niiltä tulostimilta, joita et halua näyttää Quick3:ssa.
Jos lisäät uuden tulostimen Windowsissa, voit painaa Refresh päivittääksesi luettelon.
Huom! Upload printers on käytettävissä vain, kun käytät Manuaalista tai Automaattista tilaa. Jos siis tietokoneeseen on yhdistetty maksupääte, vaihda hetkellisesti Service-tila joko Manuaaliseksi tai Automaattiseksi
Huomioithan myös, että Utility Service tukee vain TCP/IP-lähiverkkoon asennettuja tulostimia, eikä esim. WSD-protokollalla asennettuja tulostimia.
Tulostimet tulevat näkyville Omien asetuksienTulostimet-välilehdelle.

Dokumenttien lataaminen

Dokumenttien latausseuranta tarkkailee automaattisesti määritettyjä tietokoneesi kansioita ja lataa tiedostoja valituista kansioista Quick3-järjestelmään. Dokumentit tulevat Quick 3:ssa Dokumenttikeskukseen.

Mene Document Upload -välilehdelle.
Klikkaa kansion kuvaa.
Valitse kansio, jota haluat ohjelman seuraavan. Huomioi, että kansio tulisi olla tyhjä tai sisältää ainoastaan niitä tiedostoja, joita haluat ladata Quick 3:een.
1. Jos haluat, että ohjelma tarkkailee tiettyjä tiedostotyyppejä kyseisessä kansiossa, voit kirjoittaa esimerkiksi *.pdf Filter -kenttään. Saat tämän vaihtoehdon auki painamalla kynän kuvaa. Jos et määritä mitään suodatinta, ohjelma huomioi kaikki tiedostotyypit.
2. Tällä hetkellä ainoat tuetut dokumenttityypit ovat "Bilag" ja "Voucher" (liite tai tosite), mutta tulevaisuudessa valikoima laajenee.
Määrittämääsi sijaintiin luodaan automaattisesti alikansio Quick3UploadArchive, johon käsitellyt tiedostot siirtyvät.
Trigger upload -käynnistää tarkastuksen määritetyssä kansiossa ja lataa ne välittömästi järjestelmään.

Loki

Lokissa on tietoja siitä, mitä ohjelma tekee, sekä mahdollisista virheviesteistä. Alla olevassa esimerkissä on lisätty kansio dokumenttien lataamista varten, mutta kyseinen kansio ei enää ole olemassa.