Digitalbooker ja kassat

06-05-2019

Digitalbooker on mahdollísta liittää kolmeen eri kassaan tällä hetkellä.

Passeli Kassa
SKJ Jeemly ja Flowvy
Kaunotar Kassa

Passeli Kassa

Mennään Digitalbookerissa Asetukset välilehdelle ja App storeen, täältä otetaan käyttöön API-avaimet. Kun nämä on otettu käyttöön ilmestyy vasempaan reunaan api-avaimet sivu.

Aukaistaan API-avaimet kohta vasemmalta ja painetaan Lisää API-avain, annetaan sopiva tunniste esimerkiksi Passeli Kassa ja painetaan Generoi avain. Nyt juuri luodut avaimet kopioidaan Passeli Kassaan.

Aukaistaan Passeli ja valitaan Kassa -> Kassan ohjaustiedot ja Digitalbooker välilehti.

Järjestelmän nimi -> varaaheti.fi/ jälkeen tuleva osoite
Tunniste kopioidaan Digitalbookerissa luodusta avaimesta
Salasana kopioidaan Digitalbookerissa luodusta avaimesta

Tämän jälkeen voidaan valita toimipiste missä kassaa käytetään

Mennään Digitalbookerissa Asetukset välilehdelle ja App storeen, täältä otetaan käyttöön API-avaimet. Kun nämä on otettu käyttöön ilmestyy vasempaan reunaan api-avaimet sivu. Aukaistaan API-avaimet kohta vasemmalta ja painetaan Lisää API-avain, annetaan sopiva tunniste esimerkiksi Passeli Kassa ja painetaan Generoi avain. Nyt juuri luodut avaimet kopioidaan Passeli Kassaan. Aukaistaan Passeli ja valitaan Kassa -> Kassan ohjaustiedot ja Digitalbooker välilehti. Järjestelmän nimi -> varaaheti.fi/ jälkeen tuleva osoite Tunniste kopioidaan Digitalbookerissa luodusta avaimesta Salasana kopioidaan Digitalbookerissa luodusta avaimesta Tämän jälkeen voidaan valita toimipiste missä kassaa käytetään

SKJ Jeemly ja Flowvy

Avaa

Mennään Digitalbookerissa Asetukset välilehdelle ja App storeen, täältä otetaan käyttöön API-avaimet. Kun tämä on otettu käyttöön ilmestyy vasempaan reunaan api-avaimet sivu.

Aukaistaan API-avaimet kohta vasemmalta ja painetaan Lisää API-avain, annetaan sopiva tunniste esimerkiksi SKJ ja painetaan Generoi avain.

Toiminta

Liittymä hakee DigitalBookerista DigitalBookerin APIa käyttäen varauksia ja niiden sisältämiä asiakastietoja.

Kun asiakas (tai myyjäliikkeen henkilö) tekee varauksen, tallennetaan varaukselle aina joku asiakkuus. Asiakkuus voi olla joko tallennettu tai väliaikainen. SKJ:n kannalta ei ole merkitystä, onko asiakkuus tallennettu vai väliaikainen, tärkeintä on se, että henkilöllä on puhelinnumero.

Puhelinnumeron perusteella tehdään täsmäytys asiakasrekisteriin:
Jos järjestelmästä ei löydy puhelinnumerolla asiakkuutta, se perustetaan, jos ei, käytetään puhelinnumeron perusteella löydettyä asiakkuutta. Mikäli löytyy useammalta asiakkaalta sama puhelinnumero, käytetään ensimmäistä löydettyä.

Tämän jälkeen löydetylle (tai perustetulle) asiakkaalle lisätään asiakasteksteihin uusi otsikko muodolla YYYY-MM-DD HH:MM - Tuote eli esimerkiksi '2017-05-02 13:00 - Palvelutyö'. Tämän jälkeen tuon tekstiotsikon alle voidaan syöttää käynnin muistiinpanot.

Käyttöönotto

Hae digitalbooker.pas ja digitalbookerconfig.pas tiedosto käyttöösi (saat nämä tilauksen yhteydessä) ja tallenna tiedostot winskj-hakemistoon

Muokkaa digitalbookerconfig.pas -tiedostoa esim notepadillä ja aseta sinne asetukset:

dbname := 'TIETOKANTA'; // Tietokanta, johon tietoja päivitetään
bookingsurl := '/ZZZ/fi/api/bookings'; // apin tarkempi endpoint
getdays := 10; // kuinka monen päivän ajalta haetaan tietoja
user := 'XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'; // api user
pass := 'YYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYY'; // api pass

SKJ-tietokannan nimi määritellään käyttäjän ympäristön mukaan
bookingsurl, user ja pass -tiedot saat DigitalBookerilta:
1. bookingsurl on siis API-osoite ilman https://varaaheti.fi -alkua
2. user on tunniste
3. pass on salasana
Määritä kuinka monen päivän tiedot aina kerralla haetaan
1. Jos tietoja haetaan esim päivittäin, teoriassa tähän riittäisi 1 päivä, mutta vikasietoisuuden takia se kannattaa olla hieman enemmän

Tallenna tiedosto

Nyt liittymä voidaan ajaa komennolla:

skjscript.exe /F:digitalbooker.pas /RUN

Tämä komento voidaan ajastaa suoritettavaksi sopivin väliajoin tai vaihtoehtoisesti lisätä esim WinSKJ -päävalikkoon seuraavasti:

Lisää skj.ini-tiedostoon seuraavat rivit:

[PAINIKE1]
Tyyppi=SUORITA
Otsikko=Hae$Digital$Booker
Parametri=c:\winskj\skjscript.exe;/F:digitalbooker.pas /RUN
Fonttinimi=Arial
Fonttikoko=8
 
[PAINIKE2]
Tyyppi=SUORITA
Otsikko=Digital$Booker$loki
Parametri=c:\winskj\tail.exe;-f -n 50 skjscript.log
Fonttinimi=Arial
Fonttikoko=8

Ensimmäinen nappi siis suorittaa varsinaisen liittymän ja toisesta napista saadaan lokitiedostot näkyviin (mm. vikatilanteiden selvittämistä varten)
Napit näkyvät seuraavasti päävalikossa:

Mennään Digitalbookerissa Asetukset välilehdelle ja App storeen, täältä otetaan käyttöön API-avaimet. Kun tämä on otettu käyttöön ilmestyy vasempaan reunaan api-avaimet sivu. Aukaistaan API-avaimet kohta vasemmalta ja painetaan Lisää API-avain, annetaan sopiva tunniste esimerkiksi SKJ ja painetaan Generoi avain. Toiminta Liittymä hakee DigitalBookerista DigitalBookerin APIa käyttäen varauksia ja niiden sisältämiä asiakastietoja. Kun asiakas (tai myyjäliikkeen henkilö) tekee varauksen, tallennetaan varaukselle aina joku asiakkuus. Asiakkuus voi olla joko tallennettu tai väliaikainen. SKJ:n kannalta ei ole merkitystä, onko asiakkuus tallennettu vai väliaikainen, tärkeintä on se, että henkilöllä on puhelinnumero. Puhelinnumeron perusteella tehdään täsmäytys asiakasrekisteriin:Jos järjestelmästä ei löydy puhelinnumerolla asiakkuutta, se perustetaan, jos ei, käytetään puhelinnumeron perusteella löydettyä asiakkuutta. Mikäli löytyy useammalta asiakkaalta sama puhelinnumero, käytetään ensimmäistä löydettyä. Tämän jälkeen löydetylle (tai perustetulle) asiakkaalle lisätään asiakasteksteihin uusi otsikko muodolla YYYY-MM-DD HH:MM - Tuote eli esimerkiksi '2017-05-02 13:00 - Palvelutyö'. Tämän jälkeen tuon tekstiotsikon alle voidaan syöttää käynnin muistiinpanot. Käyttöönotto Hae digitalbooker.pas ja digitalbookerconfig.pas tiedosto käyttöösi (saat nämä tilauksen yhteydessä) ja tallenna tiedostot winskj-hakemistoon Muokkaa digitalbookerconfig.pas -tiedostoa esim notepadillä ja aseta sinne asetukset: dbname := 'TIETOKANTA'; // Tietokanta, johon tietoja päivitetään bookingsurl := '/ZZZ/fi/api/bookings'; // apin tarkempi endpoint getdays := 10; // kuinka monen päivän ajalta haetaan tietoja user := 'XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'; // api user pass := 'YYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYY'; // api pass SKJ-tietokannan nimi määritellään käyttäjän ympäristön mukaan bookingsurl, user ja pass -tiedot saat DigitalBookerilta: bookingsurl on siis API-osoite ilman https://varaaheti.fi -alkua user on tunniste pass on salasana Määritä kuinka monen päivän tiedot aina kerralla haetaan Jos tietoja haetaan esim päivittäin, teoriassa tähän riittäisi 1 päivä, mutta vikasietoisuuden takia se kannattaa olla hieman enemmän Tallenna tiedosto Nyt liittymä voidaan ajaa komennolla: skjscript.exe /F:digitalbooker.pas /RUN Tämä komento voidaan ajastaa suoritettavaksi sopivin väliajoin tai vaihtoehtoisesti lisätä esim WinSKJ -päävalikkoon seuraavasti: Lisää skj.ini-tiedostoon seuraavat rivit: [PAINIKE1] Tyyppi=SUORITA Otsikko=Hae$Digital$Booker Parametri=c:\winskj\skjscript.exe;/F:digitalbooker.pas /RUN Fonttinimi=Arial Fonttikoko=8 [PAINIKE2] Tyyppi=SUORITA Otsikko=Digital$Booker$loki Parametri=c:\winskj\tail.exe;-f -n 50 skjscript.log Fonttinimi=Arial Fonttikoko=8 Ensimmäinen nappi siis suorittaa varsinaisen liittymän ja toisesta napista saadaan lokitiedostot näkyviin (mm. vikatilanteiden selvittämistä varten) Napit näkyvät seuraavasti päävalikossa:

Kaunotar Kassa

Avaa

Mennään Digitalbookerissa Asetukset välilehdelle ja App storeen, täältä otetaan käyttöön Kaunotar Kassa. Kun tämä on otettu käyttöön mennään vasemmasta reunasta Tiedot välilehdelle ja valitaan muokkaustila. Etsitään kohta Kaunotar Kassa URL ja syötetään tähän kassan IP-osoite.