DigitalBooker-ajanvarausjärjestelmä

Owned by Tommi Savikko
Last updated: Mar 13, 2018 by Sami Huttunen (Unlicensed)

Vaatimukset

Sähköinen ajanvarausjärjestelmä DigitalBooker.
Integraatio vaatii seuraavat komponentit käyttöönsä:

  • SKJScript -lisenssi
  • Uudehko (05/2017) SKJ-versio
  • DigitalBooker tunnukset (api-avaimien tekemiseen)
  • DigitalBooker -apiavaimet
    • Mene DigitalBookerissa hallintaan
    • Ota sieltä API-avaimet
    • Näet tässä API-osoitteen, ota se talteen
    • Lisää uusi API-avain ja anna tälle kuvaava nimi
    • Ota tunniste ja salasana talteen

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

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

  2. 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
    1. SKJ-tietokannan nimi määritellään käyttäjän ympäristön mukaan
    2. 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
    3. 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
  3. 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:

  1. 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

  2. Ensimmäinen nappi siis suorittaa varsinaisen liittymän ja toisesta napista saadaan lokitiedostot näkyviin (mm. vikatilanteiden selvittämistä varten)

  3. Napit näkyvät seuraavasti päävalikossa: